curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "wan3.0-image-to-video",
  "prompt": "The boy in the frame “comes alive” out of the wall and performs an English rap at breakneck speed, while street lights under a railway bridge at night create a cinematic mood.",
  "image_start": "https://example.com/first_frame.png",
  "duration": 5,
  "quality": "720p"
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "wan3.0-image-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 165,
    "video_duration": 8
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 50,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_parameter",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: wan3.0-image-to-video",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Wan3.0

Wan3.0 Image-to-Video

image_start fixe strictement la première image de la vidéo ; ajouter image_end fixe aussi strictement la dernière image
Les éléments de référence ne sont pas acceptés (vidéos de référence / audio de référence / fichiers / pages web) : la première et la dernière image s’excluent des éléments de référence. Pour des références mixtes, utilisez Wan3.0 référence vers vidéo
Au plus 2 images (première image + dernière image). Pour 3 images de référence ou plus, utilisez la référence vers vidéo
Mode de traitement asynchrone, utilisez l’ID de tâche renvoyé pour interroger le statut
Les liens vidéo générés sont valides 24 heures, veuillez les sauvegarder rapidement

Facturation

Formule de facturation : durée facturée = durée de la vidéo d’entrée + durée de la vidéo de sortie, facturation à la seconde
Multiplicateur de résolution : 480p = 1x (référence), 720p = 2x, 1080p = 4x
Les images de référence, l’audio de référence, les fichiers de référence et les liens de pages web ne sont pas facturés
Lorsque duration vaut -1 (durée intelligente), le montant est préautorisé au plafond de 30 secondes ; après le succès de la tâche, la facturation porte sur la durée réellement produite et la différence est remboursée automatiquement
Activer ou désactiver la piste audio coûte le même prix
Les tâches en échec ne sont pas facturées, les crédits gelés sont intégralement remboursés

POST

videos

generations

curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "wan3.0-image-to-video",
  "prompt": "The boy in the frame “comes alive” out of the wall and performs an English rap at breakneck speed, while street lights under a railway bridge at night create a cinematic mood.",
  "image_start": "https://example.com/first_frame.png",
  "duration": 5,
  "quality": "720p"
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "wan3.0-image-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 165,
    "video_duration": 8
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 50,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_parameter",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: wan3.0-image-to-video",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

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:wan3.0-image-to-video

requis

Nom du modèle, fixé à wan3.0-image-to-video

Options disponibles:

wan3.0-image-to-video

Exemple:

"wan3.0-image-to-video"

image_start

string<uri>

requis

URL de la première image, utilisée strictement comme première image de la vidéo générée. Obligatoire

Limites d'image :

Formats : JPEG, JPG, PNG (transparence non prise en charge), BMP, WEBP
Résolution : largeur et hauteur dans [240, 8000] pixels
Rapport d'aspect : 1:8 ~ 8:1
Taille du fichier : jusqu'à 20MB

Exemple:

"https://example.com/first_frame.jpg"

prompt

string

Prompt textuel pour la génération vidéo. Le chinois et l'anglais sont pris en charge, chaque caractère chinois / lettre compte pour 1 caractère, longueur maximale 20000 caractères ; le surplus est tronqué automatiquement (sans erreur)

À utiliser pour décrire l'action, les mouvements de caméra et les changements attendus entre la première image (ou la première et la dernière image).

Exemple:

"A young girl's smile gradually turns into a big laugh, the camera slowly pushes in, and the background light shifts from cool tones to warm tones."

image_end

string<uri>

URL de la dernière image, utilisée strictement comme dernière image de la vidéo générée. Facultatif

Contrainte : doit être utilisée avec image_start, il n'est pas possible d'envoyer uniquement la dernière image.

Limites d'image :

Formats : JPEG, JPG, PNG (transparence non prise en charge), BMP, WEBP
Résolution : largeur et hauteur dans [240, 8000] pixels
Rapport d'aspect : 1:8 ~ 8:1
Taille du fichier : jusqu'à 20MB

Exemple:

"https://example.com/last_frame.jpg"

duration

integer

défaut:5

Durée de la vidéo générée (secondes), 5 par défaut

Valeurs acceptées :

Tout entier compris entre 2 et 30
-1 : durée intelligente, le modèle détermine la longueur de sortie d'après le prompt et les éléments d'entrée

Facturation de la durée intelligente : au moment de l'envoi, la longueur générée est inconnue ; le montant est donc préautorisé au plafond de 30 secondes, puis régularisé sur la durée réellement produite après le succès de la tâche, l'excédent gelé étant libéré automatiquement. Si votre solde ne couvre pas la préautorisation au plafond, indiquez plutôt un nombre de secondes explicite.

Exemple:

5

quality

enum<string>

défaut:720p

Résolution vidéo, 720p par défaut

Options :

480p : définition plus basse, prix le plus bas (base de facturation)
720p : définition standard, valeur par défaut, prix 2x celui de 480p
1080p : haute définition, prix 4x celui de 480p

Options disponibles:

480p,

720p,

1080p

Exemple:

"720p"

aspect_ratio

enum<string>

défaut:adaptive

Rapport d'aspect de la vidéo, adaptive par défaut

Options :

adaptive : adaptatif, le modèle recommande un rapport d'aspect adapté selon le ratio des éléments d'entrée et l'intention du prompt, valeur par défaut
16:9 (paysage), 9:16 (portrait), 1:1 (carré), 4:3, 3:4

Options disponibles:

adaptive,

16:9,

9:16,

1:1,

4:3,

3:4

Exemple:

"16:9"

generate_audio

boolean

défaut:true

Indique si la vidéo de sortie contient une piste audio, true par défaut

Options :

true : la vidéo de sortie contient du son (voix, effets sonores, musique de fond), valeur par défaut
false : vidéo muette en sortie

Le son activé ou désactivé coûte le même prix, sans frais supplémentaires.

Exemple:

true

seed

integer

Graine aléatoire, utilisée pour reproduire les résultats, aléatoire par défaut

Notes :

Plage : 0 ~ 2147483647
Fixer la graine réduit la variation lors de l'itération sur les prompts et améliore la reproductibilité

Plage requise: 0 <= x <= 2147483647

Exemple:

42

callback_url

string<uri>

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

Moment du rappel :

Déclenché lorsque la tâche est terminée (completed), échouée (failed) ou annulée (cancelled)
Envoyé après la confirmation de la facturation

Restrictions de sécurité :

Seul le protocole HTTPS est pris en charge
Les rappels vers les adresses IP du réseau interne 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 de 3 tentatives après échec (les tentatives ont lieu après 1/2/4 secondes suivant l'échec)
Le format du corps de réponse du rappel est cohérent avec le format de réponse de l'API de consultation de tâche
Un code de statut 2xx 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 vidéo créée avec succès

created

integer

Horodatage de création de la tâche

Exemple:

1761313744

string

ID de tâche

Exemple:

"task-unified-1774857405-abc123"

model

string

Nom du modèle réellement utilisé

Exemple:

"wan3.0-image-to-video"

object

enum<string>

Type spécifique de la tâche

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

Show child attributes

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

Show child attributes

Série Image

Série Vidéo

Série Audio

Série Texte

Gestion du compte

Gestion des tâches

Gestion des fichiers

Wan3.0 Image-to-Video

Facturation

Autorisations

Corps

Réponse