Skip to main content
POST

Авторизация

string
обязательно
Все API требуют аутентификации по Bearer TokenПолучение API-ключа:Перейдите на страницу управления API-ключами, чтобы получить свой API-ключДобавьте его в заголовок запроса:

Тело запроса

string
по умолчанию:"gpt-4o-mini-tts"
обязательно
Название модели TTSДоступные модели:
  • gpt-4o-mini-tts — модель GPT-4o Mini TTS
Пример: "gpt-4o-mini-tts"
string
обязательно
Текст для преобразования в речьМаксимальная длина: 4096 символовПример: "The quick brown fox jumps over the lazy dog."
string
обязательно
Выбор голосаДоступные голоса:
  • alloy — нейтральный, сбалансированный голос
  • echo — мужской, спокойный голос
  • fable — британский, повествовательный голос
  • onyx — мужской, низкий голос
  • nova — женский, энергичный голос
  • shimmer — женский, мягкий голос
Пример: "alloy"
string
по умолчанию:"wav"
обязательно
Формат вывода аудиоПоддерживаемые форматы:
  • wav — формат WAV без сжатия (по умолчанию)
  • opus — формат Opus, для потоковой передачи через интернет
  • aac — формат AAC
  • flac — формат FLAC, сжатие без потерь
  • pcm — формат PCM, необработанные аудиоданные
Пример: "wav"
number
по умолчанию:"1.0"
Скорость воспроизведения речиДиапазон: от 0.25 до 4.0
  • 0.25 — самая медленная скорость (1/4x)
  • 1.0 — обычная скорость (по умолчанию)
  • 4.0 — самая быстрая скорость (4x)
Пример: 1.0

Ответ

В случае успеха возвращается двоичный поток аудиоданных, который можно сохранить как аудиофайл или воспроизвести напрямую. В случае ошибки возвращается информация об ошибке в формате JSON, включая код ошибки, сообщение и тип.