Crea un video Seedance

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'prompt="A matte red cube rotates slowly on a clean white studio floor. The camera remains fixed. Soft daylight and a short shadow."' \
  -F 'model="doubao-seedance-2-0-mini"' \
  -F 'seconds="15"' \
  -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
}

Scegli un valore WxH documentato dalla tabella seguente per il campo size.

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

ID modello supportati

Usa uno di questi valori esatti per il campo model.

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

Usa immagini di riferimento

Seedance 2.0, Seedance 2.0 Fast e Seedance 2.0 Mini accettano input_reference. Per Prompt avanzati con più riferimenti su una route che li supporta, ripeti lo stesso campo multipart nell’ordine di caricamento. Una richiesta di produzione Mini con un singolo input_reference è stata completata in 720x1280. Tale verifica ha confermato il completamento della richiesta, ma non ha isolato l’effetto visivo dell’immagine di riferimento dal Prompt. dell’immagine di riferimento dal Prompt. Seedance 2.0 è sensibile al modo in cui il Prompt collega ogni immagine di riferimento alla scena. Fai riferimento ai file caricati in base all’ordine, ad esempio [Image 1], [Image 2] e [Image 3], quindi assegna a ogni immagine un ruolo chiaro:

Usa [Image 1] per il soggetto principale, il personaggio o il prodotto.
Usa [Image 2] per un soggetto secondario, un oggetto di scena o un accompagnatore.
Usa [Image 3] per lo sfondo, l’ambientazione, l’illuminazione o lo stile.

Descrivi cosa deve restare riconoscibile, cosa può cambiare, l’azione, il movimento della telecamera, lo stile visivo e la scena. Un Prompt vago può far sembrare che il video generato non abbia usato l’immagine di riferimento, anche quando il caricamento è stato accettato. Questa struttura del Prompt è più affidabile del semplice elenco di immagini:

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.

Durata per modello

Se ometti seconds, CometAPI richiede una clip di 5 secondi. Invia seconds come stringa quando ti serve una durata specifica.

Famiglia di modelli	Supportato `seconds`	Predefinito	Comportamento ai limiti
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

La tabella seguente riunisce in un unico punto gli esatti valori WxH. Seedance 2.0 Fast utilizza solo i valori 480p e 720p nella quinta colonna. I valori 1080p in quella colonna si applicano a Seedance 1.5 Pro e a 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, non 1080p o 4K. In una verifica in produzione, una richiesta Mini per 1920x1080 ha prodotto 1280x720.

Scegli il valore WxH documentato per il modello di destinazione. Il supporto esatto di WxH resta dipendente dal modello, quindi controlla il contenuto multimediale completato prima di fare affidamento su una dimensione non documentata.

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

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:

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.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 <= 15

Esempio:

5

size

string

Output size as an exact WxH value. For Seedance 2.0 Mini, use 864x496, 752x560, 640x640, 560x752, 496x864, or 992x432 for 480p; use 1280x720, 1112x834, 960x960, 834x1112, 720x1280, or 1470x630 for 720p. Mini does not support 1080p or 4K. A Mini request for 1920x1080 produced 1280x720 in one production check. 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:

"864x496"

"752x560"

"640x640"

"560x752"

"496x864"

"992x432"

"1280x720"

"1112x834"

"960x960"

"834x1112"

"720x1280"

"1470x630"

"1920x1080"

"1080x1920"

"3840x2160"

"3326x2494"

"2880x2880"

"2494x3326"

"2160x3840"

"4398x1886"

input_reference

file

Optional reference image uploaded as a multipart file. Seedance 2.0, Seedance 2.0 Fast, and Seedance 2.0 Mini accept this field. On routes that support multiple reference images, repeat the field and reference the files in upload order as [Image 1], [Image 2], and so on. Seedance 1.0 Pro and 1.5 Pro do not accept it.

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.

API di generazione video

Recuperare un video Seedance

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'prompt="A matte red cube rotates slowly on a clean white studio floor. The camera remains fixed. Soft daylight and a short shadow."' \
  -F 'model="doubao-seedance-2-0-mini"' \
  -F 'seconds="15"' \
  -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

Usa immagini di riferimento

Durata per modello

Supporto delle dimensioni per modello

Autorizzazioni

Corpo

Risposta

​ID modello supportati

​Usa immagini di riferimento

​Durata per modello

​Supporto delle dimensioni per modello

Autorizzazioni

Corpo

Risposta

ID modello supportati

Usa immagini di riferimento

Durata per modello

Supporto delle dimensioni per modello