Перейти до основного вмісту
GET
/
v1
/
videos
/
{id}
cURL
curl https://api.cometapi.com/v1/videos/<TASK_ID> \
  -H "Authorization: Bearer <COMETAPI_KEY>"
{
  "id": "task_abc123",
  "model": "doubao-seedance-2-0-fast",
  "object": "video",
  "status": "IN_PROGRESS",
  "progress": 45,
  "created_at": 1776567610,
  "completed_at": null
}
Використовуйте цей endpoint, щоб прочитати стан задачі, створеної через Створення відео Seedance. id у шляху — це значення, повернуте викликом створення, незалежно від того, яка модель Seedance створила задачу.

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

Задача проходить через один зі станів нижче. SUBMITTED і IN_PROGRESS є нетермінальними; SUCCESS, FAILED і ERROR є термінальними, і стан задачі більше не змінюватиметься.
StatusMeaningTerminal
SUBMITTEDПрийнято та поставлено в чергу на рендеринг.ні
IN_PROGRESSРендеринг триває.ні
SUCCESSЗавершено. video_url присутній у відповіді.так
FAILEDПровайдер відхилив задачу.так
ERRORВнутрішня помилка завадила завершенню.так

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

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

TASK_ID = "<TASK_ID>"
headers = {"Authorization": "Bearer <COMETAPI_KEY>"}
TERMINAL = {"SUCCESS", "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 для завантаження, присутній лише при SUCCESS. Підпис має обмежений час дії; завантажте файл або розмістіть його у себе до закінчення дії підпису.
  • completed_at — Unix timestamp, який заповнюється, щойно задача досягає термінального 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 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. SUBMITTED and IN_PROGRESS are non-terminal. SUCCESS, FAILED, and ERROR are terminal.

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

Task completion time as a Unix timestamp in seconds. null while the task is non-terminal.