TTS API и MCP: как подключить синтез речи к своему проекту

TTS — модель синтеза речи (text-to-speech). На NeuralSpace доступны модели: TTS, TTS HD. Все они работают через единый публичный API, а для ИИ-агентов есть готовый MCP-сервер. Ключ выдаётся на странице API-ключей. Ниже — возможности модели, примеры запросов и способ настройки.

Что умеет TTS

TTS синтезирует речь из текста и сразу возвращает ссылку на готовый аудиофайл. Доступны две модели: TTS и TTS HD (повышенное качество). Голоса — alloy, echo, fable, onyx, nova и shimmer, форматы — mp3, opus, aac, flac и wav. Цена зависит от длины текста.

Эндпоинт API

Запрос отправляется на POST /v1/audio/speech. Пример: {"model": "tts-1", "input": "Привет! Это синтез речи.", "voice": "alloy", "response_format": "mp3"}. Авторизация — по API-ключу в заголовке x-api-key. Доступные id моделей: tts-1, tts-1-hd.

MCP-инструменты

MCP-сервер NeuralSpace доступен по адресу POST /mcp (Streamable HTTP). Для работы с TTS агент использует инструменты: text_to_speech, list_models, get_balance. Это позволяет Claude Code, Cursor и другим MCP-клиентам пользоваться моделями сайта напрямую.

Как подключить

Зарегистрируйтесь на NeuralSpace, откройте API-ключей и создайте ключ формата nsk-…. Дальше передавайте его в заголовке запроса или в настройках MCP-клиента. Полная документация — на странице /v1/docs.

Частые вопросы

Какие голоса доступны?

alloy, echo, fable, onyx, nova и shimmer.

Какие форматы поддерживаются?

mp3, opus, aac, flac и wav.

Какой формат у запроса?

POST /v1/audio/speech с полями model и input.