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

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

Accepte les références texte, image, vidéo et audio pour la génération à partir de texte, d’une image initiale ou d’images initiale et finale, la génération à partir de références multimodales, la modification et le prolongement vidéo.

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

Pour vérifier un brouillon basse résolution avant de créer la vidéo finale, consultez le guide des vidéos Draft. Le brouillon utilise 480p ; la vidéo finale créée à partir du brouillon utilise 1080p.

POST/v1/video/generations

Créez une tâche vidéo asynchrone Seedance 2.5 via le chemin Video Generations de la plateforme. L’interface renvoie un objet de tâche et un ID permettant de consulter le résultat.

Seedance 2.5 prend en charge des vidéos de 30 secondes au maximum, jusqu’à 50 ressources de référence multimodales et les formats de sortie mp4 et mov. Pour les tâches de modification vidéo, ratio doit être adaptive et duration doit être -1.

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.5. Les contraintes de rôle des ressources, de format de l’image et de durée varient selon le type de tâche.

Définitions TypeScript

Utilisez le type request body en TypeScript.

model*string

ID de modèle Seedance 2.5, par exemple doubao-seedance-2-5-260628. Pour les appels réels, utilisez les modèles visibles pour la clé API actuelle.

Longueur1 <= length

content*array<|>

Liste d’entrées : texte, images, vidéos, audio ou ID de tâche Draft. La référence multimodale accepte jusqu’à 50 ressources : 30 images, 10 vidéos et 10 extraits audio. Chaque vidéo ou extrait audio dure 2 à 30 secondes ; le total par type ne dépasse pas 30 secondes. Le montage exige une vidéo de référence de 4 à 30 secondes. La référence audio seule est prise en charge. Ne combinez pas les modes première image ou première/dernière image avec la référence multimodale.

Référencez les ressources dans l’ordre du tableau avec @image1, @video1 et @audio1.

Éléments1 <= items

draft?boolean

Indique s’il faut générer un aperçu Draft. Avec true, utilisez 480p. Après réussite, utilisez content.draft_task.id sous sept jours pour générer une vidéo finale 1080p. Omettez ce champ ou indiquez false pour la génération finale.

omni_reference_task_type?string

Type de tâche multimodale. auto effectue une détection automatique ; reference génère à partir de références ; edit exige une vidéo de référence, ratio=adaptive et duration=-1 ; extend exige une vidéo de référence et ratio=adaptive. Un type explicite permet une validation anticipée. L’intention du prompt doit correspondre au type choisi.

Valeur par défaut"auto"

Valeurs autorisées

"auto"
"reference"
"edit"
"extend"

generate_audio?boolean

Indique s’il faut générer un audio adapté aux images. Cette option augmente généralement le temps de génération et le coût facturé.

ratio?string

Format de l’image vidéo. La génération à partir de texte ou de références multimodales accepte un format spécifié ou adaptive ; les tâches à image initiale, à images initiale et finale, de modification et de prolongement vidéo acceptent uniquement adaptive.

Valeur par défaut"adaptive"

Valeurs autorisées

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

duration?|integer

Durée de génération, en secondes. Accepte de 4 à 30, ou -1 pour laisser le modèle déterminer la durée. Les tâches de modification vidéo acceptent uniquement -1 ; le prolongement vidéo accepte de 4 à 30 ou -1.

Valeur par défaut-1

resolution?string

Résolution de la vidéo de sortie. Accepte 480p, 720p et 1080p ; les dimensions réelles en pixels dépendent conjointement de la résolution, du format de l’image et des capacités du modèle actuel.

Valeur par défaut"720p"

Valeurs autorisées

"480p"
"720p"
"1080p"

output_format?string

Format de la vidéo de sortie. mp4 convient au web et à la diffusion courante ; mov utilise H.264, YUV444P et PCM et convient à la postproduction, notamment à l’étalonnage, au détourage et à la composition.

Valeur par défaut"mp4"

Valeurs autorisées

"mp4"
"mov"

watermark?boolean

Indique s’il faut ajouter un filigrane. Son application dépend des autorisations du modèle et de la configuration du service.

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 de callback à la fin de la tâche. Sans cette URL, vous pouvez consulter régulièrement l’état via l’interface de consultation.

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 après ce délai passe à l’état expiré.

Formatint32

Plage3600 <= value <= 259200

Valeur par défaut172800

tools?array<>

Liste des outils que le modèle peut appeler, par exemple web_search. Les outils disponibles et leurs paramètres dépendent des autorisations du compte actuel.

service_tier?string

Niveau de service. Seedance 2.5 utilise l’inférence en ligne default et ne prend pas en charge flex. La priorité de file se définit avec le paramètre distinct priority.

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

[key: string]?any

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 blanc traverse les nuages sur un avion en papier, avec un éclairage cinématographique et une avancée fluide de la caméra"      }    ],    "generate_audio": true,    "ratio": "16:9",    "duration": 10,    "resolution": "1080p",    "output_format": "mp4",    "watermark": false  }'

{
  "id": "task_xxxxx",
  "task_id": "task_xxxxx",
  "object": "video",
  "model": "MODEL_ID",
  "status": "queued",
  "progress": 0,
  "created_at": 1786082400
}

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.5 — 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`