Een Seedance-video maken

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
}

Kies een gedocumenteerde waarde van WxH uit de onderstaande tabel voor het veld size.

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

Ondersteunde model-ID’s

Gebruik een van deze exacte waarden voor het veld model.

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

Referentieafbeeldingen gebruiken

Seedance 2.0, Seedance 2.0 Fast en Seedance 2.0 Mini accepteren input_reference. Voor geavanceerde prompts met meerdere referenties op een route die deze ondersteunt, herhaal je hetzelfde multipart-veld in de uploadvolgorde. Eén Mini-productieaanvraag met één enkele input_reference werd voltooid op 720x1280. Die controle bevestigde dat de aanvraag was voltooid, maar zonder het visuele effect van de referentieafbeelding los van de prompt te isoleren. Seedance 2.0 is gevoelig voor de manier waarop de prompt elke referentieafbeelding met de scène verbindt. Verwijs naar de geüploade bestanden op volgorde, zoals [Image 1], [Image 2] en [Image 3], en geef elke afbeelding vervolgens een duidelijke rol:

Gebruik [Image 1] voor het hoofdonderwerp, personage of product.
Gebruik [Image 2] voor een secundair onderwerp, rekwisiet of begeleider.
Gebruik [Image 3] voor de achtergrond, omgeving, belichting of stijl.

Beschrijf wat herkenbaar moet blijven, wat mag veranderen, de actie, camerabeweging, visuele stijl en scène. Een vage prompt kan ervoor zorgen dat de gegenereerde video eruitziet alsof de referentieafbeelding niet is gebruikt, zelfs wanneer de upload is geaccepteerd. Deze promptstructuur is betrouwbaarder dan alleen afbeeldingen opsommen:

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.

Duur per model

Als je seconds weglaat, vraagt CometAPI een clip van 5 seconden aan. Verstuur seconds als een tekenreeks wanneer je een specifieke duur nodig hebt.

Modelfamilie	Ondersteund `seconds`	Standaard	Gedrag bij grenzen
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.

Ondersteuning voor formaten per model

De onderstaande tabel bevat de exacte waarden van WxH op één plek. Seedance 2.0 Fast gebruikt alleen de waarden 480p en 720p in de vijfde kolom. De waarden 1080p in die kolom gelden voor Seedance 1.5 Pro en standaard Seedance 2.0. De waarden 4K 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, niet 1080p of 4K. Bij een productiecontrole leverde een Mini-aanvraag voor 1920x1080 het volgende op 1280x720.

Kies de gedocumenteerde waarde WxH voor het doelmodel. Exacte ondersteuning voor WxH blijft modelafhankelijk, dus controleer de voltooide media voordat je vertrouwt op een niet-gedocumenteerd formaat.

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

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:

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

Voorbeeld:

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

Voorbeelden:

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

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.

Video generation API's

Een Seedance-video ophalen

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
}

Contentmoderatie

API-sleutels

Ondersteunde model-ID’s

Referentieafbeeldingen gebruiken

Duur per model

Ondersteuning voor formaten per model

Autorisaties

Body

Respons

​Ondersteunde model-ID’s

​Referentieafbeeldingen gebruiken

​Duur per model

​Ondersteuning voor formaten per model

Autorisaties

Body

Respons

Ondersteunde model-ID’s

Referentieafbeeldingen gebruiken

Duur per model

Ondersteuning voor formaten per model