Документация API
Интегрируйте Speech to Speech AI в свои приложения с помощью простого REST API.
Быстрое старт
Начни с Speech to Speech AI API через 5 минут.
Базовый URL
https://api.speechtospeechai.com/v1
1. Запустите задачу
Каждый инструмент вызывается через POST с вашим ключом API. В ответ приходит ID задачи, а не аудио.
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 "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
Голос
/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.
Текст к речи
/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.
Выступление на текст
/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 | Внутренняя ошибка сервера |