Статус видео
Проверьте прогресс ранее созданной задачи. Интервал опроса выбирайте разумным — например, несколько секунд.
GET
/v1/videos/{id}Заголовки
AuthorizationBearer <API_KEY>Обязательно- Ключ компании из раздела «API-ключи». Храните на сервере или в переменной окружения. Не вставляйте секретный ключ в браузерный код.
Acceptapplication/json | text/event-streamНеобязательно- Ожидаемый формат ответа. Для включения SSE нужно также передать stream: true в JSON. Синтез речи и скачивание видео возвращают бинарные данные.
Адрес метода: https://gateway.orlime.ru/v1/videos/{id}
Входные параметры
idpath stringОбязательно- Полный ID из POST /v1/videos.
Пример запроса
curl --fail-with-body https://gateway.orlime.ru/v1/videos/{id} \
-H "Authorization: Bearer $ORLIME_API_KEY"Замените {id} полным ID задачи из ответа создания видео.
Ответ
idstringВ ответе- Непрозрачный ID видеозадачи Gateway. Сохраните целиком; не пытайтесь разбирать его содержимое.
object"video"В ответе- Тип ресурса.
modelstringВ ответе- Публичный ID модели.
statusstringЕсли доступно- queued или pending — ожидание; in_progress или processing — обработка; completed или succeeded — готово; failed, cancelled/canceled, expired — завершено без готового результата.
progressnumberЕсли доступно- Процент выполнения. Не каждая модель сообщает прогресс.
created_at / completed_at / expires_atnumber | nullЕсли доступно- Время в Unix-секундах. expires_at — срок доступности результата, если сообщён моделью.
seconds / sizestringЕсли доступно- Длительность и размер кадра.
polling_urlstringВ ответе- Относительный путь Gateway для проверки состояния.
urlstringДля готового видео- Относительный путь /v1/videos/{id}/content. Скачивание требует авторизации.
errorobjectПри ошибке- Безопасное описание ошибки. Смотрите общий справочник ошибок.
{
"id": "ogv_v2_opaque_job_id",
"object": "video",
"model": "google/veo-3.1-lite-generate-preview",
"status": "completed",
"progress": 100,
"seconds": "4",
"polling_url": "/v1/videos/ogv_v2_opaque_job_id",
"url": "/v1/videos/ogv_v2_opaque_job_id/content"
}Заголовки ответа
x-request-idstringОтвет Gateway- ID операции для поиска в журнале и обращения в поддержку. В Chat Completions и Responses совпадает с верхнеуровневым id ответа.
Content-TypestringОтвет Gateway- application/json, text/event-stream или MIME-тип аудио/видео. Ошибки файловых методов могут возвращаться как JSON.
Retry-AfterintegerЕсли возвращён- Число секунд до рекомендуемого повтора. Отсутствие заголовка не означает, что запрос следует немедленно повторять.
Особенности
- Задача привязана к создавшему её API-ключу. ID может истечь; сохраните готовое видео до истечения срока доступности.
- При failed проверьте error. Повторный POST может привести к отдельному списанию.
Ошибки
Ошибки возвращаются в объекте error с полями message, type, code и param. Сохраните x-request-id для поиска запроса. Формат и справочник ошибок
