Créer une vidéo Seedance

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'prompt="A matte magenta cube rotates slowly above a cyan studio floor while a small yellow sphere circles it."' \
  -F 'model="seedance-2-5"' \
  -F 'seconds="4"' \
  -F 'size="1280x720"'

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

Définissez size sur une valeur WxH du tableau des tailles correspondant à votre modèle.

Utilisez exactement doubao-seedance-2-0-mini pour Seedance 2.0 Mini. La valeur abrégée seedance-mini n’est pas un ID de modèle valide.

ID de modèles pris en charge

Choisissez un modèle pour votre mode d’entrée et votre résolution, puis envoyez son ID exact dans le champ model.

Modèle	ID de modèle exact	Modes et niveaux de résolution	Pris en charge `seconds`
Seedance 2.5	`seedance-2-5`	Texte vers vidéo, médias de référence ; `480p`, `720p`	`4`-`30`
Seedance 2.0	`doubao-seedance-2-0`	Texte vers vidéo, médias de référence ; `480p`, `720p`, `1080p`, `4K`	`4`-`15`
Seedance 2.0 Fast	`doubao-seedance-2-0-fast`	Texte vers vidéo, médias de référence ; `480p`, `720p`	`4`-`15`
Seedance 2.0 Mini	`doubao-seedance-2-0-mini`	Texte vers vidéo, médias de référence ; `480p`, `720p`	`4`-`15`
Seedance 1.5 Pro	`doubao-seedance-1-5-pro`	Texte vers vidéo, image vers vidéo ; `480p`, `720p`, `1080p`	`4`-`12`
Seedance 1.0 Pro	`doubao-seedance-1-0-pro`	Texte vers vidéo, image vers vidéo ; `480p`, `720p`, `1080p`	`2`-`10`

Utiliser des images de référence

Envoyez POST /v1/videos sous la forme multipart/form-data, avec les images de référence dans input_reference. Pour plusieurs images, répétez ce champ dans l’ordre des images, avec une URL HTTPS d’image accessible publiquement ou un fichier image importé par champ. Utilisez uniquement des URL ou uniquement des fichiers dans ce champ. Envoyez chaque URL séparément au lieu de joindre les URL par des virgules. Conservez chaque image importée à 20 Mio ou moins (20 × 1024 × 1024 octets). Seedance 1.0 Pro et 1.5 Pro utilisent une image de référence. Seedance 2.0, Fast et Mini acceptent jusqu’à 9 images de référence. Seedance 2.5 accepte jusqu’à 30 images de référence. Ces limites s’appliquent aux URL comme aux fichiers importés. Dans le Prompt, attribuez un rôle à chaque image, tel que le sujet, le décor ou le style visuel. Décrivez l’apparence à préserver, l’action et le mouvement de caméra. Les exemples de requêtes en haut de cette page montrent des entrées d’URL d’images ainsi que des importations d’une ou de plusieurs images.

Envoyer des URL d’images de référence

Utilisez deux URL d’images pour guider l’apparence et le décor du sujet :

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=doubao-seedance-2-0' \
  --form-string 'prompt=Use the subject in @Image1 and the setting in @Image2. Use a slow camera push-in and natural motion.' \
  --form-string 'seconds=5' \
  --form-string 'size=1280x720' \
  --form-string 'input_reference=https://your-image-host/subject.png' \
  --form-string 'input_reference=https://your-image-host/setting.png'

Utiliser des vidéos et des fichiers audio de référence

Seedance 2.0, Fast, Mini et 2.5 acceptent reference_videos et reference_audios. Utilisez des fichiers MP4 pour les références vidéo et des fichiers MP3 pour les références audio. Envoyez chacun sous la forme d’une URL HTTPS accessible publiquement ou d’un fichier importé. Associez l’audio de référence à au moins une image ou vidéo. Dans le Prompt, utilisez @Image1, @Video1 et @Audio1 pour attribuer des rôles à vos références. Numérotez les références selon leur ordre au sein de chaque type de média. Vous pouvez combiner des URL et des importations dans différents champs. Dans chacun de input_reference, reference_videos et reference_audios, utilisez uniquement des URL ou uniquement des fichiers. Pour plusieurs entrées, répétez le champ une fois par entrée au lieu de joindre les URL avec des virgules.

