Een Seedance-video maken

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
}

Stel size in op een WxH-waarde uit de groottetabel voor je model.

Gebruik doubao-seedance-2-0-mini exact voor Seedance 2.0 Mini. De verkorte waarde seedance-mini is geen geldige model-ID.

Ondersteunde model-ID’s

Kies een model voor je invoermodus en resolutie en verzend vervolgens de exacte ID ervan in het veld model.

Model	Exacte model-ID	Modi en resolutieniveaus	Ondersteund `seconds`
Seedance 2.5	`seedance-2-5`	Tekst-naar-video, referentiemedia; `480p`, `720p`	`4`-`30`
Seedance 2.0	`doubao-seedance-2-0`	Tekst-naar-video, referentiemedia; `480p`, `720p`, `1080p`, `4K`	`4`-`15`
Seedance 2.0 Fast	`doubao-seedance-2-0-fast`	Tekst-naar-video, referentiemedia; `480p`, `720p`	`4`-`15`
Seedance 2.0 Mini	`doubao-seedance-2-0-mini`	Tekst-naar-video, referentiemedia; `480p`, `720p`	`4`-`15`
Seedance 1.5 Pro	`doubao-seedance-1-5-pro`	Tekst-naar-video, afbeelding-naar-video; `480p`, `720p`, `1080p`	`4`-`12`
Seedance 1.0 Pro	`doubao-seedance-1-0-pro`	Tekst-naar-video, afbeelding-naar-video; `480p`, `720p`, `1080p`	`2`-`10`

Referentieafbeeldingen gebruiken

Verzend POST /v1/videos als multipart/form-data, met referentieafbeeldingen in input_reference. Herhaal bij meerdere afbeeldingen het veld in afbeeldingsvolgorde, met per veld één openbaar toegankelijke HTTPS-afbeeldings-URL of één geüpload afbeeldingsbestand. Gebruik binnen dit veld alleen URL’s of alleen bestanden. Verzend elke URL afzonderlijk in plaats van URL’s met komma’s samen te voegen. Houd elke geüploade afbeelding op of onder 20 MiB (20 × 1024 × 1024 bytes). Seedance 1.0 Pro en 1.5 Pro gebruiken één referentieafbeelding. Seedance 2.0, Fast en Mini accepteren maximaal 9 referentieafbeeldingen. Seedance 2.5 accepteert maximaal 30 referentieafbeeldingen. Deze aantallen gelden voor zowel URL’s als geüploade bestanden. Wijs in de prompt elke afbeelding een rol toe, zoals het onderwerp, de omgeving of de visuele stijl. Beschrijf het uiterlijk dat behouden moet blijven, de actie en de camerabeweging. De aanvraagvoorbeelden bovenaan deze pagina tonen invoer van afbeeldings-URL’s en uploads van één of meerdere afbeeldingen.

URL’s van referentieafbeeldingen verzenden

Gebruik twee afbeeldings-URL’s om het uiterlijk van het onderwerp en de omgeving te sturen:

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'

Referentievideo en -audio gebruiken

Seedance 2.0, Fast, Mini en 2.5 accepteren reference_videos en reference_audios. Gebruik MP4-bestanden voor videoreferenties en MP3-bestanden voor audioreferenties. Verzend elk bestand als een openbaar toegankelijke HTTPS-URL of als een geüpload bestand. Koppel referentieaudio aan ten minste één afbeelding of video. Gebruik in de prompt @Image1, @Video1 en @Audio1 om rollen aan je referenties toe te wijzen. Nummer referenties op basis van hun volgorde binnen elk mediatype. Je kunt URL’s en uploads in verschillende velden combineren. Gebruik binnen elk van input_reference, reference_videos en reference_audios uitsluitend URL’s of uitsluitend bestanden. Herhaal bij meerdere invoeren het veld één keer per invoer in plaats van URL’s met komma’s te combineren.

Modelfamilie	Referentieafbeeldingen	Referentievideo’s	Referentieaudio	Totaal aantal referentie-invoeren
Seedance 2.0, Fast en Mini	Maximaal 9 URL’s of bestanden in `input_reference`	Maximaal 3	Maximaal 3	Maximaal 12
Seedance 2.5	Maximaal 30 URL’s of bestanden in `input_reference`	Maximaal 10 URL’s of 5 bestanden	Maximaal 10 URL’s of 5 bestanden	Maximaal 50

Houd elke geüploade video op of onder 50 MiB en elk geüpload audiobestand op of onder 15 MiB. Eén MiB is 1024 × 1024 bytes. Standaard Seedance 2.0 (doubao-seedance-2-0) heeft aanvullende medialimieten voor zowel URL’s als geüploade bestanden. Houd voor referentievideo’s de gecombineerde duur tussen 2 en 15 seconden en de totale grootte onder 50 MB. Gebruik voor referentievideo’s een resolutie van ongeveer 480p (640x640) tot 720p (834x1112)). Houd voor referentieaudio de gecombineerde duur op of onder 15 seconden en elk bestand op of onder 15 MB. Geüploade media moeten ook voldoen aan de bovenstaande uploadlimieten per bestand.

