Sonix.
Вход
☰
Developer Docs

API v2.0

Полное руководство по интеграции нейросетевого синтеза речи в ваши проекты. REST API для генерации аудио, управления голосами и потоковой передачи.

Текущая версия
v2.4.1 (Стабильная)
SDK & Libraries Получить ключ

Авторизация и безопасность

Sonix API использует API-ключи для аутентификации запросов. Ваш ключ является секретным идентификатором вашего проекта. Никогда не публикуйте его в открытом доступе или клиентском коде.

Использование API Key

Передавайте ваш ключ в заголовке Authorization каждого запроса:

# Пример заголовка запроса
curl -X POST https://api.sonix.ai/v2/synthesize \
  -H "Authorization: Bearer sk_live_51Mz..." \
  -H "Content-Type: application/json" \
  -d '{ "voice": "alex_deep", "text": "Привет, мир." }'

OAuth 2.0

Для приложений, требующих доступа к пользовательским данным (например, управление персональными голосами), используйте поток авторизации OAuth 2.0.

  • • Client ID: Идентификатор вашего приложения.
  • • Redirect URI: Адрес для получения кода.
  • • Scopes: voice:read, voice:write, billing:read.

🔒 Безопасность

Мы рекомендуем использовать API Keys на стороне сервера. Для клиентских приложений используйте короткоживущие токены (JWT), подписанные вашим сервером.

📊 Лимиты (Rate Limits)

По умолчанию: 60 запросов в минуту на один IP-адрес. При превышении вы получите код ошибки 429 Too Many Requests.

Основные методы (Endpoints)

Основные точки входа для взаимодействия с нейросетью Sonix.

POST /v2/synthesize

Генерация речи

Основной метод. Принимает текст и параметры голоса, возвращает URL аудиофайла или поток данных.

GET /v2/voices

Список голосов

Возвращает JSON-список всех доступных пресетов и пользовательских клонированных голосов с метаданными.

POST /v2/clone

Клонирование

Создание новой модели голоса на основе загруженных аудиофайлов. Требует авторизации уровня Admin.

Примеры запросов и ответов

Request Body (JSON)

{
  "voice_id": "ru_female_natasha_v2",
  "text": "Система инициализирована. Ожидание ввода.",
  "options": {
    "speed": 1.0,
    "pitch": 0,
    "format": "mp3_22050"
  }
}

Response (200 OK)

{
  "id": "req_8392018234",
  "status": "completed",
  "audio_url": "https://storage.sonix.ai/audio/req_8392018234.mp3",
  "duration_ms": 1450,
  "credits_used": 2
}

Коды ошибок

Код
Описание
Действие
401
Unauthorized. Неверный или отсутствующий API ключ.
Проверить ключ
403
Forbidden. Недостаточно прав или исчерпан лимит кредитов.
Пополнить баланс
422
Unprocessable Entity. Ошибка валидации JSON или параметров.
Смотреть тело ответа
429
Too Many Requests. Превышен лимит запросов в минуту.
Retry-After: 2s

Политика версионирования

Мы придерживаемся семантического версионирования (SemVer). Текущая стабильная версия API — v2.

Мы гарантируем обратную совместимость в рамках одной мажорной версии. Изменения, нарушающие совместимость (Breaking Changes), публикуются только в новой мажорной версии (например, v3).

Нужна помощь?

Если вы столкнулись с ошибкой, которую не можете исправить, или у вас есть идеи по улучшению API, свяжитесь с нами.

  • 💬
    Discord Community
    Обсуждения с другими разработчиками
  • 🐛
    GitHub Issues
    Сообщить о баге
  • 📧
    support@sonix.ai
    Техническая поддержка (SLA 4ч)