Creare un video 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
}

Imposta size su un valore WxH dalla tabella delle dimensioni per il tuo modello.

Usa esattamente doubao-seedance-2-0-mini per Seedance 2.0 Mini. Il valore abbreviato seedance-mini non è un ID modello valido.

ID modello supportati

Scegli un modello in base alla modalità di input e alla risoluzione, quindi invia il relativo ID esatto nel campo model.

Modello	ID modello esatto	Modalità e livelli di risoluzione	Supportato `seconds`
Seedance 2.5	`seedance-2-5`	Da testo a video, media di riferimento; `480p`, `720p`	`4`-`30`
Seedance 2.0	`doubao-seedance-2-0`	Da testo a video, media di riferimento; `480p`, `720p`, `1080p`, `4K`	`4`-`15`
Seedance 2.0 Fast	`doubao-seedance-2-0-fast`	Da testo a video, media di riferimento; `480p`, `720p`	`4`-`15`
Seedance 2.0 Mini	`doubao-seedance-2-0-mini`	Da testo a video, media di riferimento; `480p`, `720p`	`4`-`15`
Seedance 1.5 Pro	`doubao-seedance-1-5-pro`	Da testo a video, da immagine a video; `480p`, `720p`, `1080p`	`4`-`12`
Seedance 1.0 Pro	`doubao-seedance-1-0-pro`	Da testo a video, da immagine a video; `480p`, `720p`, `1080p`	`2`-`10`

Utilizzare immagini di riferimento

Invia POST /v1/videos come multipart/form-data, con le immagini di riferimento in input_reference. Per più immagini, ripeti il campo nell’ordine delle immagini, con un URL HTTPS di immagine accessibile pubblicamente o un file di immagine caricato per campo. Usa solo URL o solo file all’interno di questo campo. Invia ogni URL separatamente anziché unire gli URL con virgole. Mantieni ogni immagine caricata a una dimensione pari o inferiore a 20 MiB (20 × 1024 × 1024 byte). Seedance 1.0 Pro e 1.5 Pro usano un’immagine di riferimento. Seedance 2.0, Fast e Mini accettano fino a 9 immagini di riferimento. Seedance 2.5 accetta fino a 30 immagini di riferimento. Questi limiti si applicano sia agli URL sia ai file caricati. Nel Prompt, assegna a ogni immagine un ruolo, ad esempio soggetto, ambientazione o stile visivo. Descrivi l’aspetto da preservare, l’azione e il movimento della fotocamera. Gli esempi di richieste nella parte superiore di questa pagina mostrano input con URL di immagini e caricamenti di una o più immagini.

Inviare URL di immagini di riferimento

Usa due URL di immagini per guidare l’aspetto del soggetto e l’ambientazione:

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'

Usare video e audio di riferimento

Seedance 2.0, Fast, Mini e 2.5 accettano reference_videos e reference_audios. Usare file MP4 per i riferimenti video e file MP3 per i riferimenti audio. Inviare ciascuno come URL HTTPS accessibile pubblicamente o come file caricato. Associare l’audio di riferimento ad almeno un’immagine o un video. Nel Prompt, usare @Image1, @Video1 e @Audio1 per assegnare ruoli ai riferimenti. Numerare i riferimenti in base al loro ordine all’interno di ciascun tipo di file multimediale. È possibile combinare URL e caricamenti in campi diversi. All’interno di ciascuno di input_reference, reference_videos e reference_audios, usare solo URL oppure solo file. Per più input, ripetere il campo una volta per ogni input anziché unire gli URL con virgole.

Famiglia di modelli	Immagini di riferimento	Video di riferimento	Audio di riferimento	Input di riferimento totali
Seedance 2.0, Fast e Mini	Fino a 9 URL o file in `input_reference`	Fino a 3	Fino a 3	Fino a 12
Seedance 2.5	Fino a 30 URL o file in `input_reference`	Fino a 10 URL o 5 file	Fino a 10 URL o 5 file	Fino a 50

Mantenere ogni video caricato a un massimo di 50 MiB e ogni file audio caricato a un massimo di 15 MiB. Un MiB corrisponde a 1024 × 1024 byte. Seedance 2.0 standard (doubao-seedance-2-0) presenta limiti aggiuntivi per i file multimediali, sia per gli URL sia per i file caricati. Per i video di riferimento, mantenere la durata complessiva tra 2 e 15 secondi e la dimensione totale al di sotto di 50 MB. Usare una risoluzione video di riferimento compresa approssimativamente tra 480p (640x640) e 720p (834x1112). Per l’audio di riferimento, mantenere la durata complessiva a un massimo di 15 secondi e ciascun file a un massimo di 15 MB. I file multimediali caricati devono inoltre rispettare i limiti di caricamento per file indicati sopra.

Inviare un URL di video di riferimento

Usare il video di riferimento per guidare il movimento della telecamera e l’azione:

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'

