OrlimeGateway
МоделиДокументацияЗащита данныхКонтакты
Войти
Документация API

Начало работы

Быстрый стартАвторизация и заголовки

Работа с API

Потоковые ответыВызов инструментовРассуждения моделиПродолжение диалоговТокены и стоимостьОшибки и повтор запросов

Текст и данные

Список моделейGETChat CompletionsPOSTResponsesPOSTEmbeddingsPOSTРанжированиеPOSTКлассификацияPOST

Изображения, аудио и видео

Генерация изображенийPOSTСинтез речиPOSTТранскрибацияPOSTСоздание видеоPOSTСтатус видеоGETСкачивание видеоGET
Базовый адресgateway.orlime.ru/v1Открыть каталог моделей

ORLIME GATEWAY / API REFERENCE

Статус видео

Проверьте прогресс ранее созданной задачи. Интервал опроса выбирайте разумным — например, несколько секунд.

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
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При ошибке
Безопасное описание ошибки. Смотрите общий справочник ошибок.
JSON
{
  "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 для поиска запроса. Формат и справочник ошибок

Предыдущий разделСоздание видеоСледующий раздел Скачивание видео
© 2026 Orlime Gateway
ДокументацияКонтактыTelegramЗащита данныхПолитика конфиденциальностиСогласие на обработку персональных данныхПубличная офертаФайлы cookie