Перейти к основному содержанию
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

Сначала создайте задачу

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