Créer une vidéo Seedance

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'prompt="A slow cinematic camera push across a coastal landscape at sunrise"' \
  -F 'model="doubao-seedance-2-0"' \
  -F 'seconds="4"' \
  -F 'size="3840x2160"'

{
  "id": "task_abc123",
  "task_id": "task_abc123",
  "object": "video",
  "model": "doubao-seedance-2-0",
  "status": "queued",
  "progress": 0,
  "created_at": 1776681149
}

Choisissez dans le tableau ci-dessous une valeur WxH documentée pour le champ size.

Utiliser des images de référence

Seuls les modèles Seedance 2.0 acceptent input_reference. Ajoutez un fichier input_reference pour une génération guidée par image. Pour les prompts avancés à références multiples, répétez le même champ multipart dans l’ordre d’envoi. Seedance 2.0 est sensible à la façon dont le prompt associe chaque image de référence à la scène. Faites référence aux fichiers envoyés dans leur ordre, par exemple [Image 1], [Image 2] et [Image 3], puis attribuez un rôle clair à chaque image :

Utilisez [Image 1] pour le sujet principal, le personnage ou le produit.
Utilisez [Image 2] pour un sujet secondaire, un accessoire ou un compagnon.
Utilisez [Image 3] pour l’arrière-plan, le décor, l’éclairage ou le style.

Décrivez ce qui doit rester reconnaissable, ce qui peut changer, l’action, le mouvement de la caméra, le style visuel et la scène. Un prompt vague peut donner l’impression que l’image de référence n’a pas été utilisée dans la vidéo générée, même lorsque l’envoi a été accepté. Cette structure de prompt est plus fiable que le simple fait de lister des images :

Use the uploaded images in order: keep the boy wearing glasses and a blue T-shirt from [Image 1], add the corgi puppy from [Image 2], and use the lawn from [Image 3] as the setting. Create a 4-second 3D cartoon video with the boy and puppy sitting together, a slow camera push-in, soft daylight, and no extra characters.

Durée par modèle

Si vous omettez seconds, CometAPI demande un clip de 5 secondes. Envoyez seconds sous forme de chaîne lorsque vous avez besoin d’une durée spécifique.

Famille de modèles	Pris en charge `seconds`	Par défaut	Comportement aux limites
Seedance 2.0 et Seedance 2.0 Fast	`4`-`15`	`5`	Utilisez des secondes entières dans la plage.
Seedance 1.5 Pro	`4`-`12`	`5`	Utilisez des secondes entières dans la plage.
Seedance 1.0 Pro	`2`-`10`	`5`	Utilisez des secondes entières dans la plage.

Prise en charge des tailles par modèle

Le tableau ci-dessous suit le mappage officiel des résolutions Seedance et regroupe les valeurs de taille publiées en un seul endroit. Pour 1080p, la colonne la plus à droite répertorie les valeurs Seedance 1.5 Pro et Seedance 2.0 documentées. Seedance 2.0 Fast ne figure pas dans ce tableau officiel 1080p. Les entrées 4K s’appliquent uniquement à doubao-seedance-2-0. Vous pouvez les utiliser pour les requêtes de conversion texte-vidéo ou image-vidéo qui incluent input_reference. Elles ne s’appliquent pas à doubao-seedance-2-0-fast. Transmettez la valeur WxH exacte indiquée dans le tableau.

Classe de résolution	Rapport hauteur/largeur	Valeurs en pixels pour la série Seedance 1.0	Valeurs en pixels pour Seedance 1.5 Pro / Seedance 2.0 / Seedance 2.0 Fast
`480p`	`16:9`	`864x480`	`864x496`
	`4:3`	`736x544`	`752x560`
	`1:1`	`640x640`	`640x640`
	`3:4`	`544x736`	`560x752`
	`9:16`	`480x864`	`496x864`
	`21:9`	`960x416`	`992x432`
`720p`	`16:9`	`1248x704`	`1280x720`
	`4:3`	`1120x832`	`1112x834`
	`1:1`	`960x960`	`960x960`
	`3:4`	`832x1120`	`834x1112`
	`9:16`	`704x1248`	`720x1280`
	`21:9`	`1504x640`	`1470x630`
`1080p`	`16:9`	`1920x1088`	`1920x1080`
	`4:3`	`1664x1248`	`1664x1248`
	`1:1`	`1440x1440`	`1440x1440`
	`3:4`	`1248x1664`	`1248x1664`
	`9:16`	`1088x1920`	`1080x1920`
	`21:9`	`2176x928`	`2206x946`
