ГлавнаяДокументация
Меню документации — Озвучка (TTS)

Озвучка (TTS)

POST /v1/audio/speech — синтез речи. OpenAI-совместимо. Для коротких текстов (< 4500 символов) ответ синхронный — бинарный mp3/wav/opus/flac.

Короткий запрос (sync)

curl https://api.ranvik.ru/v1/audio/speech \
  -H "Authorization: Bearer rk_live_..." \
  -H "Content-Type: application/json" \
  --output speech.mp3 \
  -d '{
    "model": "elevenlabs-v21-turbo",
    "input": "Привет, мир!",
    "voice": "alloy"
  }'

Длинный текст (async)

Для текстов > 4500 символов или явного "async": true возвращается task_id:

# Опрос:
curl 'https://api.ranvik.ru/v1/audio/speech?task_id=task_a1b2c3' \
  -H "Authorization: Bearer rk_live_..."

# completed → { "url": "https://cdn.ranvik.ru/aud/...mp3", ... }

Полный список TTS-моделей и голосов — на странице /models (фильтр «audio» + capability «tts»). У каждой модели свой набор контролов и голосов.