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

Pilih nilai WxH yang didokumentasikan dari tabel di bawah untuk field size.

Gunakan doubao-seedance-2-0-mini persis untuk Seedance 2.0 Mini. Nilai seedance-mini yang disingkat bukan ID model yang valid.

ID model yang didukung

Gunakan salah satu nilai persis ini untuk field model.

Model	ID model persis	Mode dan tingkatan resolusi	Didukung `seconds`
Seedance 2.0	`doubao-seedance-2-0`	Teks-ke-video, gambar-ke-video; `480p`, `720p`, `1080p`, `4K`	`4`-`15`
Seedance 2.0 Fast	`doubao-seedance-2-0-fast`	Teks-ke-video, gambar-ke-video; `480p`, `720p`	`4`-`15`
Seedance 2.0 Mini	`doubao-seedance-2-0-mini`	Teks-ke-video, gambar-ke-video; `480p`, `720p`	`4`-`15`
Seedance 1.5 Pro	`doubao-seedance-1-5-pro`	Teks-ke-video; `480p`, `720p`, `1080p`	`4`-`12`
Seedance 1.0 Pro	`doubao-seedance-1-0-pro`	Teks-ke-video; `480p`, `720p`, `1080p`	`2`-`10`

Gunakan gambar referensi

Seedance 2.0, Seedance 2.0 Fast, dan Seedance 2.0 Mini menerima input_reference. Untuk Prompt multi-referensi lanjutan pada rute yang mendukungnya, ulangi field multipart yang sama sesuai urutan upload. Satu permintaan produksi Mini dengan satu input_reference selesai pada 720x1280. Pemeriksaan tersebut mengonfirmasi penyelesaian permintaan, tetapi tidak mengisolasi efek visual gambar referensi dari Prompt. Seedance 2.0 peka terhadap cara Prompt menghubungkan setiap gambar referensi dengan adegan. Rujuk file yang diunggah berdasarkan urutannya, seperti [Image 1], [Image 2], dan [Image 3], lalu tetapkan peran yang jelas untuk setiap gambar:

Gunakan [Image 1] untuk subjek utama, karakter, atau produk.
Gunakan [Image 2] untuk subjek sekunder, properti, atau pendamping.
Gunakan [Image 3] untuk latar belakang, suasana, pencahayaan, atau gaya.

Jelaskan hal yang harus tetap dapat dikenali, hal yang dapat berubah, aksi, gerakan kamera, gaya visual, dan adegan. Prompt yang samar dapat membuat video yang dihasilkan tampak seperti gambar referensi tidak digunakan, bahkan ketika upload diterima. Struktur Prompt ini lebih andal daripada hanya mencantumkan gambar:

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.

Durasi berdasarkan model

Jika Anda menghilangkan seconds, CometAPI meminta klip 5 detik. Kirim seconds sebagai string ketika Anda membutuhkan durasi tertentu.

Keluarga model	Didukung `seconds`	Bawaan	Perilaku batas
Seedance 2.0, Seedance 2.0 Fast, dan Seedance 2.0 Mini	`4`-`15`	`5`	Gunakan detik bilangan bulat dalam rentang.
Seedance 1.5 Pro	`4`-`12`	`5`	Gunakan detik bilangan bulat dalam rentang.
Seedance 1.0 Pro	`2`-`10`	`5`	Gunakan detik bilangan bulat dalam rentang.

Dukungan ukuran menurut model

Tabel di bawah ini menghimpun nilai WxH yang tepat di satu tempat. Seedance 2.0 Fast hanya menggunakan nilai 480p dan 720p di kolom kelima. Nilai 1080p di kolom tersebut berlaku untuk Seedance 1.5 Pro dan Seedance 2.0 standar. Nilai 4K hanya berlaku untuk Seedance 2.0 standar. Di kolom Mini, — berarti resolusi tersebut tidak didukung.

Kelas resolusi	Rasio aspek	Seedance 2.0 Mini	Seri Seedance 1.0	Seedance 1.5 Pro / Seedance 2.0 standar / 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` (Hanya Seedance 2.0)
	`4:3`	—	—	`3326x2494` (Hanya Seedance 2.0)
	`1:1`	—	—	`2880x2880` (Hanya Seedance 2.0)
	`3:4`	—	—	`2494x3326` (Hanya Seedance 2.0)
	`9:16`	—	—	`2160x3840` (Hanya Seedance 2.0)
	`21:9`	—	—	`4398x1886` (Hanya Seedance 2.0)

Seedance 2.0 Mini mendukung 480p dan 720p, bukan 1080p maupun 4K. Dalam salah satu pemeriksaan produksi, permintaan Mini untuk 1920x1080 menghasilkan 1280x720.

Pilih nilai WxH yang terdokumentasi untuk model target. Dukungan WxH yang tepat tetap bergantung pada model, jadi periksa media yang telah selesai sebelum mengandalkan ukuran yang tidak terdokumentasi.

Otorisasi

Authorization

string

header

wajib

Bearer token authentication. Use your CometAPI key.

Body

multipart/form-data

prompt

string

wajib

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.

Contoh:

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

model

enum<string>

wajib

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

Opsi yang tersedia:

doubao-seedance-2-0,

doubao-seedance-2-0-fast,

doubao-seedance-2-0-mini,

doubao-seedance-1-5-pro,

doubao-seedance-1-0-pro

Contoh:

"doubao-seedance-2-0-mini"

seconds

integer

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

Rentang yang diperlukan: 2 <= x <= 15

Contoh:

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

Contoh:

"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

wajib

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

object

string

wajib

Object type, always video.

model

string

wajib

Echo of the requested model id.

status

enum<string>

wajib

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

Opsi yang tersedia:

queued,

in_progress,

completed,

failed,

error

progress

integer

wajib

Completion percentage. 0 at creation.

Rentang yang diperlukan: 0 <= x <= 100

created_at

integer

wajib

Task creation time as a Unix timestamp in seconds.

task_id

string

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

API pembuatan video

Sebelumnya

Mengambil video Seedance

Selanjutnya

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
}

Moderasi konten

Kunci API

ID model yang didukung

Gunakan gambar referensi

Durasi berdasarkan model

Dukungan ukuran menurut model

Otorisasi

Body

Respons

​ID model yang didukung

​Gunakan gambar referensi

​Durasi berdasarkan model

​Dukungan ukuran menurut model

Otorisasi

Body

Respons

ID model yang didukung

Gunakan gambar referensi

Durasi berdasarkan model

Dukungan ukuran menurut model