Seedance videosu oluşturun

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'prompt="A matte magenta cube rotates slowly above a cyan studio floor while a small yellow sphere circles it."' \
  -F 'model="seedance-2-5"' \
  -F 'seconds="4"' \
  -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
}

Modeliniz için boyut tablosundan size değerini bir WxH değeri olarak ayarlayın.

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

Desteklenen model ID’leri

Giriş modunuza ve çözünürlüğünüze uygun bir model seçin, ardından tam ID’sini model alanında gönderin.

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

Referans görüntüleri kullanın

POST /v1/videos değerini multipart/form-data olarak, referans görüntülerini ise input_reference içinde gönderin. Birden fazla görüntü için alanı görüntü sırasıyla tekrarlayın; her alan için herkese açık olarak erişilebilen bir HTTPS görüntü URL’si veya yüklenmiş bir görüntü dosyası kullanın. Bu alan içinde yalnızca URL’ler veya yalnızca dosyalar kullanın. URL’leri virgülle birleştirmek yerine her URL’yi ayrı gönderin. Yüklenen her görüntünün boyutunu 20 MiB veya altında tutun (20 × 1024 × 1024 bayt). Seedance 1.0 Pro ve 1.5 Pro bir referans görüntüsü kullanır. Seedance 2.0, Fast ve Mini en fazla 9 referans görüntüsünü kabul eder. Seedance 2.5 en fazla 30 referans görüntüsünü kabul eder. Bu sayılar hem URL’ler hem de yüklenen dosyalar için geçerlidir. Prompt’ta her görüntüye konu, ortam veya görsel stil gibi bir rol atayın. Korunacak görünümü, eylemi ve kamera hareketini açıklayın. Bu sayfanın üst kısmındaki istek örnekleri, görüntü URL girişlerini ve tek görüntülü veya çok görüntülü yüklemeleri gösterir.

Referans görüntü URL’lerini gönderin

Konu görünümünü ve ortamı yönlendirmek için iki görüntü URL’si kullanın:

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=doubao-seedance-2-0' \
  --form-string 'prompt=Use the subject in @Image1 and the setting in @Image2. Use a slow camera push-in and natural motion.' \
  --form-string 'seconds=5' \
  --form-string 'size=1280x720' \
  --form-string 'input_reference=https://your-image-host/subject.png' \
  --form-string 'input_reference=https://your-image-host/setting.png'

Referans video ve ses kullanma

Seedance 2.0, Fast, Mini ve 2.5, reference_videos ve reference_audios kabul eder. Video referansları için MP4 dosyalarını, ses referansları için ise MP3 dosyalarını kullanın. Her birini herkese açık olarak erişilebilen bir HTTPS URL’si veya yüklenmiş bir dosya şeklinde gönderin. Referans sesi en az bir görüntü veya videoyla eşleştirin. Prompt içinde referanslarınıza roller atamak için @Image1, @Video1 ve @Audio1 kullanın. Referansları her medya türündeki sıralarına göre numaralandırın. Farklı alanlardaki URL’leri ve yüklemeleri birleştirebilirsiniz. input_reference, reference_videos ve reference_audios alanlarının her birinde yalnızca URL’lerin tümünü veya dosyaların tümünü kullanın. Birden çok girdi için URL’leri virgülle birleştirmek yerine her girdi başına alanı bir kez tekrarlayın.

Model ailesi	Referans görüntüleri	Referans videoları	Referans sesi	Toplam referans girdisi
Seedance 2.0, Fast ve Mini	En fazla 9 URL veya dosya `input_reference`	En fazla 3	En fazla 3	En fazla 12
Seedance 2.5	En fazla 30 URL veya dosya `input_reference`	En fazla 10 URL veya 5 dosya	En fazla 10 URL veya 5 dosya	En fazla 50

