Синтез речи

Преобразуйте текст в аудио через интерфейс OpenAI Audio Speech.

Передайте текст, голос, формат вывода и другие параметры. Тело ответа содержит двоичное аудио. Клиент должен сохранять или обрабатывать результат в соответствии с форматом вывода, указанным в запросе.

POST/v1/audio/speech

Преобразуйте входной текст в речь и получите результат в виде двоичного аудио.

Аутентификация

bearerAuth

АутентификацияBearer <token>

Используйте Bearer your-api-key в Header Authorization.

Расположение: header

Тело запроса

application/json

Параметры запроса преобразования текста в речь.

Определения типов TypeScript

Используйте тип request body в TypeScript.

model*string

ID модели преобразования текста в речь, например tts-1 или tts-1-hd. Фактически доступные модели определяются списком, возвращаемым для текущего ключа API.

Длина1 <= length

input*string

Текст для преобразования в речь, не более 4096 символов.

Длина1 <= length <= 4096

voice*string

Голос для генерации речи.

Допустимые значения

"alloy"
"ash"
"ballad"
"coral"
"echo"
"fable"
"nova"
"onyx"
"sage"
"shimmer"
"verse"
"marin"
"cedar"

instructions?string

Указания по тону, манере речи или другим характеристикам генерируемой речи.

Длинаlength <= 4096

response_format?string

Формат выходного аудио.

По умолчанию"mp3"

Допустимые значения

"mp3"
"opus"
"aac"
"flac"
"wav"
"pcm"

speed?number

Скорость генерации речи в диапазоне от 0.25 до 4.0.

Диапазон0.25 <= value <= 4

По умолчанию1

stream_format?string

Формат потокового ответа. audio возвращает двоичный аудиопоток, sse — семантические аудиособытия.

По умолчанию"audio"

Допустимые значения

"audio"
"sse"

Тело ответа

`application/json`

curl -X POST "https://example.com/v1/audio/speech" \  -H "Authorization: Bearer your-api-key" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "input": "Привет, мир!",    "voice": "alloy"  }' \  --output speech.mp3

Тело ответа не является JSON. Сохраните двоичные данные в аудиофайл в формате, указанном в запросе.

<binary audio data>

Аутентификация

Тело запроса

Тело ответа

200application/octet-stream

400application/json

401application/json

403application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`