Скачивание видео
Скачайте готовое видео по ID задачи через Gateway.
GET
/v1/videos/{id}/contentЗаголовки
AuthorizationBearer <API_KEY>Обязательно- Ключ компании из раздела «API-ключи». Храните на сервере или в переменной окружения. Не вставляйте секретный ключ в браузерный код.
Acceptapplication/json | text/event-streamНеобязательно- Ожидаемый формат ответа. Для включения SSE нужно также передать stream: true в JSON. Синтез речи и скачивание видео возвращают бинарные данные.
Адрес метода: https://gateway.orlime.ru/v1/videos/{id}/content
Входные параметры
idpath stringОбязательно- ID готовой видеозадачи.
Пример запроса
curl --fail-with-body https://gateway.orlime.ru/v1/videos/{id}/content \
-H "Authorization: Bearer $ORLIME_API_KEY" \
--output video.mp4Замените {id} полным ID задачи из ответа создания видео.
Ответ
Тело ответаbinaryПри успехе- Байты готового видео.
Content-TypeheaderПри успехе- video/mp4, video/webm или application/octet-stream.
x-request-idheaderВ ответе Gateway- ID операции скачивания.
errorobjectПри ошибке- JSON-ошибка вместо файла.
Успешный ответ — бинарный файл. Перед сохранением проверьте HTTP-статус и Content-Type: вместо файла может прийти JSON с ошибкой.
Заголовки ответа
x-request-idstringОтвет Gateway- ID операции для поиска в журнале и обращения в поддержку. В Chat Completions и Responses совпадает с верхнеуровневым id ответа.
Content-TypestringОтвет Gateway- application/json, text/event-stream или MIME-тип аудио/видео. Ошибки файловых методов могут возвращаться как JSON.
Retry-AfterintegerЕсли возвращён- Число секунд до рекомендуемого повтора. Отсутствие заголовка не означает, что запрос следует немедленно повторять.
Особенности
- Сначала дождитесь completed или succeeded. Для скачивания нужен тот же API-ключ.
- Не передавайте API-ключ в URL. Скачивайте видео сервером и выдавайте пользователям через своё приложение.
Ошибки
Ошибки возвращаются в объекте error с полями message, type, code и param. Сохраните x-request-id для поиска запроса. Формат и справочник ошибок
