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_format et callback_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_at du 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 le draft_expires_at renvoyé 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
Durée facturée : sans vidéo en entrée du brouillon, la durée de sortie ; avec des vidéos en entrée (y compris pour Reference-to-Video, Video Edit et Video Extend), durée de sortie + max(durée des vidéos d’entrée, durée de sortie). Dans les deux cas, elle est 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

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

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

model

enum<string>

défaut:seedance-2.5-draft-to-video

requis

Nom du modele de generation video

Options disponibles:

seedance-2.5-draft-to-video

Exemple:

"seedance-2.5-draft-to-video"

source_task_id

string

requis

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_at renvoyé par la consultation de cette tâche

Exemple:

"task-unified-1774857405-abc123"

output_format

enum<string>

défaut:mp4

Format de conteneur de sortie, par defaut mp4

Valeurs possibles :

mp4 : format de conteneur par défaut. Cet endpoint produit des vidéos 1080p avec une profondeur de couleur de 10 bits et un encodage H.265/HEVC. La lecture nécessite la prise en charge du HEVC 10 bits ; les lecteurs limités au H.264 peuvent ne pas lire la vidéo
mov : 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"

callback_url

string<uri>

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 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

Tâche de conversion en vidéo finale créée avec succès

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.5-draft-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.5 Draft-to-Video — conversion en vidéo finale

Autorisations

Toutes les interfaces necessitent une authentification par Bearer Token

Corps

Réponse