Перейти до основного вмісту
POST
/
v1
/
videos
curl https://api.cometapi.com/v1/videos \ -H "Authorization: Bearer <COMETAPI_KEY>" \ -F 'prompt="A slow cinematic camera push across a coastal landscape at sunrise"' \ -F 'model="doubao-seedance-2-0-fast"' \ -F 'seconds="5"' \ -F 'size="16:9"' \ -F 'resolution="720p"'
{ "id": "task_abc123", "task_id": "task_abc123", "object": "video", "model": "doubao-seedance-2-0-fast", "status": "SUBMITTED", "progress": 0, "created_at": 1776681149 }
Використовуйте цей endpoint, щоб запустити відеозавдання ByteDance Seedance. Усі рівні моделей Seedance використовують однакову форму запиту; модель обирається через поле model. Виклик одразу повертає id завдання, а рендеринг продовжується у фоновому режимі.

​
Вибір моделі

Model idРівеньПримітки
doubao-seedance-2-02.0Найвища якість виводу в лінійці 2.0.
doubao-seedance-2-0-fast2.0Швидший варіант 2.0 для швидких ітерацій і попереднього перегляду.
doubao-seedance-1-5-pro1.5 ProПідтримує 1080p. Лише text-to-video.
doubao-seedance-1-0-pro1.0 ProПідтримує 1080p і коротші кліпи від 2 секунд. Лише text-to-video.
Актуальну доступність дивіться на сторінці Models page.

​
Діапазони параметрів

FieldTypeRequiredDefaultAllowed values
promptstringyes—будь-який текст
modelstringyes—doubao-seedance-2-0, doubao-seedance-2-0-fast, doubao-seedance-1-5-pro, doubao-seedance-1-0-pro
secondsintegerno5залежить від моделі (див. нижче)
sizestringno16:921:9, 16:9, 4:3, 1:1, 3:4, 9:16
resolutionstringno720p480p, 720p для моделей 2.0; 480p, 720p, 1080p для 1.5 Pro і 1.0 Pro
input_referencefileno—JPEG, PNG або WebP. Приймається лише моделями 2.0.

​
Діапазон тривалості за моделлю

ModelДіапазон seconds
doubao-seedance-2-0, doubao-seedance-2-0-fastвід 4 до 15
doubao-seedance-1-5-proвід 4 до 12
doubao-seedance-1-0-proвід 2 до 10
Надсилання значення поза діапазоном моделі повертає HTTP 400 з code: "InvalidParameter" і повідомленням про duration.

​
Підтримка image-to-video

Лише моделі 2.0 приймають файл input_reference. Надсилання input_reference з doubao-seedance-1-5-pro або doubao-seedance-1-0-pro повертає HTTP 400 з повідомленням у форматі the specified task_type r2v does not support model seedance-1-5-pro. Використовуйте ці моделі лише для text-to-video.

​
Завантаження еталонного зображення

Тіло запиту має формат multipart/form-data. Щоб запустити image-to-video на моделі 2.0, прикріпіть зображення як частину input_reference у тому самому запиті: 
curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer <COMETAPI_KEY>" \
  -F 'prompt="A slow cinematic camera push across a coastal landscape at sunrise."' \
  -F 'model="doubao-seedance-2-0"' \
  -F 'seconds="5"' \
  -F 'size="16:9"' \
  -F 'resolution="720p"' \
  -F 'input_reference=@/path/to/reference.jpg'
Замініть /path/to/reference.jpg на абсолютний або відносний шлях до зображення, яке ви хочете використати як прив’язку для першого кадру. Підтримувані формати: JPEG, PNG і WebP.

​
Потік виконання завдання

1

Надішліть завдання

Надішліть POST-запит щонайменше з prompt і model. Збережіть повернений id для наступного кроку.
2

Опитуйте стан завдання

Викликайте Retrieve a Seedance video кожні 10–20 секунд.
3

Завантажте результат

Коли status стане SUCCESS, завантажте файл за адресою video_url і розмістіть його у себе, якщо вам потрібен довгостроковий доступ. URL підписаний і спливає через обмежений проміжок часу.

​
Відповіді з помилками

Endpoint повертає HTTP 400, якщо відсутнє обов’язкове поле, значення виходить за межі допустимого діапазону або input_reference надсилається до моделі, яка не підтримує image-to-video. Він повертає HTTP 401, якщо bearer token відсутній або недійсний. Тіло помилки використовує одну з двох форм; точні поля дивіться у прикладах 400 і 401 в playground.

Авторизації

​
Authorization
string
header
обов'язково

Bearer token authentication. Use your CometAPI key.

Тіло

multipart/form-data
​
prompt
string
обов'язково

Text prompt that describes the video. Required.

Приклад:

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

​
model
enum<string>
обов'язково

Seedance model id. Choose doubao-seedance-2-0 for the highest quality 2.0 output, doubao-seedance-2-0-fast for quick iteration on 2.0, doubao-seedance-1-5-pro for the 1.5 Pro tier, or doubao-seedance-1-0-pro for the 1.0 Pro tier. Only the two 2.0 models accept input_reference.

Доступні опції:
doubao-seedance-2-0,
doubao-seedance-2-0-fast,
doubao-seedance-1-5-pro,
doubao-seedance-1-0-pro
Приклад:

"doubao-seedance-2-0-fast"

​
seconds
integer
за замовчуванням:5

Video duration in seconds. The accepted range depends on the model: doubao-seedance-2-0 and doubao-seedance-2-0-fast accept 4 to 15, doubao-seedance-1-5-pro accepts 4 to 12, and doubao-seedance-1-0-pro accepts 2 to 10. The default is 5 for every model.

Необхідний діапазон: 2 <= x <= 15
Приклад:

5

​
size
enum<string>
за замовчуванням:16:9

Output aspect ratio. All Seedance models accept the same set of values.

Доступні опції:
21:9,
16:9,
4:3,
1:1,
3:4,
9:16
Приклад:

"16:9"

​
resolution
enum<string>
за замовчуванням:720p

Output resolution. 480p and 720p are accepted by every model; 1080p is supported only by doubao-seedance-1-5-pro and doubao-seedance-1-0-pro.

Доступні опції:
480p,
720p,
1080p
Приклад:

"720p"

​
input_reference
file

Optional reference image. When included, the job runs in image-to-video mode and uses the image as the visual anchor. Only doubao-seedance-2-0 and doubao-seedance-2-0-fast accept this field; sending it with a 1.0 Pro or 1.5 Pro model returns HTTP 400.

Відповідь

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

​
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. A newly created task is returned as SUBMITTED.

Доступні опції:
SUBMITTED,
IN_PROGRESS,
SUCCESS,
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.