Associare un URL di immagine all’audio

Animare il soggetto di riferimento al ritmo dell’audio di riferimento:

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'

Caricare file multimediali di riferimento con Seedance 2.5

Caricare due immagini, un video MP4 e un file audio MP3 in un’unica richiesta:

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'

Durata per modello

Imposta seconds su un valore intero nell’intervallo supportato dal modello. Se lo ometti, CometAPI richiede una clip di 5 secondi.

Famiglia di modelli	Supportato `seconds`	Predefinito	Comportamento ai limiti
Seedance 2.5	`4`-`30`	`5`	Usa secondi interi nell’intervallo.
Seedance 2.0, Seedance 2.0 Fast e Seedance 2.0 Mini	`4`-`15`	`5`	Usa secondi interi nell’intervallo.
Seedance 1.5 Pro	`4`-`12`	`5`	Usa secondi interi nell’intervallo.
Seedance 1.0 Pro	`2`-`10`	`5`	Usa secondi interi nell’intervallo.

Supporto delle dimensioni per modello

Seedance 2.5

Per Seedance 2.5, questi valori di WxH si applicano sia ai prompt di testo sia ai media di riferimento.

Classe di risoluzione	`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`

Modelli Seedance precedenti

La colonna finale raggruppa i valori esatti di WxH per Seedance 1.5 Pro, Seedance 2.0 standard e Fast. Seedance 2.0 Fast utilizza solo i valori 480p e 720p in quella colonna. I valori 1080p in quella colonna si applicano a Seedance 1.5 Pro e Seedance 2.0 standard. I valori 4K si applicano solo a Seedance 2.0 standard. Nella colonna Mini, — indica che la risoluzione non è supportata.

Classe di risoluzione	Rapporto d’aspetto	Seedance 2.0 Mini	Serie Seedance 1.0	Seedance 1.5 Pro / Seedance 2.0 standard / 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` (Solo Seedance 2.0)
	`4:3`	—	—	`3326x2494` (Solo Seedance 2.0)
	`1:1`	—	—	`2880x2880` (Solo Seedance 2.0)
	`3:4`	—	—	`2494x3326` (Solo Seedance 2.0)
	`9:16`	—	—	`2160x3840` (Solo Seedance 2.0)
	`21:9`	—	—	`4398x1886` (Solo Seedance 2.0)

Seedance 2.0 Mini supporta 480p e 720p. Imposta size su un valore WxH dalla colonna Mini.

Autorizzazioni

Authorization

string

header

obbligatorio

Bearer token authentication. Use your CometAPI key.

Corpo

multipart/form-data

prompt

string

obbligatorio

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.

Esempio:

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

model

enum<string>

obbligatorio

Seedance model ID. Use one of the exact values below. Aliases such as seedance-mini are not accepted.

Opzioni disponibili:

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

Esempio:

"doubao-seedance-2-0-mini"

seconds

integer

predefinito: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.

Intervallo richiesto: 2 <= x <= 30

Esempio:

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}$

Esempi:

"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://

Esempio:

"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://

Esempio:

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

Risposta

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

string

obbligatorio

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

object

string

obbligatorio

Object type, always video.

model

string

obbligatorio

Echo of the requested model id.

status

enum<string>

obbligatorio

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

Opzioni disponibili:

queued,

in_progress,

completed,

failed,

error

progress

integer

obbligatorio

Completion percentage. 0 at creation.

Intervallo richiesto: 0 <= x <= 100

created_at

integer

obbligatorio

Task creation time as a Unix timestamp in seconds.

task_id

string

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

Ultima modifica il 9 settembre 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
}

Moderazione dei contenuti

Chiavi API

ID modello supportati

Utilizzare immagini di riferimento

Inviare URL di immagini di riferimento

Usare video e audio di riferimento

Inviare un URL di video di riferimento

Associare un URL di immagine all’audio

Caricare file multimediali di riferimento con Seedance 2.5

Durata per modello

Supporto delle dimensioni per modello

Seedance 2.5

Modelli Seedance precedenti

Autorizzazioni

Corpo

Risposta

​ID modello supportati

​Utilizzare immagini di riferimento

​Inviare URL di immagini di riferimento

​Usare video e audio di riferimento

​Inviare un URL di video di riferimento

​Associare un URL di immagine all’audio

​Caricare file multimediali di riferimento con Seedance 2.5

​Durata per modello

​Supporto delle dimensioni per modello

​Seedance 2.5

​Modelli Seedance precedenti

Autorizzazioni

Corpo

Risposta

ID modello supportati

Utilizzare immagini di riferimento

Inviare URL di immagini di riferimento

Usare video e audio di riferimento

Inviare un URL di video di riferimento

Associare un URL di immagine all’audio

Caricare file multimediali di riferimento con Seedance 2.5

Durata per modello

Supporto delle dimensioni per modello

Seedance 2.5

Modelli Seedance precedenti