Створення відео Seedance

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
}

Установіть size на значення WxH із таблиці розмірів для вашої моделі.

Використовуйте doubao-seedance-2-0-mini точно для Seedance 2.0 Mini. Скорочене значення seedance-mini не є дійсним ID моделі.

Підтримувані ID моделей

Виберіть модель для свого режиму введення та роздільної здатності, а потім надішліть її точний ID у полі model.

Модель	Точний ID моделі	Режими та рівні роздільної здатності	Підтримується `seconds`
Seedance 2.5	`seedance-2-5`	Перетворення тексту на відео, референсні медіа; `480p`, `720p`	`4`-`30`
Seedance 2.0	`doubao-seedance-2-0`	Перетворення тексту на відео, референсні медіа; `480p`, `720p`, `1080p`, `4K`	`4`-`15`
Seedance 2.0 Fast	`doubao-seedance-2-0-fast`	Перетворення тексту на відео, референсні медіа; `480p`, `720p`	`4`-`15`
Seedance 2.0 Mini	`doubao-seedance-2-0-mini`	Перетворення тексту на відео, референсні медіа; `480p`, `720p`	`4`-`15`
Seedance 1.5 Pro	`doubao-seedance-1-5-pro`	Перетворення тексту на відео, зображення на відео; `480p`, `720p`, `1080p`	`4`-`12`
Seedance 1.0 Pro	`doubao-seedance-1-0-pro`	Перетворення тексту на відео, зображення на відео; `480p`, `720p`, `1080p`	`2`-`10`

Використання референсних зображень

Надішліть POST /v1/videos як multipart/form-data, додавши референсні зображення в input_reference. Для кількох зображень повторюйте поле в порядку зображень, указуючи в кожному полі одну загальнодоступну HTTPS URL-адресу зображення або один завантажений файл зображення. У цьому полі використовуйте лише URL-адреси або лише файли. Надсилайте кожну URL-адресу окремо, а не об’єднуйте URL-адреси комами. Розмір кожного завантаженого зображення не має перевищувати 20 МіБ (20 × 1024 × 1024 байтів). Seedance 1.0 Pro і 1.5 Pro використовують одне референсне зображення. Seedance 2.0, Fast і Mini підтримують до 9 референсних зображень. Seedance 2.5 підтримує до 30 референсних зображень. Ці обмеження застосовуються як до URL-адрес, так і до завантажених файлів. У Prompt призначте кожному зображенню роль, наприклад суб’єкт, оточення або візуальний стиль. Опишіть зовнішній вигляд, який потрібно зберегти, дію та рух камери. Приклади запитів у верхній частині цієї сторінки демонструють вхідні дані у вигляді URL-адрес зображень і завантаження одного або кількох зображень.

Надсилання URL-адрес референсних зображень

Використовуйте дві URL-адреси зображень, щоб задати зовнішній вигляд суб’єкта та оточення:

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'

Використання еталонних відео й аудіо

Seedance 2.0, Fast, Mini і 2.5 підтримують reference_videos та reference_audios. Використовуйте файли MP4 для еталонних відео та файли MP3 для еталонного аудіо. Надсилайте кожен як загальнодоступну HTTPS URL-адресу або завантажений файл. Поєднуйте еталонне аудіо принаймні з одним зображенням або відео. У Prompt використовуйте @Image1, @Video1 і @Audio1, щоб призначати ролі еталонним матеріалам. Нумеруйте еталонні матеріали за їхнім порядком у межах кожного типу медіа. Ви можете поєднувати URL-адреси й завантаження в різних полях. У кожному з input_reference, reference_videos і reference_audios використовуйте або лише URL-адреси, або лише файли. Для кількох входів повторюйте поле один раз для кожного входу, а не об’єднуйте URL-адреси комами.

Сімейство моделей	Еталонні зображення	Еталонні відео	Еталонне аудіо	Загальна кількість еталонних входів
Seedance 2.0, Fast і Mini	До 9 URL-адрес або файлів у `input_reference`	До 3	До 3	До 12
Seedance 2.5	До 30 URL-адрес або файлів у `input_reference`	До 10 URL-адрес або 5 файлів	До 10 URL-адрес або 5 файлів	До 50

Розмір кожного завантаженого відео не має перевищувати 50 MiB, а кожного завантаженого аудіофайлу — 15 MiB. Один MiB дорівнює 1024 × 1024 байтів. Стандартна Seedance 2.0 (doubao-seedance-2-0) має додаткові обмеження для медіа як для URL-адрес, так і для завантажених файлів. Для еталонних відео загальна тривалість має становити від 2 до 15 секунд, а загальний розмір — не перевищувати 50 MB. Використовуйте роздільну здатність еталонного відео приблизно від 480p (640x640) до 720p (834x1112). Для еталонного аудіо загальна тривалість не має перевищувати 15 секунд, а розмір кожного файлу — 15 MB. Завантажені медіафайли також мають відповідати наведеним вище обмеженням на розмір кожного файлу.

