Utwórz wideo 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
}

Wybierz udokumentowaną wartość WxH z poniższej tabeli dla pola size.

Użyj dokładnie doubao-seedance-2-0-mini dla Seedance 2.0 Mini. Skrócona wartość seedance-mini nie jest prawidłowym identyfikatorem modelu.

Obsługiwane identyfikatory modeli

Użyj jednej z tych dokładnych wartości w polu model.

Model	Dokładny identyfikator modelu	Tryby i poziomy rozdzielczości	Obsługiwane `seconds`
Seedance 2.0	`doubao-seedance-2-0`	Tekst-do-wideo, obraz-do-wideo; `480p`, `720p`, `1080p`, `4K`	`4`-`15`
Seedance 2.0 Fast	`doubao-seedance-2-0-fast`	Tekst-do-wideo, obraz-do-wideo; `480p`, `720p`	`4`-`15`
Seedance 2.0 Mini	`doubao-seedance-2-0-mini`	Tekst-do-wideo, obraz-do-wideo; `480p`, `720p`	`4`-`15`
Seedance 1.5 Pro	`doubao-seedance-1-5-pro`	Tekst-do-wideo; `480p`, `720p`, `1080p`	`4`-`12`
Seedance 1.0 Pro	`doubao-seedance-1-0-pro`	Tekst-do-wideo; `480p`, `720p`, `1080p`	`2`-`10`

Używanie obrazów referencyjnych

Seedance 2.0, Seedance 2.0 Fast i Seedance 2.0 Mini obsługują input_reference. W przypadku zaawansowanych Prompt z wieloma referencjami na trasie, która je obsługuje, powtarzaj to samo pole wieloczęściowe w kolejności przesyłania. Jedno produkcyjne żądanie Mini z pojedynczym input_reference zostało ukończone o 720x1280. Ten test potwierdził ukończenie żądania, ale nie wyodrębnił wizualnego wpływu obrazu referencyjnego od wpływu Prompt. Seedance 2.0 jest wrażliwy na sposób, w jaki Prompt łączy każdy obraz referencyjny ze sceną. Odwołuj się do przesłanych plików według kolejności, na przykład [Image 1], [Image 2] i [Image 3], a następnie przypisz każdemu obrazowi wyraźną rolę:

Użyj [Image 1] dla głównego obiektu, postaci lub produktu.
Użyj [Image 2] dla drugorzędnego obiektu, rekwizytu lub towarzysza.
Użyj [Image 3] dla tła, otoczenia, oświetlenia lub stylu.

Opisz, co powinno pozostać rozpoznawalne, co może się zmienić, akcję, ruch kamery, styl wizualny i scenę. Nieprecyzyjny Prompt może sprawić, że wygenerowane wideo będzie wyglądać tak, jakby obraz referencyjny nie został użyty, nawet jeśli przesłanie zostało zaakceptowane. Ta struktura Prompt jest bardziej niezawodna niż samo wymienienie obrazów:

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.

Czas trwania według modelu

Jeśli pominiesz seconds, CometAPI zażąda 5-sekundowego klipu. Wyślij seconds jako ciąg znaków, gdy potrzebujesz określonego czasu trwania.

Rodzina modeli	Obsługiwane `seconds`	Domyślna	Zachowanie na granicach
Seedance 2.0, Seedance 2.0 Fast i Seedance 2.0 Mini	`4`-`15`	`5`	Używaj całkowitej liczby sekund z zakresu.
Seedance 1.5 Pro	`4`-`12`	`5`	Używaj całkowitej liczby sekund z zakresu.
Seedance 1.0 Pro	`2`-`10`	`5`	Używaj całkowitej liczby sekund z zakresu.

Obsługiwane rozmiary według modelu

Poniższa tabela zawiera dokładne wartości WxH w jednym miejscu. Seedance 2.0 Fast obsługuje tylko wartości 480p i 720p w piątej kolumnie. Wartości 1080p w tej kolumnie dotyczą Seedance 1.5 Pro i standardowego Seedance 2.0. Wartości 4K dotyczą wyłącznie standardowego Seedance 2.0. W kolumnie Mini wartość — oznacza, że rozdzielczość nie jest obsługiwana.

Klasa rozdzielczości	Proporcje obrazu	Seedance 2.0 Mini	Seria Seedance 1.0	Seedance 1.5 Pro / standardowy 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` (tylko Seedance 2.0)
	`4:3`	—	—	`3326x2494` (tylko Seedance 2.0)
	`1:1`	—	—	`2880x2880` (tylko Seedance 2.0)
	`3:4`	—	—	`2494x3326` (tylko Seedance 2.0)
	`9:16`	—	—	`2160x3840` (tylko Seedance 2.0)
	`21:9`	—	—	`4398x1886` (tylko Seedance 2.0)

Seedance 2.0 Mini obsługuje 480p i 720p, ale nie 1080p ani 4K. W jednym teście produkcyjnym żądanie Mini dla 1920x1080 wygenerowało 1280x720.

Wybierz udokumentowaną wartość WxH dla docelowego modelu. Dokładna obsługa WxH nadal zależy od modelu, dlatego sprawdź gotowe materiały multimedialne, zanim użyjesz nieudokumentowanego rozmiaru.

Autoryzacje

Authorization

string

header

wymagane

Bearer token authentication. Use your CometAPI key.

Treść

multipart/form-data

prompt

string

wymagane

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.

Przykład:

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

model

enum<string>

wymagane

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

Dostępne opcje:

doubao-seedance-2-0,

doubao-seedance-2-0-fast,

doubao-seedance-2-0-mini,

doubao-seedance-1-5-pro,

doubao-seedance-1-0-pro

Przykład:

"doubao-seedance-2-0-mini"

seconds

integer

domyślnie: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.

Wymagany zakres: 2 <= x <= 15

Przykład:

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

Przykłady:

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

Odpowiedź

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

string

wymagane

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

object

string

wymagane

Object type, always video.

model

string

wymagane

Echo of the requested model id.

status

enum<string>

wymagane

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

Dostępne opcje:

queued,

in_progress,

completed,

failed,

error

progress

integer

wymagane

Completion percentage. 0 at creation.

Wymagany zakres: 0 <= x <= 100

created_at

integer

wymagane

Task creation time as a Unix timestamp in seconds.

task_id

string

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

API do generowania wideo

Poprzedni

Pobierz wideo Seedance

Następny

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
}

Moderacja treści

Klucze API

Obsługiwane identyfikatory modeli

Używanie obrazów referencyjnych

Czas trwania według modelu

Obsługiwane rozmiary według modelu

Autoryzacje

Treść

Odpowiedź

​Obsługiwane identyfikatory modeli

​Używanie obrazów referencyjnych

​Czas trwania według modelu

​Obsługiwane rozmiary według modelu

Autoryzacje

Treść

Odpowiedź

Obsługiwane identyfikatory modeli

Używanie obrazów referencyjnych

Czas trwania według modelu

Obsługiwane rozmiary według modelu