Документация API

Интегрируйте Speech to Speech AI в свои приложения с помощью простого REST API.

Быстрое старт

Начни с Speech to Speech AI API через 5 минут.

Базовый URL
https://api.speechtospeechai.com/v1
1. Запустите задачу

Каждый инструмент вызывается через POST с вашим ключом API. В ответ приходит ID задачи, а не аудио.

cURL
curl -X POST https://api.speechtospeechai.com/v1/tts/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "text=Hello! Welcome to Speech to Speech AI." \
  -F "model=kokoro" \
  -F "voice_id=af_heart" \
  -F "format=mp3"

{"uuid": "3f2c...", "job_id": "...", "status": "queued"}
2. Дождитесь результата

Запрашивайте задачу каждые несколько секунд, пока status не станет completed, затем скачайте result_url.

cURL
curl "https://api.speechtospeechai.com/v1/speech/results/?uuid=3f2c..." \
  -H "Authorization: Bearer YOUR_API_KEY"

{"status": "completed", "result_url": "https://.../output.mp3"}

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

Все запросы API требуют аутентификации с помощью ключа API в Authorization Заголовок.

Заголовок
Authorization: Bearer YOUR_API_KEY
Возьми ключ от API. Счётная панель.

Голос

POST /v1/voice-clone/

Озвучивает текст голосом из короткой эталонной записи.

Запрашивающий орган (многочастные/формовые данные)
Параметр Тип Требуемо Описание
reference_audio file Выполнено Запись голоса для клонирования (рекомендуется 10-30 секунд, не более 60)
text string Выполнено Текст, который нужно произнести этим голосом
model string Нет chatterbox, openvoice, tortoise или gpt-sovits
language string Нет Код языка (по умолчанию: en)
Ответ

ID задачи (uuid). Опрашивайте GET /v1/speech/results/?uuid=, пока status не станет completed, и скачайте result_url.

Текст к речи

POST /v1/tts/

Преобразовать текст в звук речи.

Запрашивающий орган (многочастные/формовые данные)
Параметр Тип Требуемо Описание
text string Выполнено Текст для озвучивания (не более 5000 символов)
model string Нет kokoro (по умолчанию), piper, vits или bark
voice_id string Нет ID голоса из GET /v1/speech/voices/?model=
language string Нет Код языка (по умолчанию: en)
speed float Нет Множитель скорости (0,5-2,0, по умолчанию 1,0)
format string Нет wav (по умолчанию), mp3, ogg или flac. Теги SSML удаляются перед синтезом.
Ответ

ID задачи (uuid). Опрашивайте GET /v1/speech/results/?uuid=, пока status не станет completed, и скачайте result_url.

Выступление на текст

POST /v1/transcribe/

Переписать аудио на текст с помощью временных штемпелей.

Запрашивающий орган (многочастные/формовые данные)
Параметр Тип Требуемо Описание
file file Выполнено Аудио-видео файл для транскрипции
model string Нет large-v3 (по умолчанию) или turbo
language string Нет Код языка или auto для автоопределения (по умолчанию)
enable_word_timestamps bool Нет Добавить время начала и конца для каждого слова
callback_url string Нет URL, на который придёт результат через POST после завершения задачи
Ответ

ID задачи (uuid). Опрашивайте GET /v1/transcribe/results/?uuid=, пока status не станет completed; тогда ответ будет содержать text, language и segments.

Доступные модели

Модели синтеза речи
Идентификатор модели Описание Лучше всего для
kokoro Быстрое многоязычное ТТС Общее использование, низкая запоздалость
piper Легковесный многоязычный ТТС (только голоса, имеющие лицензию на коммерческую деятельность) Быстрые приемы на 11 языках
vits ЛЖСпич плюс 108 англоязычных витков ВСТК Английский акцент
bark Генерационный ТТС, 130 предварительных комплектов на 13 языках Разновидность, экспрессивная доставка (медленная)
openvoice Клонирование голоса и дополнительное преобразование голоса Альтернатива Chatterbox
chatterbox Клонирование голоса без дообучения на 23 языках; модель преобразования голоса по умолчанию Клонирование из короткого образца
Модели распознавания речи
Идентификатор модели Описание Лучше всего для
whisper-large-v3 OpenAI Whisper Large v3 Максимальная точность, многоязычность
whisper-turbo Оптимизированный шёпот для скорости Быстрое расшифровка

Коды ошибок

Код Статус Описание
invalid_api_key 401 Неверный или отсутствующий ключ API
insufficient_credits 402 Недостаточно кредитов для этой операции
rate_limit_exceeded 429 Слишком много просьб
invalid_request 400 Неудовлетворительно оформленный орган запроса
model_not_found 404 Запрошенной модели не существует.
voice_not_found 404 Запрашиваемый голос не существует
file_too_large 413 Загруженный файл превышает предел размера
server_error 500 Внутренняя ошибка сервера