Famille de modèles	Images de référence	Vidéos de référence	Audio de référence	Nombre total d’entrées de référence
Seedance 2.0, Fast et Mini	Jusqu’à 9 URL ou fichiers dans `input_reference`	Jusqu’à 3	Jusqu’à 3	Jusqu’à 12
Seedance 2.5	Jusqu’à 30 URL ou fichiers dans `input_reference`	Jusqu’à 10 URL ou 5 fichiers	Jusqu’à 10 URL ou 5 fichiers	Jusqu’à 50

Chaque vidéo importée doit faire au maximum 50 MiB et chaque fichier audio importé au maximum 15 MiB. Un MiB correspond à 1024 × 1024 octets. Seedance 2.0 standard (doubao-seedance-2-0) présente des limites de médias supplémentaires pour les URL et les fichiers importés. Pour les vidéos de référence, maintenez la durée combinée entre 2 et 15 secondes et la taille totale sous 50 MB. Utilisez une résolution vidéo de référence d’environ 480p (640x640) à 720p (834x1112). Pour l’audio de référence, maintenez la durée combinée à 15 secondes ou moins et chaque fichier à 15 MB ou moins. Les médias importés doivent également respecter les limites d’importation par fichier ci-dessus.

Envoyer une URL de vidéo de référence

Utilisez la vidéo de référence pour guider le mouvement de caméra et l’action :

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=doubao-seedance-2-0' \
  --form-string 'prompt=Follow the camera movement and action in @Video1. Preserve the direction and pace of the motion.' \
  --form-string 'seconds=5' \
  --form-string 'size=1280x720' \
  --form-string 'reference_videos=https://your-media-host/reference.mp4'

Associer une URL d’image à de l’audio

Animez le sujet de référence au rythme de l’audio de référence :

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=doubao-seedance-2-0' \
  --form-string 'prompt=Animate the subject in @Image1 to the rhythm of @Audio1. Preserve the subject appearance and use a fixed camera.' \
  --form-string 'seconds=5' \
  --form-string 'size=1280x720' \
  --form-string 'input_reference=https://your-image-host/subject.png' \
  --form-string 'reference_audios=https://your-media-host/reference.mp3'

Importer des médias de référence avec Seedance 2.5

Importez deux images, une vidéo MP4 et un fichier audio MP3 dans une seule requête :

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=seedance-2-5' \
  --form-string 'prompt=Use the subject in @Image1 and the setting in @Image2. Follow the motion in @Video1 and the rhythm of @Audio1.' \
  --form-string 'seconds=5' \
  --form-string 'size=1280x720' \
  --form 'input_reference=@/path/to/subject.png;type=image/png' \
  --form 'input_reference=@/path/to/setting.png;type=image/png' \
  --form 'reference_videos=@/path/to/reference.mp4;type=video/mp4' \
  --form 'reference_audios=@/path/to/reference.mp3;type=audio/mpeg'

Durée selon le modèle

Définissez seconds sur une valeur entière comprise dans la plage de votre modèle. Si vous l’omettez, CometAPI demande un clip de 5 secondes.

Famille de modèles	Pris en charge `seconds`	Par défaut	Comportement aux limites
Seedance 2.5	`4`-`30`	`5`	Utilisez un nombre entier de secondes dans la plage indiquée.
Seedance 2.0, Seedance 2.0 Fast et Seedance 2.0 Mini	`4`-`15`	`5`	Utilisez un nombre entier de secondes dans la plage indiquée.
Seedance 1.5 Pro	`4`-`12`	`5`	Utilisez un nombre entier de secondes dans la plage indiquée.
Seedance 1.0 Pro	`2`-`10`	`5`	Utilisez un nombre entier de secondes dans la plage indiquée.

