TTS API

Подключите AI-озвучку к своему сервису через REST API: создание заданий, статусы, скачивание готового аудио.

Авторизация

Все запросы — с заголовком Authorization: Bearer tm_…. Ключ создаётся в кабинете: /app → «API-ключи». Базовый URL: https://goloson.com/api.

Быстрый старт

# 1. Список доступных голосов
curl -H "Authorization: Bearer $KEY" https://goloson.com/api/voices

# 2. Создать озвучку
curl -X POST https://goloson.com/api/tts/jobs \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"voice_id":"<id>","text":"Привет, мир!","format":"mp3"}'

# 3. Дождаться статуса done
curl -H "Authorization: Bearer $KEY" https://goloson.com/api/tts/jobs/<id>

# 4. Скачать аудио
curl -L -H "Authorization: Bearer $KEY" \
  -o audio.mp3 "https://goloson.com/api/tts/jobs/<id>/download?format=mp3"

Эндпоинты

GET /voices — доступные голоса (свои + публичные).
POST /tts/jobs — создать озвучку: voice_id (обязательно), text (обязательно), language, format — mp3 (по умолчанию) или wav.
GET /tts/jobs/{id} — статус задания (queued → running → done/failed).
GET /tts/jobs?ids=a,b,c — пакетная проверка статусов (до 100 за запрос).
GET /tts/jobs/{id}/download?format=mp3|wav — скачать готовое аудио.
POST /tts/jobs/{id}/cancel — отменить задание в очереди (токены возвращаются).
GET /tts/status — доступность синтеза.

Стоимость и лимиты

Стоимость — 1 токен = 1 символ текста; токены списываются с баланса аккаунта. Создание заданий ограничено по умолчанию 12 запросами в минуту на аккаунт (лимит настраивается — напишите в поддержку, если нужно больше). Жёсткого лимита на длину текста нет — длинный текст автоматически разбивается на фрагменты.

Ответы и ошибки

Все ответы — JSON-конверт {"data": …}, ошибки — {"error": {"code", "message"}}. Важные коды: 401 — неверный ключ, 402 insufficient_tokens — не хватает токенов, 429 — превышен лимит запросов или одновременных генераций.

Примеры кода на Python и JavaScript — в кабинете: /app/docs.