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

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

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

Работа с API

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

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

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

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

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

ORLIME GATEWAY / API REFERENCE

Синтез речи

Преобразуйте текст в аудиофайл. Успешный ответ содержит байты аудио, а не JSON.

POST/v1/audio/speech
ЗаголовкиПараметрыПример запросаОтветОшибки

Заголовки #

AuthorizationBearer <API_KEY>Обязательно
Ключ компании из раздела «API-ключи». Храните на сервере или в переменной окружения. Не вставляйте секретный ключ в браузерный код.
Content-Typeapplication/jsonДля JSON-тела
Кодировка UTF-8. Для файлов используйте multipart/form-data; curl и SDK сами добавят boundary. Для GET и DELETE без тела не нужен.
Acceptapplication/json | text/event-streamНеобязательно
Ожидаемый формат ответа. Для включения SSE нужно также передать stream: true в JSON. Синтез речи и скачивание видео возвращают бинарные данные.

Адрес метода: https://gateway.orlime.ru/v1/audio/speech

Входные параметры #

modelstringОбязательно
Публичный ID из GET /v1/models. Возможности и допустимые параметры смотрите в карточке модели.
inputstringОбязательно
Текст для озвучивания. Максимальная длина зависит от модели.
voicestringОбязательно
Голос модели: например alloy для OpenAI или Kore для Gemini. Для других семейств используйте поддерживаемый VOICE_ID.
response_formatstringПо умолчанию mp3
mp3, pcm, wav, opus, aac, flac.
speednumberПри поддержке модели
Для OpenAI обычно 0.25–4; для Gemini 1, темп задавайте в instructions.
instructionsstringПри поддержке модели
Стиль и интонация, например «Говори спокойно». Не поддерживается tts-1.

Пример запроса #

cURL
curl --fail-with-body https://gateway.orlime.ru/v1/audio/speech \
  -H "Authorization: Bearer $ORLIME_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "openai/gpt-4o-mini-tts",
  "input": "Добро пожаловать в Orlime Gateway.",
  "voice": "alloy",
  "response_format": "mp3",
  "speed": 1
}' \
  --output speech.mp3

Ответ #

Тело ответаbinaryПри успехе
Аудиофайл выбранного формата.
Content-TypeheaderПри успехе
MIME аудио. Для PCM возможен application/octet-stream.
x-request-idheaderВ ответе Gateway
ID запроса для поиска в журнале.
errorobjectПри ошибке
Ошибки возвращаются как JSON; сначала проверяйте HTTP-статус и Content-Type.
Успешный ответ — бинарный файл. Перед сохранением проверьте 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Если возвращён
Число секунд до рекомендуемого повтора. Отсутствие заголовка не означает, что запрос следует немедленно повторять.

Особенности #

  • Сохраняйте ответ с расширением, соответствующим response_format. PCM — сырые сэмплы без WAV-заголовка.
  • Бинарный ответ не содержит usage.cost_rub. Итоговая стоимость доступна в «Логах» после расчёта. Этот endpoint не выдаёт SSE-события.

Ошибки #

Ошибки возвращаются в объекте error с полями message, type, code и param. Сохраните x-request-id для поиска запроса. Формат и справочник ошибок

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