Ein Seedance-Video erstellen

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'prompt="A slow cinematic camera push across a coastal landscape at sunrise"' \
  -F 'model="doubao-seedance-2-0"' \
  -F 'seconds="4"' \
  -F 'size="3840x2160"'

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

Wählen Sie aus der folgenden Tabelle einen dokumentierten WxH-Wert für das Feld size aus.

Referenzbilder verwenden

Nur die Seedance-2.0-Modelle akzeptieren input_reference. Fügen Sie eine input_reference-Datei für bildgestützte Generierung hinzu. Wiederholen Sie für erweiterte Prompts mit mehreren Referenzen dasselbe Multipart-Feld in der Upload-Reihenfolge. Seedance 2.0 reagiert empfindlich darauf, wie der Prompt jedes Referenzbild mit der Szene verknüpft. Verweisen Sie in der Reihenfolge auf die hochgeladenen Dateien, etwa [Image 1], [Image 2] und [Image 3], und weisen Sie jedem Bild eine klare Rolle zu:

Verwenden Sie [Image 1] für das Hauptmotiv, die Hauptfigur oder das Hauptprodukt.
Verwenden Sie [Image 2] für ein sekundäres Motiv, eine Requisite oder einen Begleiter.
Verwenden Sie [Image 3] für den Hintergrund, die Umgebung, die Beleuchtung oder den Stil.

Beschreiben Sie, was erkennbar bleiben soll, was sich ändern kann, die Handlung, die Kamerabewegung, den visuellen Stil und die Szene. Ein vager Prompt kann dazu führen, dass das generierte Video so aussieht, als wäre das Referenzbild nicht verwendet worden, selbst wenn der Upload akzeptiert wurde. Diese Prompt-Struktur ist zuverlässiger, als nur Bilder aufzulisten:

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.

Dauer nach Modell

Wenn Sie seconds weglassen, fordert CometAPI einen 5-sekündigen Clip an. Senden Sie seconds als String, wenn Sie eine bestimmte Dauer benötigen.

Modellfamilie	Unterstützt `seconds`	Standard	Grenzverhalten
Seedance 2.0 und Seedance 2.0 Fast	`4`-`15`	`5`	Verwenden Sie ganzzahlige Sekunden innerhalb dieses Bereichs.
Seedance 1.5 Pro	`4`-`12`	`5`	Verwenden Sie ganzzahlige Sekunden innerhalb dieses Bereichs.
Seedance 1.0 Pro	`2`-`10`	`5`	Verwenden Sie ganzzahlige Sekunden innerhalb dieses Bereichs。

Größenunterstützung nach Modell

Die folgende Tabelle folgt der offiziellen Seedance-Auflösungszuordnung und fasst die veröffentlichten Größenwerte an einer Stelle zusammen. Für 1080p enthält die Spalte ganz rechts die dokumentierten Werte für Seedance 1.5 Pro und Seedance 2.0. Seedance 2.0 Fast ist in dieser offiziellen Tabelle für 1080p nicht aufgeführt. Die Einträge für 4K gelten nur für doubao-seedance-2-0. Sie können sie für Text-zu-Video- oder Bild-zu-Video-Anfragen verwenden, die input_reference enthalten. Sie gelten nicht für doubao-seedance-2-0-fast. Übergeben Sie den genau in der Tabelle angegebenen Wert für WxH.

Auflösungsklasse	Seitenverhältnis	Pixelwerte für die Seedance-1.0-Serie	Pixelwerte für Seedance 1.5 Pro / Seedance 2.0 / Seedance 2.0 Fast
`480p`	`16:9`	`864x480`	`864x496`
	`4:3`	`736x544`	`752x560`
	`1:1`	`640x640`	`640x640`
	`3:4`	`544x736`	`560x752`
	`9:16`	`480x864`	`496x864`
	`21:9`	`960x416`	`992x432`
