Перейти до основного вмісту
GET
/
v1
/
videos
/
{id}
cURL
curl https://api.cometapi.com/v1/videos/<TASK_ID> \
  -H "Authorization: Bearer <COMETAPI_KEY>"
{
  "id": "task_abc123",
  "object": "video",
  "model": "doubao-seedance-2-0",
  "status": "in_progress",
  "progress": 30,
  "created_at": 1777385418,
  "completed_at": 1777385485
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

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

​
Машина статусів

API повертає рядки статусів у нижньому регістрі. queued і in_progress є нетермінальними; completed, failed і error є термінальними, і задача більше не змінюватиметься.
СтатусЗначенняТермінальний
queuedПрийнято та поставлено в чергу на рендеринг.ні
in_progressРендеринг триває.ні
completedЗавершено. video_url присутній у відповіді.так
failedПровайдер відхилив задачу.так
errorВнутрішня помилка завадила завершенню.так

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

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

TASK_ID = "<TASK_ID>"
headers = {"Authorization": "Bearer <COMETAPI_KEY>"}
TERMINAL = {"completed", "failed", "error"}

while True:
    response = requests.get(
        f"https://api.cometapi.com/v1/videos/{TASK_ID}",
        headers=headers,
        timeout=15,
    )
    response.raise_for_status()
    data = response.json()
    if data["status"] in TERMINAL:
        print(data.get("video_url"))
        break
    time.sleep(10)

​
Поля, за якими слід стежити

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