curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "seedance-2.0-fast-text-to-video",
  "prompt": "A macro lens focuses on a green glass frog on a leaf. The focus gradually shifts from its smooth skin to its completely transparent abdomen, where a bright red heart is beating powerfully and rhythmically.",
  "duration": 8,
  "quality": "720p",
  "aspect_ratio": "16:9",
  "generate_audio": true,
  "content_filter": true
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "seedance-2.0-fast-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_request",
    "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: seedance-2.0-fast-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"
  }
}

Seedance 2.0 Fast

Seedance 2.0 Fast Guide complet des paramètres

Référence complète des paramètres de Seedance 2.0 Fast. Sélectionnez un modèle de ce dossier avec model. Les champs obligatoires, les entrées et la facturation sont détaillés pour chaque mode.

ID du modèle	Mode	Champs obligatoires (hors model)
`seedance-2.0-fast-text-to-video`	Text-to-Video	`prompt`
`seedance-2.0-fast-image-to-video`	Image-to-Video	`prompt`, `image_urls`
`seedance-2.0-fast-reference-to-video`	Reference-to-Video	`prompt`

Text-to-Video

Generation de videos a partir de prompts textuels, avec recherche web pour ameliorer l’actualite

Image-to-Video

Entrez 1 image pour generer une video a partir de la premiere image, entrez 2 images pour generer une video avec images de debut et de fin, le modele determine automatiquement

Reference-to-Video

Entrez des images de reference (0-9) + des videos de reference (0-3) + des audios de reference (0-3) + un prompt textuel pour generer une video
Prend en charge la creation, l’edition et l’extension de videos, ainsi que divers scenarios creatifs
Prend desormais en charge les contenus humains realistes generes par IA (AIGC)
Mode de traitement asynchrone, utilisez l’ID de tache retourne pour consulter le statut
Le lien de la video generee est valide pendant 24 heures, veuillez le sauvegarder rapidement

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": "seedance-2.0-fast-text-to-video",
  "prompt": "A macro lens focuses on a green glass frog on a leaf. The focus gradually shifts from its smooth skin to its completely transparent abdomen, where a bright red heart is beating powerfully and rhythmically.",
  "duration": 8,
  "quality": "720p",
  "aspect_ratio": "16:9",
  "generate_audio": true,
  "content_filter": true
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "seedance-2.0-fast-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_request",
    "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: seedance-2.0-fast-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 interfaces necessitent une authentification par Bearer Token

Obtenir une cle API :

Visitez la Page de gestion des cles API pour obtenir votre cle API

Ajoutez dans l'en-tete de la requete :

Authorization: Bearer YOUR_API_KEY

Corps

application/json

Cette page regroupe les paramètres des différents modes. Les champs obligatoires, valeurs acceptées et valeurs par défaut dépendent du model choisi ; les différences sont détaillées par mode ci-dessous.

model

enum<string>

requis

Nom du modele de generation video

ID du modèle	Mode	Champs obligatoires (hors model)
`seedance-2.0-fast-text-to-video`	Text-to-Video	`prompt`
`seedance-2.0-fast-image-to-video`	Image-to-Video	`prompt`, `image_urls`
`seedance-2.0-fast-reference-to-video`	Reference-to-Video	`prompt`

Options disponibles:

seedance-2.0-fast-text-to-video,

seedance-2.0-fast-image-to-video,

seedance-2.0-fast-reference-to-video

Exemple:

"seedance-2.0-fast-text-to-video"

prompt

string

requis

Text-to-Video

Prompt textuel decrivant la video souhaitee. Prend en charge le chinois et l'anglais, il est recommande de ne pas depasser 500 caracteres en chinois ou 1000 mots en anglais. Longueur maximale du prompt : 10000 tokens

Remarque :

Ce modele est exclusivement text-to-video et ne prend pas en charge les entrees image_urls, video_urls, audio_urls

Image-to-Video

Remarque :

Ce modele ne prend pas en charge les entrees video_urls, audio_urls

Reference-to-Video

Prompt textuel decrivant la video souhaitee. Prend en charge le chinois et l'anglais, il est recommande de ne pas depasser 500 caracteres en chinois. Longueur maximale du prompt : 10000 tokens

Details :

Pour faire reference aux ressources d'entree dans le prompt, utilisez de preference des balises explicites comme @image1, @video1 et @audio1, plutot que de vous fier uniquement a des references en langage naturel telles que « image 1 », « video 1 » ou « audio 1 »
La numerotation des balises suit l'ordre du tableau d'URL correspondant et commence a 1 : le premier element de image_urls est @image1, le premier de video_urls est @video1 et le premier de audio_urls est @audio1
La numerotation en langage naturel peut encore etre comprise, mais les balises explicites associent plus clairement chaque ressource a son usage

Exemple:

"A macro lens focuses on a green glass frog on a leaf. The focus gradually shifts from its smooth skin to its completely transparent abdomen, where a bright red heart is beating powerfully and rhythmically."

image_urls

string<uri>[]

