Справочник API
Audio Speech
Синтез речи из текста
POST
/v1/audio/speechСоздаёт аудио с речью из текста.
Советы
- Передавайте чистый текст без служебных пометок.
- Для длинных материалов разбивайте текст на фрагменты.
- Проверяйте, какие голоса и форматы поддерживает выбранная модель.
Пример запроса
curl {{PUBLIC_API_BASE_URL}}/audio/speech \
-H "Authorization: Bearer gw_live_..." \
-H "Content-Type: application/json" \
-d '{
"model": "provider/speech-model",
"voice": "default",
"input": "Добро пожаловать в Gateway."
}' \
--output speech.mp3Параметры тела запроса
| Поле | Обязательность | Описание |
|---|---|---|
model | Да | Публичное имя speech-модели. |
input | Да | Текст для озвучивания. |
voice | Да | Голос, если модель требует явный выбор. |
response_format | Нет | Формат аудио. |
speed | Нет | Скорость речи, если поддерживается. |
Поля ответа
Ответ обычно возвращает бинарный аудиофайл. Заголовок Content-Type зависит от выбранного формата, например audio/mpeg.
Пример ответа
HTTP/1.1 200 OK
Content-Type: audio/mpeg
<binary audio>