Guide des vidéos Draft Seedance 2.5

Vérifiez un brouillon 480p, puis utilisez son ID de tâche Draft pour créer une vidéo finale 1080p.

Le mode Draft permet de vérifier la scène, les mouvements de caméra et les actions du sujet avant de créer la vidéo finale. Il utilise les API de création et de consultation existantes : créez un brouillon 480p, vérifiez le résultat, puis référencez son ID pour créer une vidéo finale 1080p.

Processus d’appel

Choisissez un format et suivez les quatre étapes ci-dessous. Remplacez MODEL_ID par un modèle Seedance 2.5 accessible avec votre API Key et remplacez les valeurs fictives de clé et d’ID de tâche par les vôtres. Les deux créations doivent utiliser le même modèle et le même compte.

Créer un brouillon Draft

Envoyez le prompt ou les médias de référence à l’API de création de la plateforme avec draft: true et resolution: "480p". Enregistrez le task_id renvoyé (équivalent à id) sous PLATFORM_DRAFT_TASK_ID pour consulter le brouillon.

curl 'https://api.agtcloud.cn/v1/video/generations' \
  -H 'Authorization: Bearer your-api-key' \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "MODEL_ID",
    "content": [
      {"type": "text", "text": "Un petit lapin blanc traverse les nuages sur un avion en papier, avec un travelling avant fluide"}
    ],
    "draft": true,
    "resolution": "480p",
    "duration": 5,
    "ratio": "16:9"
  }'

Consulter et vérifier le brouillon

Consultez la tâche avec son ID plateforme et utilisez raw=true pour lire les données natives. Si status vaut queued/running, attendez puis réessayez ; après réussite, ouvrez content.video_url pour prévisualiser le résultat et enregistrez l’id de la réponse native sous DRAFT_TASK_ID.

curl 'https://api.agtcloud.cn/v1/video/generations/PLATFORM_DRAFT_TASK_ID?raw=true' \
  -H 'Authorization: Bearer your-api-key'

La deuxième phase utilise l’ID natif du brouillon DRAFT_TASK_ID ; ne le confondez pas avec l’ID utilisé pour la consultation plateforme. Arrêtez le polling et lisez l’erreur si la tâche échoue, est annulée ou expire. Seul un brouillon succeeded permet de continuer.

Créer la vidéo finale à partir du brouillon

Après validation du brouillon, utilisez le même MODEL_ID et référencez son ID natif via content.draft_task.id. La résolution doit être 1080p ; ne renvoyez pas le prompt, les médias, la durée ni les autres paramètres hérités automatiquement.

curl 'https://api.agtcloud.cn/v1/video/generations' \
  -H 'Authorization: Bearer your-api-key' \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "MODEL_ID",
    "content": [
      {"type": "draft_task", "draft_task": {"id": "DRAFT_TASK_ID"}}
    ],
    "resolution": "1080p"
  }'

Enregistrez le nouvel ID plateforme sous PLATFORM_FINAL_TASK_ID. Il identifie une tâche distincte de celle du brouillon.

Consulter et sauvegarder la vidéo finale

Consultez le nouvel ID de tâche ; après réussite, téléchargez la vidéo finale depuis content.video_url dans la réponse native. draft vaut false et draft_task_id référence le brouillon utilisé.

curl 'https://api.agtcloud.cn/v1/video/generations/PLATFORM_FINAL_TASK_ID?raw=true' \
  -H 'Authorization: Bearer your-api-key'

Si vous utilisez l’enveloppe plateforme par défaut sans raw=true, lisez data.status et l’URL du résultat selon l’API de consultation au format plateforme ; n’utilisez pas directement les chemins de champs de la réponse native.

Règles des paramètres de génération finale

Catégorie	Champs	Traitement lors de la génération finale
Exigences fixes	`model`, `content.draft_task.id`, `resolution`, `draft`	Utiliser le même modèle et l’ID natif d’un brouillon réussi ; résolution `1080p` ; omettre `draft` ou utiliser `false`
Héritage automatique	Prompt, images/vidéos/audio de référence, `duration`, `ratio`, `seed`, `generate_audio`, `omni_reference_task_type`	Ne pas renvoyer ces paramètres ; même des valeurs identiques à celles du brouillon provoquent une erreur
Reconfiguration possible	`return_last_frame`, `output_format`, `watermark`, `service_tier`, `execution_expires_after`, `priority`, `callback_url`, `safety_identifier`	Configurer selon la vidéo finale ; si omis, les valeurs par défaut de la requête actuelle s’appliquent, sans garantie de reprendre celles du brouillon

Validité et facturation

L’ID de tâche Draft est valide pendant sept jours à partir de created_at ; il ne peut plus servir à créer une vidéo finale après expiration.
Le brouillon et la vidéo finale sont deux tâches distinctes, facturées séparément. Le brouillon est facturé en 480p ; la vidéo finale selon la résolution cible et les conditions d’entrée.
L’URL du résultat vidéo est valide 24 heures, avec au maximum 100 téléchargements. Téléchargez ou transférez le fichier rapidement.
Ce guide s’applique à Seedance 2.5, pas à Seedance 2.0.

Consultez les champs complets dans les références création plateforme, création native, consultation plateforme et consultation native.

Guide officiel Draft de Seedance 2.5Consulter les règles d’héritage des paramètres, les limites de génération et le processus d’appel du mode Draft.