# Установка быстрого движка для Supertonic 3

SuperClonica — движок озвучки на базе Supertonic 3: быстрее на CPU и видеокарте, чище звук, совместим с JSON-файлами голосов Supertonic 3.

SuperClonica — наш движок озвучки на базе Supertonic 3. Он быстрее на CPU и видеокарте, звучит чище и работает с теми же JSON-файлами голосов.

Пакеты опубликованы на PyPI: superclonica-cpu и superclonica-gpu-cuda.

## 1. Установите пакет

Нужен Python 3.10 или новее. Поставьте один из двух пакетов: для процессора или для видеокарты NVIDIA. CUDA и cuDNN для видеокарты pip установит сам.

## 2. Скачайте голос

Откройте «Моя библиотека» и скачайте JSON голоса. Подойдут и файлы, созданные для Supertonic 3.

## 3. Озвучьте текст

Передайте путь к JSON в параметр voice. Базовая модель Supertonic 3 (около 400 МБ) загрузится при первом запуске.

## Установка

### Процессор: Windows, macOS, Linux

```
python -m pip install superclonica-cpu
```

### Видеокарта NVIDIA: Windows или Linux x86-64

Нужны Python 3.11 или новее и драйвер NVIDIA.

```
python -m pip install superclonica-gpu-cuda
```

Ставьте только один пакет: вместе они мешают друг другу. Чтобы сменить пакет, сначала удалите прежний вместе с его ONNX Runtime:

```
python -m pip uninstall -y superclonica-cpu superclonica-gpu-cuda onnxruntime onnxruntime-gpu
```

## Озвучка из Python

```
from superclonica import Superclonica

tts = Superclonica()  # GPU if available, otherwise CPU
audio, sample_rate = tts.synthesize(
    "Hello! Your new voice is ready.", voice="voice.json", lang="en", seed=7
)
tts.save("hello.wav", audio)
```

Длинные тексты, диалоги, свои голоса и сравнение с pyttsx3 и gTTS: Озвучка текста на Python.

## Озвучка из командной строки

```
superclonica --text "Hello! Your new voice is ready." --voice voice.json --lang en --output hello.wav
```

## Через Docker

Готовый образ с HTTP-сервером и командной строкой: superclonica/superclonica. Модель (около 400 МБ) скачается при первом запуске в том superclonica-models.

### Процессор

```
docker run -d -p 8000:8000 -v superclonica-models:/models superclonica/superclonica:cpu
```

### Видеокарта NVIDIA

Нужны драйвер NVIDIA и NVIDIA Container Toolkit.

```
docker run -d --gpus all -p 8000:8000 -v superclonica-models:/models superclonica/superclonica:cuda
```

### Озвучка через сервер

Голос передаётся в запросе самим JSON-файлом. Он весит около 0,3 МБ, поэтому запрос удобно собрать в файл:

```
python -c "import json; json.dump({'text': 'Hello! Your new voice is ready.', 'lang': 'en', 'voice': json.load(open('voice.json'))}, open('request.json', 'w'))"
curl -X POST localhost:8000/synthesize -H "Content-Type: application/json" -d @request.json -o hello.wav
```

Ключ API, настройки, свои голоса и запуск в продакшене: API озвучки в Docker.

## Руководства по синтезу речи

- [Как озвучить текст голосом офлайн на своём компьютере](https://superclonica.com/ru/guides/offline-text-to-speech)
- [Клонирование голоса: как получить голос, похожий на запись](https://superclonica.com/ru/guides/voice-cloning)
- [Лучшие бесплатные модели синтеза речи для локального запуска в 2026 году](https://superclonica.com/ru/guides/best-free-tts-models)
- [Озвучка текста для видео, аудиокниг, игр и приложений](https://superclonica.com/ru/guides/text-to-speech-for-videos)
- [Голоса Supertonic 3: где взять свои голоса и как ими пользоваться](https://superclonica.com/ru/guides/supertonic-3-voices)
- [Озвучка текста на Python: офлайн, бесплатно и естественными голосами](https://superclonica.com/ru/guides/python-text-to-speech)
- [Свой API для озвучки текста в Docker](https://superclonica.com/ru/guides/text-to-speech-api-docker)
- [SuperClonica](https://superclonica.com/ru/)
- [Каталог AI-голосов для озвучки текста](https://superclonica.com/ru/explore)
- [Заказ голоса по референсу для Supertonic 3](https://superclonica.com/ru/requests)
- [Как это работает: голоса, озвучка, обучение](https://superclonica.com/ru/guide)
- [Установка быстрого движка для Supertonic 3](https://superclonica.com/ru/superclonica)
- [О нас: команда энтузиастов синтеза речи](https://superclonica.com/ru/about)
- [Контакты, поддержка и жалобы на голоса](https://superclonica.com/ru/contacts)
- [Политика конфиденциальности](https://superclonica.com/ru/privacy)
- [Условия использования](https://superclonica.com/ru/terms)
- [Синтез речи](https://superclonica.com/ru/text-to-speech)