Створення відео 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
}

Виберіть із таблиці нижче задокументоване значення WxH для поля size.

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

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

Використовуйте одне з цих точних значень для поля model.

Модель	Точний ID моделі	Режими та рівні роздільної здатності	Підтримується `seconds`
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`

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

Seedance 2.0, Seedance 2.0 Fast і Seedance 2.0 Mini приймають input_reference. Для розширених Prompt із кількома еталонними зображеннями на маршруті, який їх підтримує, повторюйте те саме поле multipart у порядку завантаження. Один виробничий запит Mini з одним input_reference було виконано о 720x1280. Ця перевірка підтвердила виконання запиту, але не ізолювала візуальний вплив еталонного зображення від Prompt. Seedance 2.0 чутливий до того, як Prompt пов’язує кожне еталонне зображення зі сценою. Посилайтеся на завантажені файли за порядком, наприклад [Image 1], [Image 2] і [Image 3], а потім призначайте кожному зображенню чітку роль:

Використовуйте [Image 1] для основного об’єкта, персонажа або продукту.
Використовуйте [Image 2] для другорядного об’єкта, реквізиту або супутника.
Використовуйте [Image 3] для фону, оточення, освітлення або стилю.

Опишіть, що має залишатися впізнаваним, що може змінюватися, дію, рух камери, візуальний стиль і сцену. Нечіткий Prompt може призвести до того, що згенероване відео виглядатиме так, ніби еталонне зображення не використовувалося, навіть якщо завантаження було прийнято. Така структура Prompt надійніша, ніж простий перелік зображень:

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.

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

Якщо не вказати seconds, CometAPI запитує 5-секундний кліп. Надсилайте seconds як рядок, коли потрібна певна тривалість.

Сімейство моделей	Підтримується `seconds`	За замовчуванням	Поведінка на межах діапазону
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`	Використовуйте цілі секунди в межах діапазону。

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

У таблиці нижче точні значення WxH зібрано в одному місці. 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, але не 1080p чи 4K. Під час однієї перевірки в production запит Mini для 1920x1080 створив 1280x720.

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

Авторизації

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

Приклад:

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

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

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.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 <= 15

Приклад:

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

Приклади:

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

Відповідь

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.

API генерації відео

Попередня

Отримати відео Seedance

Наступна

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
}

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

API-ключі

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

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

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

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

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

Авторизації

Тіло

Відповідь

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

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

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

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

Авторизації

Тіло

Відповідь

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

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

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

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