import sonix
client = sonix.Client(api_key="sk_live_...")
audio = client.synthesize(
text="Привет! Я твой новый ИИ-помощник.",
voice_id="ru_RU_Elena_Neural",
format="mp3",
speed=1.0
)
audio.save("hello.mp3")
Интеграция за
минуты: API и SDK
Подключите нейросетевой синтез Sonix к вашему проекту. REST API, нативные SDK для игровых движков и полная документация.
Быстрый старт
Сгенерируйте первую фразу за 30 секунд. Мы поддерживаем Python, Node.js, Go и C#.
const { SonixClient } = require('@sonix/sdk');
const client = new SonixClient({
apiKey: 'sk_live_...'
});
const audioBuffer = await client.synthesize({
text: "Привет! Я твой новый ИИ-помощник.",
voiceId: "ru_RU_Elena_Neural",
format: "wav"
});
fs.writeFileSync('hello.wav', audioBuffer);
SDK для игровых движков
Unity SDK
Встроенный компонент `SonixVoice`. Поддержка динамического изменения голоса NPC без перезагрузки сцены.
Скачать .unitypackageUnreal Engine
Blueprint и C++ интеграция. Прямая передача аудио-буфера в SoundNode для работы внутри движка.
Плагин UE5Web SDK
Работает прямо в браузере через WebAssembly. Идеально для веб-приложений и интерактивных историй.
npm install @sonix/webОсновные эндпоинты
Наш API построен на REST и использует JSON для тел запросов. Все ответы возвращаются в формате JSON, за исключением аудио-данных.
-
POST
/v1/synthesizeСинхронный генератор аудиофайла
-
GET
/v1/voicesПолучить список доступных голосов
-
POST
/v1/cloningСоздать кастомный голос
Безопасность и Лимиты
Защита от перегрузки включена по умолчанию. При превышении лимита API вернет статус 429.
Используйте заголовок `Authorization: Bearer sk_live_...` для аутентификации. Никогда не публикуйте ключи в клиентском коде.
Webhook интеграция
Для длительных процессов (например, клонирование голоса на 30 минут) используйте асинхронный режим. Мы отправим уведомление на ваш URL, когда задача будет завершена.
// Пример Webhook Payload
{
"event": "voice.cloned",
"data": {
"voice_id": "voice_8x92k",
"status": "ready",
"created_at": "2023-10-27T14:00:00Z"
}
}
Готовы к деплою?
Зарегистрируйте аккаунт разработчика и получите тестовый API ключ с лимитом 1000 запросов в минуту.