curl --request POST \
--url https://api.evolink.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "seedance-2.5-draft-to-video",
"source_task_id": "task-unified-1774857405-abc123"
}
'
{
"created": 1761313744,
"id": "task-unified-1774857405-abc123",
"model": "seedance-2.5-draft-to-video",
"object": "video.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"can_cancel": false,
"estimated_time": 165,
"video_duration": 0
},
"type": "video",
"usage": {
"billing_rule": "per_second",
"credits_reserved": 50,
"user_group": "default"
}
}
Seedance 2.5
Seedance 2.5 Draft-to-Video — conversion en vidéo finale
- Convertit un brouillon Seedance 2.5 terminé (une tâche créée avec
draft: true) en vidéo finale 1080p au contenu identique - Seuls quatre champs sont acceptés :
model,source_task_id,output_formatetcallback_url. Le prompt, les médias, la durée, le rapport d’aspect, la graine aléatoire et les paramètres audio sont repris du brouillon : il est inutile et interdit de les fournir à nouveau. Tout autre champ renvoie une erreur de paramètre 400 - Envoyez la demande de conversion avant le
draft_expires_atdu brouillon. La durée de validité par défaut est de 24 heures après l’achèvement du brouillon ; l’échéance réelle est ledraft_expires_atrenvoyé lors de la consultation de la tâche - Le système vérifie la validité lors de l’acceptation de la demande et avant son envoi pour génération. Une expiration dans la file d’attente fait échouer la conversion et entraîne le remboursement des frais de cette conversion. Prévoyez une marge pour l’attente
- Un même brouillon peut être converti plusieurs fois avant son expiration ; chaque conversion est facturée séparément
- Le traitement est asynchrone. Utilisez l’ID de tâche renvoyé pour consulter la tâche ; la réponse inclut
source_task_id - Le lien de la vidéo générée reste valide pendant 24 heures. Sauvegardez-la rapidement
Règles de facturation :
- La conversion est facturée séparément du brouillon, toujours au tarif
1080p - La durée de sortie correspond à la durée réelle de la vidéo enregistrée pour le brouillon source. Si cette valeur manque, la durée de sortie effective enregistrée dans la tâche source est utilisée
- Sans vidéo en entrée du brouillon, la durée facturée est la durée de sortie. Avec des vidéos en entrée (y compris pour Reference-to-Video, Video Edit et Video Extend), elle est calculée comme
durée de sortie + max(durée des vidéos d’entrée, durée de sortie), arrondie au dixième de seconde supérieur - Si le filtre de contenu était désactivé pour le brouillon (
content_filter: false), la vidéo finale est également facturée avec une majoration de +10% (1.1x) - En cas d’échec de la conversion, les frais de cette conversion sont remboursés ; ceux du brouillon ne le sont pas
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": "seedance-2.5-draft-to-video",
"source_task_id": "task-unified-1774857405-abc123"
}
'
{
"created": 1761313744,
"id": "task-unified-1774857405-abc123",
"model": "seedance-2.5-draft-to-video",
"object": "video.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"can_cancel": false,
"estimated_time": 165,
"video_duration": 0
},
"type": "video",
"usage": {
"billing_rule": "per_second",
"credits_reserved": 50,
"user_group": "default"
}
}
Autorisations
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
Nom du modele de generation video
Options disponibles:
seedance-2.5-draft-to-video Exemple:
"seedance-2.5-draft-to-video"
ID d’une tâche de brouillon Seedance 2.5 terminée
Comment l’obtenir : le champ id renvoyé lors de la création du brouillon (draft: true)
Conditions :
- La tâche doit appartenir au compte courant
- Son modèle doit être l’un des cinq modèles de génération Seedance 2.5
- Elle doit avoir été créée avec
draft: true - Son statut doit être
completed - L’heure actuelle doit précéder le
draft_expires_atrenvoyé par la consultation de cette tâche
Exemple:
"task-unified-1774857405-abc123"
Format de conteneur de sortie, par defaut mp4
Valeurs possibles :
mp4: encodage H.264, meilleure compatibilite et precision colorimetrique standard ; c'est la valeur par defautmov: H.264 + echantillonnage chroma yuv444p + audio PCM, fidelite colorimetrique superieure, recommande pour l'etalonnage, l'incrustation et le compositing. La lecture dans le navigateur peut ne pas fonctionner ; telechargez le fichier et lisez-le avec VLC / mpv / ffplay. Sans frais supplementaires
Le format de sortie du brouillon n’est pas repris. Pour obtenir un fichier mov, indiquez-le ici
Options disponibles:
mp4, mov Exemple:
"mp4"
URL de rappel HTTPS apres l'achevement de la tache
Declenchement du rappel :
- Déclenché lorsque la tâche est terminée (completed) ou a échoué (failed)
- 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
2048caracteres
Mecanisme de rappel :
- Delai d'expiration :
10secondes - Jusqu'a
3tentatives apres un echec (respectivement1/2/4secondes 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
Tâche de conversion en vidéo finale créée avec succès
Horodatage de creation de la tache
Exemple:
1761313744
ID de la tache
Exemple:
"task-unified-1774857405-abc123"
Nom du modele effectivement utilise
Exemple:
"seedance-2.5-draft-to-video"
Type specifique de la tache
Options disponibles:
video.generation.task Pourcentage de progression de la tache (0-100)
Plage requise:
0 <= x <= 100Exemple:
0
Statut de la tache
Options disponibles:
pending, processing, completed, failed Exemple:
"pending"
Informations detaillees de la tache video
Show child attributes
Show child attributes
Type de sortie de la tache
Options disponibles:
text, image, audio, video Exemple:
"video"
Informations d'utilisation et de facturation
Show child attributes
Show child attributes