Перейти до основного вмісту
GET
/
v1
/
videos
/
{video_id}
Retrieve a Sora video job
curl --request GET \
  --url https://api.cometapi.com/v1/videos/{video_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "video_69b25d5f467c81908733a56bc236b4df",
  "size": "1280x720",
  "error": null,
  "model": "sora-2",
  "object": "video",
  "prompt": "A paper airplane glides across a desk.",
  "status": "in_progress",
  "seconds": "4",
  "progress": 0,
  "created_at": 1773296991,
  "expires_at": null,
  "completed_at": null,
  "remixed_from_video_id": null
}

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 після запуску завдання Sora. Він повідомляє поточний стан завдання, налаштовані розмір і тривалість, а також будь-яку помилку, повернуту провайдером.

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

  • status для стану життєвого циклу
  • progress для приблизного сигналу про прогрес
  • error коли провайдер відхиляє завдання або під час його виконання стається помилка
  • expires_at після завершення, якщо вам потрібно знати, коли тимчасові ресурси втратять чинність

​
Опитуйте до завершення

1

Спочатку створіть або реміксуйте відео

Почніть із Create Video або Remix Video.
2

Опитування за id

Передайте сюди повернений id і продовжуйте перевіряти, доки завдання не досягне стану completed або failed.
3

Завантажте файл

Коли завдання матиме стан completed, перейдіть до Retrieve Video Content.

​
Форма відповіді в CometAPI

Цей крок тісно відповідає workflow опитування Sora. CometAPI зберігає форму об’єкта у стилі OpenAI, тож ви можете налаштувати перевірки статусу з мінімальною адаптацією.

Авторизації

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

Bearer token authentication. Use your CometAPI key.

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

​
video_id
string
обов'язково

Video id returned by the create or remix endpoint.

Відповідь

200 - application/json

Current job state.

​
id
string
обов'язково
​
size
string
обов'язково
​
model
string
обов'язково
​
object
string
обов'язково
​
status
string
обов'язково
​
seconds
string
обов'язково
​
progress
integer
обов'язково
​
created_at
integer
обов'язково
​
error
object
​
prompt
string
​
expires_at
integer | null
​
completed_at
integer | null
​
remixed_from_video_id
string | null