Получение видео

Используйте CometAPI GET /v1/videos/, чтобы получить статус видео Sora 2, прогресс и метаданные, такие как длительность, размеры, временные метки и срок действия.

GET /v1/videos/{video_id}

Retrieve a Sora video job

cURL

curl --request GET \
  --url https://api.cometapi.com/v1/videos/{video_id} \
  --header 'Authorization: Bearer <token>'

200

{
  "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