Перейти к основному содержанию
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
}
Используйте этот endpoint после запуска задания Sora. Он сообщает текущее состояние задания, настроенные размер и длительность, а также любую ошибку, возвращённую провайдером.

Обратите внимание на эти поля

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

Опрос до завершения

1

Сначала создайте или ремикшируйте видео

Начните с Create Video или Remix Video.
2

Выполняйте опрос по id

Передайте сюда возвращённый id и продолжайте проверять, пока задание не перейдёт в состояние completed или failed.
3

Скачайте файл

Когда задание получит статус completed, перейдите к Retrieve Video Content.

Форма ответа в CometAPI

Этот шаг почти полностью соответствует процессу опроса 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