Passer au contenu principal
POST
/
v1
/
videos
/
generations
Génération vidéo d'humain numérique OmniHuman-1.5
curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "omnihuman-1.5",
  "audio_url": "https://example.com/audio.mp3",
  "image_urls": [
    "https://example.com/person.jpg"
  ]
}
'
{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "omnihuman-1.5",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 120,
    "video_duration": 10
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 10,
    "user_group": "default"
  }
}

Autorisations

​
Authorization
string
header
requis

##Toutes les API nécessitent une authentification Bearer Token##

Obtenir une clé API :

Visitez la Page de gestion des clés API pour obtenir votre clé API

Ajouter à l'en-tête de requête :

Authorization: Bearer YOUR_API_KEY

Corps

application/json
​
model
enum<string>
défaut:omnihuman-1.5
requis

Nom du modèle de génération de vidéo d'humain numérique

Options disponibles:
omnihuman-1.5
Exemple:

"omnihuman-1.5"

​
audio_url
string<uri>
requis

URL audio pour piloter la synchronisation labiale et les mouvements corporels

Remarque :

  • Durée audio maximale : 35 secondes
  • Formats pris en charge : .mp3, .wav
  • Les URL audio doivent être directement accessibles par le serveur
  • La facturation est basée sur la durée audio (arrondie à la seconde supérieure)
Exemple:

"https://example.com/audio.mp3"

​
image_urls
string<uri>[]
requis

Liste d'URLs d'images de référence contenant la personne à animer

Remarque :

  • Nombre d'images : 1
  • L'image doit contenir un sujet humain clair
  • Formats pris en charge : JPG, JPEG, PNG
  • Taille maximale : 10 MB
Maximum array length: 1
Exemple:
["https://example.com/person.jpg"]
​
prompt
string

Invite textuelle optionnelle pour guider le style de génération, prend en charge uniquement le chinois, l'anglais, le japonais, le coréen, l'espagnol mexicain et l'indonésien

Exemple:

"A person speaking naturally with subtle expressions"

​
pe_fast_mode
boolean
défaut:false

Activer le mode de traitement rapide

Remarque :

  • true : Génération plus rapide avec une qualité potentiellement inférieure
  • false : Traitement de qualité standard (par défaut)
Exemple:

false

​
mask_url
string<uri>[]

Tableau d'URL de masque pour spécifier les régions d'animation

Remarque :

  • Paramètre optionnel pour un contrôle avancé
  • Les images de masque doivent correspondre aux dimensions de l'image de référence
Exemple:
["https://example.com/mask.png"]
​
seed
integer

Graine aléatoire comme base pour déterminer l'état de diffusion initial, aléatoire par défaut. Si la graine est le même entier positif et que tous les autres paramètres sont cohérents, le contenu généré peut avoir des résultats cohérents

​
subject_check
boolean
défaut:false

Activer la détection de sujet pour vérifier la présence humaine dans l'image

Remarque :

  • true : Activer la détection de sujet, le temps d'initiation de la requête augmentera
  • false : Ignorer la détection de sujet (par défaut)
Exemple:

false

​
auto_mask
boolean
défaut:false

Activer la génération automatique de masque

Note :

  • true : Détecte et masque automatiquement la silhouette humaine, le temps d'initiation de la requête augmentera. Ce paramètre est ignoré lorsque mask_url a une valeur
  • false : Utiliser le mask_url fourni ou aucun masque (par défaut)
Exemple:

false

​
callback_url
string<uri>

Adresse de rappel HTTPS après l'achèvement de la tâche

Moment du rappel :

  • Déclenché lorsque la tâche est terminée, échouée ou annulée
  • Envoyé après confirmation de la facturation

Restrictions de sécurité :

  • Seul le protocole HTTPS est pris en charge
  • Les rappels vers les adresses IP internes sont interdits (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
  • La longueur de l'URL ne doit pas dépasser 2048 caractères

Mécanisme de rappel :

  • Délai d'expiration : 10 secondes
  • Maximum 3 tentatives en cas d'échec (tentatives après 1 seconde/2 secondes/4 secondes)
  • Le format du corps de réponse du rappel est cohérent avec le format de réponse de l'API de requête de tâche
  • Un code de statut 2xx renvoyé par l'adresse de rappel est considéré comme un succès, les autres codes de statut déclenchent une nouvelle tentative
Exemple:

"https://your-domain.com/webhooks/video-task-completed"

Réponse

Tâche de génération de vidéo d'humain numérique créée avec succès

​
created
integer

Horodatage de création de la tâche

Exemple:

1757169743

​
id
string

ID de tâche

Exemple:

"task-unified-1757169743-7cvnl5zw"

​
model
string

Nom du modèle réellement utilisé

Exemple:

"omnihuman-1.5"

​
object
enum<string>

Type de tâche spécifique

Options disponibles:
video.generation.task
​
progress
integer

Pourcentage de progression de la tâche (0-100)

Plage requise: 0 <= x <= 100
Exemple:

0

​
status
enum<string>

Statut de la tâche

Options disponibles:
pending,
processing,
completed,
failed
Exemple:

"pending"

​
task_info
object

Informations détaillées de la tâche vidéo

​
type
enum<string>

Type de sortie de la tâche

Options disponibles:
text,
image,
audio,
video
Exemple:

"video"

​
usage
object

Informations d'utilisation et de facturation