Prise en charge des tailles selon le modèle

Seedance 2.5

Pour Seedance 2.5, ces valeurs WxH s’appliquent aux prompts textuels comme aux médias de référence.

Classe de résolution	`16:9`	`4:3`	`1:1`	`3:4`	`9:16`	`21:9`
`480p`	`854x480`	`752x560`	`640x640`	`560x752`	`480x854`	`992x432`
`720p`	`1280x720`	`1112x834`	`960x960`	`834x1112`	`720x1280`	`1470x630`

Modèles Seedance antérieurs

La dernière colonne regroupe les valeurs WxH exactes pour Seedance 1.5 Pro, Seedance 2.0 standard et Fast. Seedance 2.0 Fast utilise uniquement les valeurs 480p et 720p de cette colonne. Les valeurs 1080p de cette colonne s’appliquent à Seedance 1.5 Pro et à Seedance 2.0 standard. Les valeurs 4K s’appliquent uniquement à Seedance 2.0 standard. Dans la colonne Mini, — signifie que la résolution n’est pas prise en charge.

Classe de résolution	Rapport hauteur/largeur	Seedance 2.0 Mini	Série Seedance 1.0	Seedance 1.5 Pro / standard Seedance 2.0 / Fast
`480p`	`16:9`	`864x496`	`864x480`	`864x496`
	`4:3`	`752x560`	`736x544`	`752x560`
	`1:1`	`640x640`	`640x640`	`640x640`
	`3:4`	`560x752`	`544x736`	`560x752`
	`9:16`	`496x864`	`480x864`	`496x864`
	`21:9`	`992x432`	`960x416`	`992x432`