`4K`	`16:9`	—	`3840x2160` (Seedance 2.0 uniquement)
	`4:3`	—	`3326x2494` (Seedance 2.0 uniquement)
	`1:1`	—	`2880x2880` (Seedance 2.0 uniquement)
	`3:4`	—	`2494x3326` (Seedance 2.0 uniquement)
	`9:16`	—	`2160x3840` (Seedance 2.0 uniquement)
	`21:9`	—	`4398x1886` (Seedance 2.0 uniquement)

Choisissez la valeur WxH documentée pour le modèle cible. La prise en charge exacte de WxH reste dépendante du modèle ; inspectez le média finalisé avant de vous appuyer sur une taille non documentée.

Autorisations

Authorization

string

header

requis

Bearer token authentication. Use your CometAPI key.

Corps

multipart/form-data

prompt

string

requis

Text prompt that describes the video. Required. When using reference images, describe what each uploaded image should control, such as the subject from [Image 1], the secondary object from [Image 2], and the background or style from [Image 3]. Also state the action, camera motion, visual style, and scene.

Exemple:

"A slow cinematic camera push across a coastal landscape at sunrise."

model

enum<string>

requis

Seedance model id. Only the two 2.0 models accept input_reference.

Options disponibles:

doubao-seedance-2-0,

doubao-seedance-2-0-fast,

doubao-seedance-1-5-pro,

doubao-seedance-1-0-pro

Exemple:

"doubao-seedance-2-0"

seconds

integer

défaut:5

Video duration in seconds. The accepted range depends on the model: doubao-seedance-2-0 and doubao-seedance-2-0-fast accept 4 to 15, doubao-seedance-1-5-pro accepts 4 to 12, and doubao-seedance-1-0-pro accepts 2 to 10. The default is 5 for every model.

Plage requise: 2 <= x <= 15

Exemple:

5

size

string

Output size as an exact WxH value, such as 1280x720. For doubao-seedance-2-0 4K output, use 3840x2160, 3326x2494, 2880x2880, 2494x3326, 2160x3840, or 4398x1886. These 4K values work for text-to-video and requests with input_reference, but they do not apply to doubao-seedance-2-0-fast. Exact WxH support remains model-dependent, and an undocumented value can normalize to another size or fail.

Pattern: ^[1-9]\d{2,3}x[1-9]\d{2,3}$

Exemples:

"1280x720"

"1920x1080"

"3840x2160"

"3326x2494"

"2880x2880"

"2494x3326"

"2160x3840"

"4398x1886"

"1112x834"

"960x960"

"834x1112"

"720x1280"

"1080x1920"

"1470x630"

input_reference

file

Optional reference image uploaded as a multipart file. Repeat this field to send multiple reference images; the order of repeated fields is the order you should reference in the prompt as [Image 1], [Image 2], and so on. Use JPEG or PNG files for best compatibility. Only doubao-seedance-2-0 and doubao-seedance-2-0-fast accept this field; sending it with a 1.0 Pro or 1.5 Pro model returns HTTP 400.

Réponse

Task created. Save the returned id and poll GET /v1/videos/{id}.

string

requis

Task id. Use it as the path parameter for GET /v1/videos/{id}.

object

string

requis

Object type, always video.

model

string

requis

Echo of the requested model id.

status

enum<string>

requis

Initial task status. Newly created tasks are returned as queued.

Options disponibles:

queued,

in_progress,

completed,

failed,

error

progress

integer

requis

Completion percentage. 0 at creation.

Plage requise: 0 <= x <= 100

created_at

integer

requis

Task creation time as a Unix timestamp in seconds.

task_id

string

Alias of id returned for compatibility. The value matches id.

API de génération vidéo

Récupérer une vidéo Seedance

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'prompt="A slow cinematic camera push across a coastal landscape at sunrise"' \
  -F 'model="doubao-seedance-2-0"' \
  -F 'seconds="4"' \
  -F 'size="3840x2160"'

{
  "id": "task_abc123",
  "task_id": "task_abc123",
  "object": "video",
  "model": "doubao-seedance-2-0",
  "status": "queued",
  "progress": 0,
  "created_at": 1776681149
}

Modération de contenu

Clés API

Utiliser des images de référence

Durée par modèle

Prise en charge des tailles par modèle

Autorisations

Corps

Réponse

​Utiliser des images de référence

​Durée par modèle

​Prise en charge des tailles par modèle

Autorisations

Corps

Réponse

Utiliser des images de référence

Durée par modèle

Prise en charge des tailles par modèle