Passer au contenu principal
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "wan2.7-text-to-video",
  "prompt": "Un petit chaton qui court sous le clair de lune",
  "aspect_ratio": "16:9",
  "duration": 5
}
'
{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "wan2.7-text-to-video",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 120
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 5,
    "user_group": "default"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.evolink.ai/llms.txt

Use this file to discover all available pages before exploring further.

Autorisations

​
Authorization
string
header
requis

Toutes les API nécessitent une authentification Bearer Token

Obtenir votre clé API :

Rendez-vous sur la page de gestion des clés API pour obtenir votre clé API

Ajoutez à l'en-tête de la requête :

Authorization: Bearer YOUR_API_KEY

Corps

application/json
​
model
enum<string>
requis

Nom du modèle, doit être wan2.7-text-to-video

Options disponibles:
wan2.7-text-to-video
Exemple:

"wan2.7-text-to-video"

​
prompt
string
requis

Invite textuelle pour la génération vidéo. Prend en charge le chinois et l'anglais ; chaque caractère/lettre compte pour 1, le surplus est tronqué automatiquement. Longueur maximale : 5000 caractères

Narration multi-plans : contrôlez la structure des plans via le langage naturel

  • Plan unique : indiquez « générer une vidéo en plan unique » dans le prompt
  • Plans multiples : utilisez « générer une vidéo multi-plans » ou des listes horodatées (par ex. « Plan 1 [0-3s] »)
Maximum string length: 5000
Exemple:

"Un petit chaton qui court sous le clair de lune"

​
negative_prompt
string

Prompt négatif décrivant ce qui ne doit pas apparaître dans la vidéo. Prend en charge le chinois et l'anglais. Longueur maximale 500 caractères ; surplus tronqué automatiquement

Maximum string length: 500
Exemple:

"Flou, basse qualité"

​
audio_urls
string<uri>[]

Liste d'URL audio pilote (optionnel). Actuellement, un seul élément est pris en charge

Comportement :

  • Fourni : le modèle utilise cet audio comme source pilote
  • Omis : le modèle génère automatiquement une musique de fond ou des effets sonores adaptés au visuel

Exigences de format :

  • Formats pris en charge : wav, mp3
  • Durée : 2 ~ 30 secondes
  • Taille du fichier : jusqu'à 15 Mo

Gestion du dépassement :

  • Si la durée audio dépasse duration, les premières N secondes sont utilisées et le reste est ignoré
  • Si la durée audio est plus courte que la durée vidéo, la portion restante est silencieuse. Par exemple : avec un audio de 3s et une vidéo de 5s, les 3 premières secondes ont du son et les 2 dernières sont muettes
Required array length: 1 element
Exemple:
["https://example.com/audio.mp3"]
​
quality
enum<string>
défaut:720p

Qualité vidéo, par défaut 720p

Options :

  • 720p : définition standard, prix standard (par défaut)
  • 1080p : haute définition, prix plus élevé
Options disponibles:
720p,
1080p
Exemple:

"720p"

​
aspect_ratio
enum<string>
défaut:16:9

Rapport d'aspect vidéo, par défaut 16:9

Résolution de sortie par niveau de qualité :

Qualité16:99:161:14:33:4
720p1280×720720×1280960×9601104×832832×1104
1080p1920×10801080×19201440×14401648×12481248×1648
Options disponibles:
16:9,
9:16,
1:1,
4:3,
3:4
Exemple:

"16:9"

​
duration
number
défaut:5

Durée vidéo en secondes, plage 2-15

Note :

  • Toute valeur entière entre 2~15 secondes est prise en charge
  • La facturation finale est basée sur la durée réelle de la vidéo générée
Plage requise: 2 <= x <= 15
Exemple:

5

​
seed
integer

Graine aléatoire, aléatoire par défaut

Notes :

  • Plage : 1 ~ 2147483647
  • Fixer la graine réduit la variation lors de l'itération sur les prompts et améliore la reproductibilité
Plage requise: 1 <= x <= 2147483647
Exemple:

42

​
prompt_extend
boolean
défaut:false

Activer ou non la réécriture intelligente du prompt. Lorsqu'elle est activée, un grand modèle optimise le prompt, ce qui améliore nettement les résultats pour des prompts simples ou peu descriptifs.

Note : la valeur par défaut est false. Omettre le champ ou envoyer false ne déclenchera pas la réécriture ; envoyez explicitement true pour l'activer.

Exemple:

false

​
callback_url
string<uri>

URL de callback HTTPS pour la fin de tâche

Moment du callback :

  • Déclenché à la fin, l'échec ou l'annulation de la tâche
  • Envoyé après confirmation de facturation

Restrictions de sécurité :

  • Seul HTTPS est pris en charge
  • Les callbacks vers des 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 callback :

  • Délai d'attente : 10 secondes
  • Jusqu'à 3 tentatives après échec (à 1/2/4 secondes)
  • Le format de réponse du callback est identique à celui de l'API de requête de tâche
  • Les codes 2xx sont considérés comme réussis ; les autres codes déclenchent des nouvelles tentatives
Exemple:

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

Réponse

Tâche vidéo créée avec succès

​
created
integer

Horodatage de création de la tâche

Exemple:

1757169743

​
id
string

ID de la tâche

Exemple:

"task-unified-1757169743-7cvnl5zw"

​
model
string

Nom du modèle réellement utilisé

Exemple:

"wan2.7-text-to-video"

​
object
enum<string>

Type spécifique de tâche

Options disponibles:
video.generation.task
​
progress
integer

Pourcentage d'avancement 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 sur 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