ЦАРЬ РОУТЕР

Синтез речи

POST/v1/audio/speech

Озвучивает текст в формате OpenAI Audio. Тело ответа - аудиофайл, всё о запросе - в заголовках. Голоса и форматы каждой модели - в полях voices и audio_formats её карточки.

Параметр, которого нет у модели, и значение вне диапазона дают ошибку 400, запрос не оплачивается. Нейтральные значения проходят у всех моделей: speed: 1.0, pitch_shift: 0, пустая role. instructions не поддерживает ни одна модель, stream_format принимает только audio. Прочие поля OpenAI модель не учитывает.

Как подготовить текст под модель - в «Подготовка текста для синтеза речи».

Стоимость. Цена считается по длине input без пробелов в начале и конце: у yandex/yandex-tts - блоками по 250 символов, у vkcloud/text-to-speech и sber/salutespeech-tts - за каждый символ. Правило модели - в поле billing_rule её карточки, подробнее - в «Сколько стоит запрос».

Лимиты. Действуют общий лимит аккаунта и лимит типа моделей speech - см. «Лимиты».

Авторизация

ModelsKey
АвторизацияBearer <ключ>

Ключ типа «Вызов моделей»: Authorization: Bearer sk-tsar-ваш-ключ. Ключ «Просмотр баланса» получит 403 insufficient_scope.

Где: header

Тело запроса

application/json

Тело ответа

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl https://api.tsarrouter.ru/v1/audio/speech \  -H "Authorization: Bearer $TSARROUTER_KEY" \  -H "Content-Type: application/json" \  -d '{    "model": "yandex/yandex-tts",    "input": "Привет! Это ЦАРЬ РОУТЕР.",    "voice": "alena"  }' \  --output speech.mp3
"string"