Skip to main content
GET
cURL
Використовуйте цей endpoint, щоб прочитати стан завдання, створеного через Створити відео Seedance. id у шляху — це значення, повернене викликом створення, незалежно від того, яка модель Seedance створила завдання. Тіло відповіді — це безпосередньо сам об’єкт завдання відео. Читайте status, progress і video_url на верхньому рівні.

Машина status

API повертає рядки status у нижньому регістрі. queued і in_progress є нетермінальними; completed, failed і error є термінальними, і завдання більше не змінюватиметься.

Частота опитування

Опитуйте кожні 10–20 секунд. Більшість завдань завершуються за 1–3 хвилини залежно від моделі, тривалості та розміру.

Поля, за якими варто стежити

  • status — визначає умову зупинки для вашого циклу опитування.
  • progress — ціле число від 0 до 100, яке можна відображати в UI.
  • video_url — підписаний URL для завантаження, присутній у відповідях completed. Завантаження Seedance напряму використовують цей URL замість окремого маршруту /v1/videos/{id}/content. Підпис має обмежений строк дії; завантажте файл або розмістіть його у себе до завершення строку дії підпису.
  • completed_at — необов’язкова Unix-мітка часу, яку повертає платформа. Не використовуйте її для зупинки опитування; натомість використовуйте status.
  • model — повторює model ID Seedance, який використовувався під час створення завдання.

Поширені помилки

  • HTTP 400 з message: "task_not_exist" означає, що id невідомий. Переконайтеся, що ви зберегли id з успішної відповіді POST /v1/videos і використовуєте його без змін.
  • HTTP 401 означає, що bearer token відсутній або недійсний. Перевірте, що заголовок запиту має вигляд Authorization: Bearer $COMETAPI_KEY.

Авторизації

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

Bearer token authentication. Use your CometAPI key.

Параметри шляху

id
string
обов'язково

Task id returned by POST /v1/videos.

Відповідь

Current Seedance video task state.

id
string
обов'язково

Task id.

object
string
обов'язково

Object type, always video.

model
string
обов'язково

Model id that generated the task.

status
enum<string>
обов'язково

Task status. queued and in_progress are non-terminal. completed, failed, and error are terminal.

Доступні опції:
queued,
in_progress,
completed,
failed,
error
progress
integer
обов'язково

Completion percentage.

Необхідний діапазон: 0 <= x <= 100
created_at
integer
обов'язково

Task creation time as a Unix timestamp in seconds.

video_url
string | null

Signed download URL for the finished video. Present on completed responses. Seedance downloads use this URL directly instead of a separate /v1/videos/{id}/content route. The signature is time-limited, so download or re-upload the file to your own storage soon after you receive it.

completed_at
integer | null

Optional Unix timestamp returned by the platform. Use status, not this field, to decide when polling can stop.