Перейти до основного вмісту
GET
/
volc
/
v3
/
contents
/
generations
/
tasks
/
{id}
Query a ByteDance video task
curl --request GET \
  --url https://api.cometapi.com/volc/v3/contents/generations/tasks/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "021773297205999example",
  "model": "doubao-seedance-1-5-pro-251215",
  "status": "succeeded",
  "content": {
    "video_url": "https://example.com/generated.mp4"
  },
  "created_at": 1773297205,
  "updated_at": 1773297260,
  "resolution": "720p",
  "duration": 5,
  "ratio": "16:9",
  "framespersecond": 24
}
Використовуйте цей endpoint після створення задачі ByteDance Jimeng. Він не запускає рендеринг. Він лише повідомляє поточний стан задачі та, коли завдання завершиться, URL згенерованого відео й метадані результату.

Зверніть увагу на ці поля

  • status для поточного стану провайдера
  • content.video_url, коли рендеринг завершено
  • resolution, duration, ratio і framespersecond, якщо вашому застосунку потрібні метадані результату

Цикл опитування

1

Спочатку створіть задачу

Почніть із ByteDance Video Generation.
2

Опитуйте за id задачі

Продовжуйте викликати цей endpoint, доки статус не досягне термінального стану.
3

Збережіть результат

Коли з’явиться content.video_url, скопіюйте результат до власного сховища, якщо вам потрібно довготривале зберігання.

URL результату

У ByteDance процес як і раніше виглядає так: спочатку створення, потім запит за id задачі. CometAPI зберігає цю структуру й уніфікує автентифікацію. Розглядайте повернутий URL відео як URL доставки, а не постійне сховище.

Авторизації

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

Bearer token authentication. Use your CometAPI key.

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

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

Task id returned by the create endpoint.

Відповідь

200 - application/json

Current task state.

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

Provider task status.

created_at
integer
обов'язково
updated_at
integer
обов'язково
content
object
usage
object
seed
integer
resolution
string
duration
integer
ratio
string
framespersecond
integer