Надсилання URL-адреси еталонного відео

Використовуйте еталонне відео, щоб керувати рухом камери та дією:

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'

Поєднання URL-адреси зображення з аудіо

Анімуйте еталонний об’єкт у ритмі еталонного аудіо:

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

Завантажте два зображення, відео MP4 та аудіофайл MP3 в одному запиті:

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'

Тривалість за моделлю

Установіть seconds на ціле значення у межах діапазону вашої моделі. Якщо його не вказати, CometAPI запитує 5-секундний кліп.

Сімейство моделей	Підтримувані значення `seconds`	За замовчуванням	Поведінка на межах діапазону
Seedance 2.5	`4`-`30`	`5`	Використовуйте цілі секунди в межах діапазону.
Seedance 2.0, Seedance 2.0 Fast і Seedance 2.0 Mini	`4`-`15`	`5`	Використовуйте цілі секунди в межах діапазону.
Seedance 1.5 Pro	`4`-`12`	`5`	Використовуйте цілі секунди в межах діапазону.
Seedance 1.0 Pro	`2`-`10`	`5`	Використовуйте цілі секунди в межах діапазону.

Підтримка розмірів за моделлю

Seedance 2.5

Для Seedance 2.5 ці значення WxH застосовуються як до текстових Prompt, так і до довідкових медіафайлів.

Клас роздільної здатності	`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`

Попередні моделі Seedance

Останній стовпець об’єднує точні значення WxH для Seedance 1.5 Pro, стандартної Seedance 2.0 і Fast. Seedance 2.0 Fast використовує лише значення 480p і 720p у цьому стовпці. Значення 1080p у цьому стовпці застосовуються до Seedance 1.5 Pro і стандартної Seedance 2.0. Значення 4K застосовуються лише до стандартної Seedance 2.0. У стовпці Mini — означає, що роздільна здатність не підтримується.

Клас роздільної здатності	Співвідношення сторін	Seedance 2.0 Mini	Серія Seedance 1.0	Seedance 1.5 Pro / стандартна 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` (Лише Seedance 2.0)
	`4:3`	—	—	`3326x2494` (Лише Seedance 2.0)
	`1:1`	—	—	`2880x2880` (Лише Seedance 2.0)
	`3:4`	—	—	`2494x3326` (Лише Seedance 2.0)
	`9:16`	—	—	`2160x3840` (Лише Seedance 2.0)
	`21:9`	—	—	`4398x1886` (Лише Seedance 2.0)

Seedance 2.0 Mini підтримує 480p і 720p. Установіть size на значення WxH зі стовпця Mini.

Авторизації

Authorization

string

header

обов'язково

Bearer token authentication. Use your CometAPI key.

Тіло

multipart/form-data

prompt

string

обов'язково

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.

Приклад:

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

model

enum<string>

обов'язково

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

Доступні опції:

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

Приклад:

"doubao-seedance-2-0-mini"

seconds

integer

за замовчуванням: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.

Необхідний діапазон: 2 <= x <= 30

Приклад:

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

Приклади:

"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://

Приклад:

"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://

Приклад:

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

Відповідь

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

string

обов'язково

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

object

string

обов'язково

Object type, always video.

model

string

обов'язково

Echo of the requested model id.

status

enum<string>

обов'язково

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

Доступні опції:

queued,

in_progress,

completed,

failed,

error

progress

integer

обов'язково

Completion percentage. 0 at creation.

Необхідний діапазон: 0 <= x <= 100

created_at

integer

обов'язково

Task creation time as a Unix timestamp in seconds.

task_id

string

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

Останнє оновлення 9 вересня 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
}

Модерація контенту

API-ключі

Створення відео Seedance

Підтримувані ID моделей

Використання референсних зображень

Надсилання URL-адрес референсних зображень

Використання еталонних відео й аудіо

Надсилання URL-адреси еталонного відео

Поєднання URL-адреси зображення з аудіо

Завантаження еталонних медіафайлів із Seedance 2.5

Тривалість за моделлю

Підтримка розмірів за моделлю

Seedance 2.5

Попередні моделі Seedance

Авторизації

Тіло

Відповідь

​Підтримувані ID моделей

​Використання референсних зображень

​Надсилання URL-адрес референсних зображень

​Використання еталонних відео й аудіо

​Надсилання URL-адреси еталонного відео

​Поєднання URL-адреси зображення з аудіо

​Завантаження еталонних медіафайлів із Seedance 2.5

​Тривалість за моделлю

​Підтримка розмірів за моделлю

​Seedance 2.5

​Попередні моделі Seedance

Авторизації

Тіло

Відповідь

Підтримувані ID моделей

Використання референсних зображень

Надсилання URL-адрес референсних зображень

Використання еталонних відео й аудіо

Надсилання URL-адреси еталонного відео

Поєднання URL-адреси зображення з аудіо

Завантаження еталонних медіафайлів із Seedance 2.5

Тривалість за моделлю

Підтримка розмірів за моделлю

Seedance 2.5

Попередні моделі Seedance