`720p`	`16:9`	`1280x720`	`1248x704`	`1280x720`
	`4:3`	`1112x834`	`1120x832`	`1112x834`
	`1:1`	`960x960`	`960x960`	`960x960`
	`3:4`	`834x1112`	`832x1120`	`834x1112`
	`9:16`	`720x1280`	`704x1248`	`720x1280`
	`21:9`	`1470x630`	`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)

Seedance 2.0 Mini prend en charge 480p et 720p. Définissez size sur une valeur WxH de la colonne Mini.

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 image should control, such as the subject from @Image1, the secondary object from @Image2, and the background or style from @Image3. 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. Use one of the exact values below. Aliases such as seedance-mini are not accepted.

Options disponibles:

seedance-2-5,

doubao-seedance-2-0,

doubao-seedance-2-0-fast,

doubao-seedance-2-0-mini,

doubao-seedance-1-5-pro,

doubao-seedance-1-0-pro

Exemple:

"doubao-seedance-2-0-mini"

seconds

integer

défaut:5

Video duration in seconds. Seedance 2.5 accepts 4 to 30. Seedance 2.0, Seedance 2.0 Fast, and Seedance 2.0 Mini accept 4 to 15. Seedance 1.5 Pro accepts 4 to 12, and Seedance 1.0 Pro accepts 2 to 10. The default is 5.

Plage requise: 2 <= x <= 30

Exemple:

5

size

string

Output size as an exact WxH value. For Seedance 2.5 text-to-video and image-to-video, use 854x480, 752x560, 640x640, 560x752, 480x854, or 992x432 for 480p; use 1280x720, 1112x834, 960x960, 834x1112, 720x1280, or 1470x630 for 720p. For Seedance 2.0 Mini, use 864x496, 752x560, 640x640, 560x752, 496x864, or 992x432 for 480p; use the same documented 720p values. The standard Seedance 2.0 model also accepts its documented 4K values.

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

Exemples:

"854x480"

"480x854"

"864x496"

"752x560"

"640x640"

"560x752"

"496x864"

"992x432"

"1280x720"

"1112x834"

"960x960"

"834x1112"

"720x1280"

"1470x630"

"1920x1080"

"1080x1920"

"3840x2160"

"3326x2494"

"2880x2880"

"2494x3326"

"2160x3840"

"4398x1886"

input_reference

Reference images: repeat input_reference with one publicly accessible HTTPS image URL or one uploaded image file per field. Use only URLs or only files within this field; do not join URLs with commas. Keep each uploaded image at or below 20 MiB. Seedance 2.0, Fast, and Mini allow up to nine image URLs or files and 12 reference inputs in total. Seedance 2.5 allows up to 30 image URLs or files and 50 reference inputs in total. For Seedance 1.0 Pro and 1.5 Pro, send one URL or one file. Submit images in the order you want to reference them in the prompt.

Pattern: ^https://

reference_videos

(string<uri> | file)[]

Reference video inputs for Seedance 2.0, Fast, Mini, and 2.5. Repeat reference_videos with a publicly accessible HTTPS MP4 URL or an uploaded MP4 file. Use only URLs or only files within this field. Each file can be up to 50 MiB. Seedance 2.0, Fast, and Mini allow up to three video inputs and 12 reference inputs in total. Seedance 2.5 allows up to ten video URLs or five uploaded video files, with 50 reference inputs in total. For standard Seedance 2.0 (doubao-seedance-2-0), URL and uploaded references must have a combined video duration of 2 to 15 seconds and a total video size under 50 MB. Each reference video must have a resolution of approximately 480p (640x640) to 720p (834x1112). These media limits apply in addition to the 50 MiB per-file upload limit.

Required array length: 1 - 10 elements

Pattern: ^https://

Exemple:

"https://your-media-host/reference.mp4"

reference_audios

(string<uri> | file)[]

Reference audio inputs for Seedance 2.0, Fast, Mini, and 2.5. Repeat reference_audios with a publicly accessible HTTPS MP3 URL or an uploaded MP3 file. Use only URLs or only files within this field. Each file can be up to 15 MiB. Seedance 2.0, Fast, and Mini allow up to three audio inputs and 12 reference inputs in total. Seedance 2.5 allows up to ten audio URLs or five uploaded audio files, with 50 reference inputs in total. Pair audio with at least one reference image or video. For standard Seedance 2.0 (doubao-seedance-2-0), URL and uploaded audio references must have a combined duration at or below 15 seconds, with each audio file at or below 15 MB. These media limits apply in addition to the 15 MiB per-file upload limit.

Required array length: 1 - 10 elements

Pattern: ^https://

Exemple:

"https://your-media-host/reference.mp3"

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.

Dernière modification le 9 septembre 2026

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'prompt="A matte magenta cube rotates slowly above a cyan studio floor while a small yellow sphere circles it."' \
  -F 'model="seedance-2-5"' \
  -F 'seconds="4"' \
  -F 'size="1280x720"'

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

Modération de contenu

Clés API

ID de modèles pris en charge

Utiliser des images de référence

Envoyer des URL d’images de référence

Utiliser des vidéos et des fichiers audio de référence

Envoyer une URL de vidéo de référence

Associer une URL d’image à de l’audio

Importer des médias de référence avec Seedance 2.5

Durée selon le modèle

Prise en charge des tailles selon le modèle

Seedance 2.5

Modèles Seedance antérieurs

Autorisations

Corps

Réponse

​ID de modèles pris en charge

​Utiliser des images de référence

​Envoyer des URL d’images de référence

​Utiliser des vidéos et des fichiers audio de référence

​Envoyer une URL de vidéo de référence

​Associer une URL d’image à de l’audio

​Importer des médias de référence avec Seedance 2.5

​Durée selon le modèle

​Prise en charge des tailles selon le modèle

​Seedance 2.5

​Modèles Seedance antérieurs

Autorisations

Corps

Réponse

ID de modèles pris en charge

Utiliser des images de référence

Envoyer des URL d’images de référence

Utiliser des vidéos et des fichiers audio de référence

Envoyer une URL de vidéo de référence

Associer une URL d’image à de l’audio

Importer des médias de référence avec Seedance 2.5

Durée selon le modèle

Prise en charge des tailles selon le modèle

Seedance 2.5

Modèles Seedance antérieurs