S’applique uniquement à : Image-to-Video, Reference-to-Video

Image-to-Video

Tableau d'URLs d'images, 1 a 2 images

Nombre d'images et comportement :

Nombre d'images	Comportement	Role
1 image	Video a partir de la premiere image	Automatiquement defini comme `first_frame`
2 images	Video avec images de debut et de fin	1ere image → `first_frame`, 2eme image → `last_frame`

Exigences pour les images :

Formats pris en charge : .jpeg, .png, .webp
Rapport d'aspect (largeur/hauteur) : 0.4 a 2.5
Dimensions en pixels : 300 a 6000 px
Taille maximale par image : 30 Mo
Taille totale du corps de requete ne depassant pas 64 Mo, ne pas utiliser l'encodage Base64 pour les fichiers volumineux
Lors de l'envoi d'images de debut et de fin, les deux images peuvent etre identiques. En cas de rapport d'aspect different, la premiere image prevaut et la derniere image est automatiquement recadree
Les URLs d'images doivent etre directement accessibles par le serveur

Reference-to-Video

Tableau d'URLs d'images de reference, 0 a 9 images

Description des roles :

Type de media	Role	Utilisation typique
Image	`reference_image`	Reference de style, image produit, personnage, premiere/derniere image (specifiee via le prompt)

Exigences pour les images :

Formats pris en charge : .jpeg, .png, .webp
Rapport d'aspect (largeur/hauteur) : 0.4 a 2.5
Dimensions en pixels : 300 a 6000 px
Taille maximale par image : 30 Mo
Taille totale du corps de requete ne depassant pas 64 Mo, ne pas utiliser l'encodage Base64
Les URLs d'images doivent etre directement accessibles par le serveur

Remarque : Il n'est pas possible de fournir uniquement audio_urls, vous devez inclure au moins 1 image (image_urls) ou 1 video (video_urls)

Maximum array length: 9

Exemple:

["https://example.com/first-frame.jpg"]

video_urls

string<uri>[]

S’applique uniquement à : Reference-to-Video

Tableau d'URLs de videos de reference, 0 a 3 videos

Description des roles :

Type de media	Role	Utilisation typique
Video	`reference_video`	Reference de mouvement de camera, reference d'action, video originale a editer/etendre

Exigences pour les videos :

Formats pris en charge : .mp4, .mov
Resolution : 480p, 720p, 1080p
Duree par video : 2 a 15 secondes, maximum 3 videos, duree totale de toutes les videos ≤ 15 secondes
Rapport d'aspect (largeur/hauteur) : 0.4 a 2.5
Dimensions en pixels : 300 a 6000 px
Pixels d'image (largeur x hauteur) : 409 600 a 2 086 876 (ex. 640×640 a 834×1112)
Taille maximale par video : 50 Mo
Frequence d'images : 24 a 60 FPS
Taille totale du corps de requete ne depassant pas 64 Mo, ne pas utiliser l'encodage Base64
L'utilisation de references video entraine des frais supplementaires (la duree de la video d'entree est comptabilisee dans la facturation)
Les URLs de videos doivent etre directement accessibles par le serveur

Remarque : Il n'est pas possible de fournir uniquement audio_urls, vous devez inclure au moins 1 image (image_urls) ou 1 video (video_urls)

Maximum array length: 3

Exemple:

["https://example.com/reference.mp4"]

audio_urls

string<uri>[]

S’applique uniquement à : Reference-to-Video

Tableau d'URLs d'audios de reference, 0 a 3 segments

Description des roles :

Type de media	Role	Utilisation typique
Audio	`reference_audio`	Musique de fond, effets sonores, reference vocale/dialogue

Exigences pour les audios :

Formats pris en charge : .wav, .mp3
Duree par segment audio : 2 a 15 secondes, maximum 3 segments, duree totale de tous les audios ≤ 15 secondes
Taille maximale par segment : 15 Mo
Taille totale du corps de requete ne depassant pas 64 Mo, ne pas utiliser l'encodage Base64
Les URLs d'audios doivent etre directement accessibles par le serveur

Remarque : L'audio ne peut pas etre fourni seul, il doit inclure au moins 1 video ou image de reference

Maximum array length: 3

Exemple:

["https://example.com/bgm.mp3"]

duration

integer

défaut:5

Text-to-Video / Image-to-Video

Duree de la video (secondes), par defaut 5 secondes

Details :

Prend en charge toute valeur entiere entre 4 et 15 secondes
La duree est directement liee a la facturation

Reference-to-Video

Duree de la video de sortie (secondes), par defaut 5 secondes

Details :

Prend en charge toute valeur entiere entre 4 et 15 secondes
La duree est directement liee a la facturation

Plage requise: 4 <= x <= 15

Exemple:

8

quality

enum<string>

défaut:720p

Resolution video, par defaut 720p

Valeurs possibles :

480p : resolution inferieure, prix reduit
720p : resolution standard, valeur par defaut

Options disponibles:

480p,

720p

Exemple:

"720p"

