Создание видео 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. В ходе одной проверки в рабочей среде запрос 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-ключи

Поддерживаемые ID моделей

Использование эталонных изображений

Длительность по моделям

Поддержка размеров по моделям

Авторизации

Тело

Ответ

​Поддерживаемые ID моделей

​Использование эталонных изображений

​Длительность по моделям

​Поддержка размеров по моделям

Авторизации

Тело

Ответ

Поддерживаемые ID моделей

Использование эталонных изображений

Длительность по моделям

Поддержка размеров по моделям