Синтез речи
Преобразуйте текст в аудиофайл. Успешный ответ содержит байты аудио, а не 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 --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 для поиска запроса. Формат и справочник ошибок
