Seedance 2.0 — Créer une vidéo (format de la plateforme)

Créez une tâche vidéo Seedance 2.0 via l’interface Video Generations de la plateforme.

Accepte les entrées texte, image, vidéo et audio, pour la génération à partir de texte, le contrôle de l’image initiale ou des images initiale et finale, et la génération à partir de ressources de référence.

Pour utiliser directement la structure de requête Volcengine Ark, consultez l’interface de création au format natif.

Seedance 2.0 standard prend en charge 480p/720p/1080p/4k ; Seedance 2.0 fast prend uniquement en charge 480p/720p. Choisissez la résolution selon le modèle utilisé.

POST/v1/video/generations

Créez une tâche asynchrone de génération vidéo. Une soumission réussie renvoie un ID de tâche ; cette interface ne renvoie pas la vidéo de manière synchrone.

Les modèles pris en charge comprennent doubao-seedance-2-0-260128 et doubao-seedance-2-0-fast-260128. Les modèles réellement disponibles sont ceux de la liste renvoyée pour la clé API actuelle.

Authentification

bearerAuth

AuthentificationBearer <token>

Utilisez Bearer your-api-key dans le Header Authorization.

Emplacement: header

Corps de requête

application/json

Paramètres de génération vidéo Seedance 2.0.

Définitions TypeScript

Utilisez le type request body en TypeScript.

model*string

ID d’un modèle Seedance 2.0 ou ID d’un point d’accès d’inférence (Endpoint) configuré pour ce modèle. doubao-seedance-2-0-260128 et doubao-seedance-2-0-fast-260128 sont pris en charge ; les possibilités réellement disponibles dépendent de la clé API actuelle.

Longueur1 <= length

content*array<>

Liste d’entrées. Le mode référence accepte jusqu’à 9 images, 3 vidéos et 3 extraits audio. Chaque vidéo ou extrait audio dure 2 à 15 secondes ; le total par type ne dépasse pas 15 secondes. L’audio exige au moins une image ou une vidéo. Ne combinez pas les modes première image ou première/dernière image avec la référence multimodale.

Éléments1 <= items

generate_audio?boolean

Indique s’il faut générer du son synchronisé avec les images. Avec true, le modèle peut produire des voix, des effets sonores et une musique de fond adaptés au prompt et au contenu visuel ; avec false, la vidéo est muette.

ratio?string

Format de l’image vidéo. Seedance 2.0 et Seedance 2.0 fast utilisent adaptive par défaut, pour choisir automatiquement un format adapté à l’entrée.

Valeur par défaut"adaptive"

Valeurs autorisées

"16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive"

duration?|unknown

Durée de la vidéo générée, en secondes. Seedance 2.0 et Seedance 2.0 fast acceptent un entier de 4 à 15, ou -1 pour laisser le modèle déterminer la durée.

resolution?string

Résolution vidéo, 720p par défaut. Seedance 2.0 standard accepte 480p/720p/1080p/4k ; Seedance 2.0 fast accepte uniquement 480p/720p.

Valeur par défaut"720p"

Valeurs autorisées

"480p"
"720p"
"1080p"
"4k"

watermark?boolean

Indique s’il faut ajouter un filigrane à la vidéo générée.

seed?integer

Graine aléatoire, de -1 à 4294967295. Une même graine peut améliorer la reproductibilité, sans garantir des résultats strictement identiques.

Plage-1 <= value <= 4294967295

return_last_frame?boolean

Indique s’il faut renvoyer la dernière image JPEG sans filigrane pour générer des vidéos consécutives.

callback_url?string

URL qui reçoit un callback POST lors des changements d’état de la tâche. Le corps du callback a la même structure que la réponse de l’interface de consultation des tâches ; sans cette URL, vous pouvez consulter régulièrement l’état de la tâche.

Formaturi

safety_identifier?string

Identifiant unique et stable de l’utilisateur final, pour aider à repérer les utilisateurs susceptibles d’enfreindre les règles d’utilisation. Utilisez de préférence une chaîne obtenue en hachant le nom d’utilisateur, l’ID utilisateur ou l’adresse e-mail, afin de ne pas transmettre de données personnelles.

Longueur1 <= length <= 64

execution_expires_after?integer

Durée de validité de la tâche depuis sa création, en secondes. Une tâche non terminée à l’expiration de ce délai est interrompue et marquée expired.

Formatint32

Plage3600 <= value <= 259200

Valeur par défaut172800

tools?array<>

Liste des outils que le modèle peut appeler, par exemple web_search. Les types d’outils et leurs paramètres supplémentaires dépendent des capacités du modèle et du compte actuels.

service_tier?string

Niveau de service utilisé par la tâche. Seedance 2.0 et Seedance 2.0 fast utilisent le service d’inférence en ligne default et ne prennent pas en charge l’inférence hors ligne flex.

Valeur par défaut"default"

priority?integer

Priorité de file pour un même point de terminaison d’inférence, de 0 à 9. Une valeur élevée est prioritaire ; à priorité égale, l’ordre d’envoi s’applique. Les tâches en cours ne sont pas interrompues.

Plage0 <= value <= 9

Valeur par défaut0

Corps de réponse

`application/json`

curl -X POST "https://example.com/v1/video/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "content": [      {        "type": "text",        "text": "Un petit lapin de Noël en plein vol"      }    ],    "generate_audio": true,    "ratio": "16:9",    "duration": 11,    "resolution": "1080p",    "watermark": false,    "execution_expires_after": 172800  }'

{
  "id": "cgt-20260330164007-wnc8k",
  "task_id": "cgt-20260330164007-wnc8k",
  "object": "video",
  "model": "MODEL_ID",
  "status": "queued",
  "progress": 0,
  "created_at": 1774860007
}

Documentation officielle Volcengine Ark sur la création de tâches de génération vidéoConsultez la définition du protocole en amont et les dernières évolutions des champs des tâches vidéo Seedance.

Seedance 2.0 — Créer une vidéo (format de la plateforme)

Authentification

Corps de requête

Corps de réponse

200application/json

400application/json

401application/json

402application/json

429application/json

500application/json

502application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`