aspect_ratio

enum<string>

défaut:adaptive

Text-to-Video

Rapport d'aspect de la video, par defaut adaptive

Valeurs possibles :

16:9 (paysage), 9:16 (portrait), 1:1 (carre), 4:3, 3:4, 21:9 (ultra-large)
adaptive : le modele choisit intelligemment le meilleur rapport d'aspect en fonction du prompt

Pixels correspondants par resolution :

Rapport d'aspect	480p	720p
16:9	864×496	1280×720
4:3	752×560	1112×834
1:1	640×640	960×960
3:4	560×752	834×1112
9:16	496×864	720×1280
21:9	992×432	1470×630

Image-to-Video

Rapport d'aspect de la video, par defaut adaptive

Valeurs possibles :

16:9 (paysage), 9:16 (portrait), 1:1 (carre), 4:3, 3:4, 21:9 (ultra-large)
adaptive : selectionne automatiquement le rapport d'aspect le plus proche en fonction de la premiere image

Pixels correspondants par resolution :

Rapport d'aspect	480p	720p
16:9	864×496	1280×720
4:3	752×560	1112×834
1:1	640×640	960×960
3:4	560×752	834×1112
9:16	496×864	720×1280
21:9	992×432	1470×630

Reference-to-Video

Rapport d'aspect de la video, par defaut adaptive

Valeurs possibles :

16:9 (paysage), 9:16 (portrait), 1:1 (carre), 4:3, 3:4, 21:9 (ultra-large)
adaptive : determine en fonction de l'intention du prompt, priorite : video > image > prompt

Pixels correspondants par resolution :

Rapport d'aspect	480p	720p
16:9	864×496	1280×720
4:3	752×560	1112×834
1:1	640×640	960×960
3:4	560×752	834×1112
9:16	496×864	720×1280
21:9	992×432	1470×630

Options disponibles:

16:9,

9:16,

1:1,

4:3,

3:4,

21:9,

adaptive

Exemple:

"16:9"

generate_audio

boolean

défaut:true

Text-to-Video

Generer ou non un audio synchronise, par defaut true

Valeurs possibles :

true : la video inclut un audio synchronise (voix, effets sonores, musique de fond), sans frais supplementaires. Il est recommande de placer les dialogues entre guillemets pour optimiser la generation audio
false : video muette en sortie

Image-to-Video / Reference-to-Video

Generer ou non un audio synchronise, par defaut true

Valeurs possibles :

true : la video inclut un audio synchronise, sans frais supplementaires
false : video muette en sortie

Exemple:

true

content_filter

boolean

défaut:true

Filtre de contenu, par defaut true

Valeurs possibles :

true : verification standard de securite du contenu, c'est la valeur par defaut
false : assouplit les restrictions de contenu, facture avec +10% (1.1x). Les contenus illegaux et interdits sont toujours appliques independamment de ce parametre

Incompatible avec la recherche web :

content_filter: false et model_params.web_search: true ne peuvent pas etre utilises ensemble ; les envoyer ensemble renvoie une erreur de parametre 400
Conservez content_filter: true (valeur par defaut) si la recherche web est necessaire

Exemple:

true

model_params

object

S’applique uniquement à : Text-to-Video

Parametres etendus du modele

Show child attributes

callback_url

string<uri>

URL de rappel HTTPS apres l'achevement de la tache

Declenchement du rappel :

Declenche lorsque la tache est terminee (completed), echouee (failed) ou annulee (cancelled)
Envoye apres la confirmation de la facturation

Restrictions de securite :

Seul le protocole HTTPS est pris en charge
Les rappels vers les adresses IP privees 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 depasser 2048 caracteres

Mecanisme de rappel :

Delai d'expiration : 10 secondes
Jusqu'a 3 tentatives apres un echec (respectivement 1/2/4 secondes apres l'echec)
Le format du corps de reponse du rappel est identique a celui de l'interface de consultation de tache
Un code de statut 2xx est considere comme un succes, les autres codes declenchent une nouvelle tentative

Exemple:

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

Réponse

Tache de generation video creee avec succes

created

integer

Horodatage de creation de la tache

Exemple:

1761313744

string

ID de la tache

Exemple:

"task-unified-1774857405-abc123"

model

string

Nom du modele effectivement utilise

Exemple:

"seedance-2.0-fast-text-to-video"

object

enum<string>

Type specifique de la tache

Options disponibles:

video.generation.task

progress

integer

Pourcentage de progression de la tache (0-100)

Plage requise: 0 <= x <= 100

Exemple:

0

status

enum<string>

Statut de la tache

Options disponibles:

pending,

processing,

completed,

failed

Exemple:

"pending"

task_info

object

Informations detaillees de la tache video

Show child attributes

type

enum<string>

Type de sortie de la tache

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

Seedance 2.0 Fast Guide complet des paramètres

Text-to-Video

Image-to-Video

Reference-to-Video

Autorisations

Toutes les interfaces necessitent une authentification par Bearer Token

Corps

Réponse