Bir Seedance videosu oluşturun

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
}

WxH değerini, size alanı için aşağıdaki tablodaki belgelenmiş değerler arasından seçin.

Seedance 2.0 Mini için doubao-seedance-2-0-mini değerini tam olarak kullanın. Kısaltılmış seedance-mini değeri geçerli bir model ID’si değildir.

Desteklenen model ID’leri

model alanı için bu tam değerlerden birini kullanın.

Model	Tam model ID’si	Modlar ve çözünürlük katmanları	Desteklenen `seconds`
Seedance 2.0	`doubao-seedance-2-0`	Metinden videoya, görüntüden videoya; `480p`, `720p`, `1080p`, `4K`	`4`-`15`
Seedance 2.0 Fast	`doubao-seedance-2-0-fast`	Metinden videoya, görüntüden videoya; `480p`, `720p`	`4`-`15`
Seedance 2.0 Mini	`doubao-seedance-2-0-mini`	Metinden videoya, görüntüden videoya; `480p`, `720p`	`4`-`15`
Seedance 1.5 Pro	`doubao-seedance-1-5-pro`	Metinden videoya; `480p`, `720p`, `1080p`	`4`-`12`
Seedance 1.0 Pro	`doubao-seedance-1-0-pro`	Metinden videoya; `480p`, `720p`, `1080p`	`2`-`10`

Referans görüntüleri kullanın

Seedance 2.0, Seedance 2.0 Fast ve Seedance 2.0 Mini şunları kabul eder input_reference. Bunları destekleyen bir route üzerindeki gelişmiş çoklu referans Prompt’ları için aynı multipart alanını yükleme sırasıyla yineleyin. bunları destekleyen bir route üzerinde aynı multipart alanını yükleme sırasıyla yineleyin. Tek bir input_reference içeren bir Mini üretim isteği şu sürede tamamlandı 720x1280. Bu kontrol, isteğin tamamlandığını doğruladı ancak referans görüntünün Prompt üzerindeki görsel etkisini ayrıştırmadı. Seedance 2.0, Prompt’un her referans görüntüyü sahneye nasıl bağladığına duyarlıdır. Yüklenen dosyalara [Image 1], [Image 2] ve [Image 3] gibi sıralarına göre atıfta bulunun, ardından her görüntüye net bir rol atayın:

Ana konu, karakter veya ürün için [Image 1] kullanın.
İkincil konu, aksesuar veya eşlik eden unsur için [Image 2] kullanın.
Arka plan, ortam, aydınlatma veya stil için [Image 3] kullanın.

Neyin tanınabilir kalması gerektiğini, nelerin değişebileceğini, eylemi, kamera hareketini, görsel stili ve sahneyi açıklayın. Belirsiz bir Prompt, yükleme kabul edilmiş olsa bile oluşturulan videonun referans görüntünün kullanılmadığı izlenimini vermesine neden olabilir. Bu Prompt yapısı, yalnızca görüntüleri listelemekten daha güvenilirdir:

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.

Modele göre süre

seconds değerini atlarsanız CometAPI 5 saniyelik bir klip ister. Belirli bir süre gerektiğinde seconds değerini bir dize olarak gönderin.

Model ailesi	Desteklenen `seconds`	Varsayılan	Sınır davranışı
Seedance 2.0, Seedance 2.0 Fast ve Seedance 2.0 Mini	`4`-`15`	`5`	Belirtilen aralıktaki tam sayı saniyeleri kullanın.
Seedance 1.5 Pro	`4`-`12`	`5`	Belirtilen aralıktaki tam sayı saniyeleri kullanın.
Seedance 1.0 Pro	`2`-`10`	`5`	Belirtilen aralıktaki tam sayı saniyeleri kullanın.

Modele göre boyut desteği

Aşağıdaki tablo, kesin WxH değerlerini tek bir yerde toplar. Seedance 2.0 Fast yalnızca beşinci sütundaki 480p ve 720p değerlerini kullanır. Bu sütundaki 1080p değerleri Seedance 1.5 Pro ve standart Seedance 2.0 için geçerlidir. 4K değerleri yalnızca standart Seedance 2.0 için geçerlidir. Mini sütununda, —, çözünürlüğün desteklenmediği anlamına gelir.

Çözünürlük sınıfı	En-boy oranı	Seedance 2.0 Mini	Seedance 1.0 serisi	Seedance 1.5 Pro / standart 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` (Yalnızca Seedance 2.0)
	`4:3`	—	—	`3326x2494` (Yalnızca Seedance 2.0)
	`1:1`	—	—	`2880x2880` (Yalnızca Seedance 2.0)
	`3:4`	—	—	`2494x3326` (Yalnızca Seedance 2.0)
	`9:16`	—	—	`2160x3840` (Yalnızca Seedance 2.0)
	`21:9`	—	—	`4398x1886` (Yalnızca Seedance 2.0)

Seedance 2.0 Mini, 480p ve 720p değerlerini destekler; 1080p veya 4K değerlerini desteklemez. Bir üretim kontrolünde, 1920x1080 için bir Mini isteği şunu üretti 1280x720.

Hedef model için belgelenmiş WxH değerini seçin. Kesin WxH desteği modele bağlıdır; bu nedenle belgelenmemiş bir boyuta güvenmeden önce tamamlanmış medyayı inceleyin.

Yetkilendirmeler

Authorization

string

header

gerekli

Bearer token authentication. Use your CometAPI key.

Gövde

multipart/form-data

prompt

string

gerekli

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.

Örnek:

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

model

enum<string>

gerekli

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

Mevcut seçenekler:

doubao-seedance-2-0,

doubao-seedance-2-0-fast,

doubao-seedance-2-0-mini,

doubao-seedance-1-5-pro,

doubao-seedance-1-0-pro

Örnek:

"doubao-seedance-2-0-mini"

seconds

integer

varsayılan: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.

Gerekli aralık: 2 <= x <= 15

Örnek:

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

Örnekler:

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

Yanıt

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

string

gerekli

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

object

string

gerekli

Object type, always video.

model

string

gerekli

Echo of the requested model id.

status

enum<string>

gerekli

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

Mevcut seçenekler:

queued,

in_progress,

completed,

failed,

error

progress

integer

gerekli

Completion percentage. 0 at creation.

Gerekli aralık: 0 <= x <= 100

created_at

integer

gerekli

Task creation time as a Unix timestamp in seconds.

task_id

string

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

Video oluşturma API'leri

Bir Seedance videosunu getir

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
}

İçerik moderasyonu

API anahtarları

Desteklenen model ID’leri

Referans görüntüleri kullanın

Modele göre süre

Modele göre boyut desteği

Yetkilendirmeler

Gövde

Yanıt

​Desteklenen model ID’leri

​Referans görüntüleri kullanın

​Modele göre süre

​Modele göre boyut desteği

Yetkilendirmeler

Gövde

Yanıt

Desteklenen model ID’leri

Referans görüntüleri kullanın

Modele göre süre

Modele göre boyut desteği