`720p`	`16:9`	`1248x704`	`1280x720`
	`4:3`	`1120x832`	`1112x834`
	`1:1`	`960x960`	`960x960`
	`3:4`	`832x1120`	`834x1112`
	`9:16`	`704x1248`	`720x1280`
	`21:9`	`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` (Nur Seedance 2.0)
	`4:3`	—	`3326x2494` (Nur Seedance 2.0)
	`1:1`	—	`2880x2880` (Nur Seedance 2.0)
	`3:4`	—	`2494x3326` (Nur Seedance 2.0)
	`9:16`	—	`2160x3840` (Nur Seedance 2.0)
	`21:9`	—	`4398x1886` (Nur Seedance 2.0)

Wählen Sie für das Zielmodell den dokumentierten Wert WxH. Die Unterstützung exakter WxH-Werte bleibt modellabhängig. Prüfen Sie daher die fertiggestellten Medien, bevor Sie sich auf eine nicht dokumentierte Größe verlassen.

Autorisierungen

Authorization

string

header

erforderlich

Bearer token authentication. Use your CometAPI key.

Body

multipart/form-data

prompt

string

erforderlich

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.

Beispiel:

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

model

enum<string>

erforderlich

Seedance model id. Only the two 2.0 models accept input_reference.

Verfügbare Optionen:

doubao-seedance-2-0,

doubao-seedance-2-0-fast,

doubao-seedance-1-5-pro,

doubao-seedance-1-0-pro

Beispiel:

"doubao-seedance-2-0"

seconds

integer

Standard:5

Video duration in seconds. The accepted range depends on the model: doubao-seedance-2-0 and doubao-seedance-2-0-fast accept 4 to 15, doubao-seedance-1-5-pro accepts 4 to 12, and doubao-seedance-1-0-pro accepts 2 to 10. The default is 5 for every model.

Erforderlicher Bereich: 2 <= x <= 15

Beispiel:

5

size

string

Output size as an exact WxH value, such as 1280x720. For doubao-seedance-2-0 4K output, use 3840x2160, 3326x2494, 2880x2880, 2494x3326, 2160x3840, or 4398x1886. These 4K values work for text-to-video and requests with input_reference, but they do not apply to doubao-seedance-2-0-fast. Exact WxH support remains model-dependent, and an undocumented value can normalize to another size or fail.

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

Beispiele:

"1280x720"

"1920x1080"

"3840x2160"

"3326x2494"

"2880x2880"

"2494x3326"

"2160x3840"

"4398x1886"

"1112x834"

"960x960"

"834x1112"

"720x1280"

"1080x1920"

"1470x630"

input_reference

file

Optional reference image uploaded as a multipart file. Repeat this field to send multiple reference images; the order of repeated fields is the order you should reference in the prompt as [Image 1], [Image 2], and so on. Use JPEG or PNG files for best compatibility. Only doubao-seedance-2-0 and doubao-seedance-2-0-fast accept this field; sending it with a 1.0 Pro or 1.5 Pro model returns HTTP 400.

Antwort

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

string

erforderlich

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

object

string

erforderlich

Object type, always video.

model

string

erforderlich

Echo of the requested model id.

status

enum<string>

erforderlich

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

Verfügbare Optionen:

queued,

in_progress,

completed,

failed,

error

progress

integer

erforderlich

Completion percentage. 0 at creation.

Erforderlicher Bereich: 0 <= x <= 100

created_at

integer

erforderlich

Task creation time as a Unix timestamp in seconds.

task_id

string

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

Video generation APIs

Zurück

Ein Seedance-Video abrufen

Weiter

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'prompt="A slow cinematic camera push across a coastal landscape at sunrise"' \
  -F 'model="doubao-seedance-2-0"' \
  -F 'seconds="4"' \
  -F 'size="3840x2160"'

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

Inhaltsmoderation

API-Schlüssel

Referenzbilder verwenden

Dauer nach Modell

Größenunterstützung nach Modell

Autorisierungen

Body

Antwort

​Referenzbilder verwenden

​Dauer nach Modell

​Größenunterstützung nach Modell

Autorisierungen

Body

Antwort

Referenzbilder verwenden

Dauer nach Modell

Größenunterstützung nach Modell