Een referentievideo-URL verzenden

Gebruik de referentievideo om de camerabeweging en actie te sturen:

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'

Een afbeeldings-URL koppelen aan audio

Animeer het referentieonderwerp op het ritme van de referentieaudio:

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'

Referentiemedia uploaden met Seedance 2.5

Upload twee afbeeldingen, een MP4-video en een MP3-audiobestand in één aanvraag:

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'

Duur per model

Stel seconds in op een gehele waarde binnen het bereik van je model. Als je deze weglaat, vraagt CometAPI een clip van 5 seconden aan.

Modelfamilie	Ondersteund `seconds`	Standaard	Gedrag bij grenswaarden
Seedance 2.5	`4`-`30`	`5`	Gebruik gehele seconden binnen het bereik.
Seedance 2.0, Seedance 2.0 Fast en Seedance 2.0 Mini	`4`-`15`	`5`	Gebruik gehele seconden binnen het bereik.
Seedance 1.5 Pro	`4`-`12`	`5`	Gebruik gehele seconden binnen het bereik.
Seedance 1.0 Pro	`2`-`10`	`5`	Gebruik gehele seconden binnen het bereik.

Formaatondersteuning per model

Seedance 2.5

Voor Seedance 2.5 gelden deze WxH-waarden zowel voor tekstprompts als voor referentiemedia.

Resolutieklasse	`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`

Eerdere Seedance-modellen

De laatste kolom groepeert exacte WxH-waarden voor Seedance 1.5 Pro, standaard Seedance 2.0 en Fast. Seedance 2.0 Fast gebruikt alleen de waarden 480p en 720p in die kolom. De 1080p-waarden in die kolom gelden voor Seedance 1.5 Pro en standaard Seedance 2.0. De 4K-waarden gelden alleen voor standaard Seedance 2.0. In de Mini-kolom betekent — dat de resolutie niet wordt ondersteund.

Resolutieklasse	Beeldverhouding	Seedance 2.0 Mini	Seedance 1.0-serie	Seedance 1.5 Pro / standaard 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` (Alleen Seedance 2.0)
	`4:3`	—	—	`3326x2494` (Alleen Seedance 2.0)
	`1:1`	—	—	`2880x2880` (Alleen Seedance 2.0)
	`3:4`	—	—	`2494x3326` (Alleen Seedance 2.0)
	`9:16`	—	—	`2160x3840` (Alleen Seedance 2.0)
	`21:9`	—	—	`4398x1886` (Alleen Seedance 2.0)

Seedance 2.0 Mini ondersteunt 480p en 720p. Stel size in op een WxH-waarde uit de Mini-kolom.

Autorisaties

Authorization

string

header

vereist

Bearer token authentication. Use your CometAPI key.

Body

multipart/form-data

prompt

string

vereist

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.

Voorbeeld:

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

model

enum<string>

vereist

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

Beschikbare opties:

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

Voorbeeld:

"doubao-seedance-2-0-mini"

seconds

integer

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

Vereist bereik: 2 <= x <= 30

Voorbeeld:

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

Voorbeelden:

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

Voorbeeld:

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

Voorbeeld:

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

Respons

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

string

vereist

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

object

string

vereist

Object type, always video.

model

string

vereist

Echo of the requested model id.

status

enum<string>

vereist

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

Beschikbare opties:

queued,

in_progress,

completed,

failed,

error

progress

integer

vereist

Completion percentage. 0 at creation.

Vereist bereik: 0 <= x <= 100

created_at

integer

vereist

Task creation time as a Unix timestamp in seconds.

task_id

string

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

Laatst gewijzigd op 9 september 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
}

Contentmoderatie

API-sleutels

Ondersteunde model-ID’s

Referentieafbeeldingen gebruiken

URL’s van referentieafbeeldingen verzenden

Referentievideo en -audio gebruiken

Een referentievideo-URL verzenden

Een afbeeldings-URL koppelen aan audio

Referentiemedia uploaden met Seedance 2.5

Duur per model

Formaatondersteuning per model

Seedance 2.5

Eerdere Seedance-modellen

Autorisaties

Body

Respons

​Ondersteunde model-ID’s

​Referentieafbeeldingen gebruiken

​URL’s van referentieafbeeldingen verzenden

​Referentievideo en -audio gebruiken

​Een referentievideo-URL verzenden

​Een afbeeldings-URL koppelen aan audio

​Referentiemedia uploaden met Seedance 2.5

​Duur per model

​Formaatondersteuning per model

​Seedance 2.5

​Eerdere Seedance-modellen

Autorisaties

Body

Respons

Ondersteunde model-ID’s

Referentieafbeeldingen gebruiken

URL’s van referentieafbeeldingen verzenden

Referentievideo en -audio gebruiken

Een referentievideo-URL verzenden

Een afbeeldings-URL koppelen aan audio

Referentiemedia uploaden met Seedance 2.5

Duur per model

Formaatondersteuning per model

Seedance 2.5

Eerdere Seedance-modellen