Yüklenen her videoyu 50 MiB veya altında, yüklenen her ses dosyasını ise 15 MiB veya altında tutun. Bir MiB, 1024 × 1024 bayttır. Standart Seedance 2.0 (doubao-seedance-2-0), hem URL’ler hem de yüklenen dosyalar için ek medya sınırlarına sahiptir. Referans videolarda toplam süreyi 2 ila 15 saniye arasında, toplam boyutu ise 50 MB’ın altında tutun. Yaklaşık 480p (640x640) ila 720p (834x1112) referans video çözünürlüğü kullanın). Referans sesinde toplam süreyi 15 saniye veya altında, her dosyayı ise 15 MB veya altında tutun. Yüklenen medya ayrıca yukarıdaki dosya başına yükleme sınırlarını karşılamalıdır.

Referans video URL’si gönderme

Kamera hareketine ve aksiyona yön vermek için referans videoyu kullanın:

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=doubao-seedance-2-0' \
  --form-string 'prompt=Follow the camera movement and action in @Video1. Preserve the direction and pace of the motion.' \
  --form-string 'seconds=5' \
  --form-string 'size=1280x720' \
  --form-string 'reference_videos=https://your-media-host/reference.mp4'

Bir görüntü URL’sini sesle eşleştirme

Referans özneyi referans sesin ritmine göre canlandırın:

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=doubao-seedance-2-0' \
  --form-string 'prompt=Animate the subject in @Image1 to the rhythm of @Audio1. Preserve the subject appearance and use a fixed camera.' \
  --form-string 'seconds=5' \
  --form-string 'size=1280x720' \
  --form-string 'input_reference=https://your-image-host/subject.png' \
  --form-string 'reference_audios=https://your-media-host/reference.mp3'

Seedance 2.5 ile referans medya yükleme

Tek bir istekte iki görüntü, bir MP4 video ve bir MP3 ses dosyası yükleyin:

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=seedance-2-5' \
  --form-string 'prompt=Use the subject in @Image1 and the setting in @Image2. Follow the motion in @Video1 and the rhythm of @Audio1.' \
  --form-string 'seconds=5' \
  --form-string 'size=1280x720' \
  --form 'input_reference=@/path/to/subject.png;type=image/png' \
  --form 'input_reference=@/path/to/setting.png;type=image/png' \
  --form 'reference_videos=@/path/to/reference.mp4;type=video/mp4' \
  --form 'reference_audios=@/path/to/reference.mp3;type=audio/mpeg'

Modele göre süre

seconds değerini modelinizin aralığı içinde tamsayı biçiminde ayarlayın. Atlarsanız, CometAPI 5 saniyelik bir klip ister.

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

Modele göre boyut desteği

Seedance 2.5

Seedance 2.5 için bu WxH değerleri hem metin Prompt’ları hem de referans medya için geçerlidir.

Çözünürlük sınıfı	`16:9`	`4:3`	`1:1`	`3:4`	`9:16`	`21:9`
`480p`	`854x480`	`752x560`	`640x640`	`560x752`	`480x854`	`992x432`
`720p`	`1280x720`	`1112x834`	`960x960`	`834x1112`	`720x1280`	`1470x630`

Önceki Seedance modelleri

Son sütun, Seedance 1.5 Pro, standart Seedance 2.0 ve Fast için kesin WxH değerlerini gruplandırır. Seedance 2.0 Fast, bu sütundaki yalnızca 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. size değerini Mini sütunundaki bir WxH değeri olarak ayarlayın.

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 image should control, such as the subject from @Image1, the secondary object from @Image2, and the background or style from @Image3. 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:

seedance-2-5,

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.5 accepts 4 to 30. 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 <= 30

Örnek:

5

size

string

Output size as an exact WxH value. For Seedance 2.5 text-to-video and image-to-video, use 854x480, 752x560, 640x640, 560x752, 480x854, or 992x432 for 480p; use 1280x720, 1112x834, 960x960, 834x1112, 720x1280, or 1470x630 for 720p. For Seedance 2.0 Mini, use 864x496, 752x560, 640x640, 560x752, 496x864, or 992x432 for 480p; use the same documented 720p values. 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:

"854x480"

"480x854"

"864x496"

"752x560"

"640x640"

"560x752"

"496x864"

"992x432"

"1280x720"

"1112x834"

"960x960"

