curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "wan3.0-text-to-video",
  "prompt": "A kitten runs across a rooftop in the moonlight, city neon flickers in the distance, cinematic quality, smooth camera work.",
  "duration": 5,
  "quality": "720p",
  "aspect_ratio": "16:9",
  "generate_audio": true
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "wan3.0-text-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-text-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 Text-to-Video

La vidéo est générée à partir du seul prompt, aucune entrée média n’est acceptée
Vidéos jusqu’à 30 secondes, la durée intelligente duration: -1 est prise en charge
Pour contrôler la première et la dernière image, utilisez Wan3.0 image vers vidéo ; pour des éléments de référence, Wan3.0 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-text-to-video",
  "prompt": "A kitten runs across a rooftop in the moonlight, city neon flickers in the distance, cinematic quality, smooth camera work.",
  "duration": 5,
  "quality": "720p",
  "aspect_ratio": "16:9",
  "generate_audio": true
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "wan3.0-text-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-text-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-text-to-video

requis

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

Options disponibles:

wan3.0-text-to-video

Exemple:

"wan3.0-text-to-video"

prompt

string

requis

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)

Note : ce modèle est du texte vers vidéo pur et n'accepte aucune entrée média.

Exemple:

"A kitten runs across a rooftop in the moonlight, city neon flickers in the distance, cinematic quality, smooth camera work."

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-text-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 Text-to-Video

Facturation

Autorisations

Corps

Réponse