"834x1112"

"720x1280"

"1470x630"

"1920x1080"

"1080x1920"

"3840x2160"

"3326x2494"

"2880x2880"

"2494x3326"

"2160x3840"

"4398x1886"

input_reference

Reference images: repeat input_reference with one publicly accessible HTTPS image URL or one uploaded image file per field. Use only URLs or only files within this field; do not join URLs with commas. Keep each uploaded image at or below 20 MiB. Seedance 2.0, Fast, and Mini allow up to nine image URLs or files and 12 reference inputs in total. Seedance 2.5 allows up to 30 image URLs or files and 50 reference inputs in total. For Seedance 1.0 Pro and 1.5 Pro, send one URL or one file. Submit images in the order you want to reference them in the prompt.

Pattern: ^https://

reference_videos

(string<uri> | file)[]

Reference video inputs for Seedance 2.0, Fast, Mini, and 2.5. Repeat reference_videos with a publicly accessible HTTPS MP4 URL or an uploaded MP4 file. Use only URLs or only files within this field. Each file can be up to 50 MiB. Seedance 2.0, Fast, and Mini allow up to three video inputs and 12 reference inputs in total. Seedance 2.5 allows up to ten video URLs or five uploaded video files, with 50 reference inputs in total. For standard Seedance 2.0 (doubao-seedance-2-0), URL and uploaded references must have a combined video duration of 2 to 15 seconds and a total video size under 50 MB. Each reference video must have a resolution of approximately 480p (640x640) to 720p (834x1112). These media limits apply in addition to the 50 MiB per-file upload limit.

Required array length: 1 - 10 elements

Pattern: ^https://

Örnek:

"https://your-media-host/reference.mp4"

reference_audios

(string<uri> | file)[]

Reference audio inputs for Seedance 2.0, Fast, Mini, and 2.5. Repeat reference_audios with a publicly accessible HTTPS MP3 URL or an uploaded MP3 file. Use only URLs or only files within this field. Each file can be up to 15 MiB. Seedance 2.0, Fast, and Mini allow up to three audio inputs and 12 reference inputs in total. Seedance 2.5 allows up to ten audio URLs or five uploaded audio files, with 50 reference inputs in total. Pair audio with at least one reference image or video. For standard Seedance 2.0 (doubao-seedance-2-0), URL and uploaded audio references must have a combined duration at or below 15 seconds, with each audio file at or below 15 MB. These media limits apply in addition to the 15 MiB per-file upload limit.

Required array length: 1 - 10 elements

Pattern: ^https://

Örnek:

"https://your-media-host/reference.mp3"

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.

Son değiştirilme tarihi 9 Eylül 2026

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'prompt="A matte magenta cube rotates slowly above a cyan studio floor while a small yellow sphere circles it."' \
  -F 'model="seedance-2-5"' \
  -F 'seconds="4"' \
  -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

Referans görüntü URL’lerini gönderin

Referans video ve ses kullanma

Referans video URL’si gönderme

Bir görüntü URL’sini sesle eşleştirme

Seedance 2.5 ile referans medya yükleme

Modele göre süre

Modele göre boyut desteği

Seedance 2.5

Önceki Seedance modelleri

Yetkilendirmeler

Gövde

Yanıt

​Desteklenen model ID’leri

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

​Referans görüntü URL’lerini gönderin

​Referans video ve ses kullanma

​Referans video URL’si gönderme

​Bir görüntü URL’sini sesle eşleştirme

​Seedance 2.5 ile referans medya yükleme

​Modele göre süre

​Modele göre boyut desteği

​Seedance 2.5

​Önceki Seedance modelleri

Yetkilendirmeler

Gövde

Yanıt

Desteklenen model ID’leri

Referans görüntüleri kullanın

Referans görüntü URL’lerini gönderin

Referans video ve ses kullanma

Referans video URL’si gönderme

Bir görüntü URL’sini sesle eşleştirme

Seedance 2.5 ile referans medya yükleme

Modele göre süre

Modele göre boyut desteği

Seedance 2.5

Önceki Seedance modelleri