# 安装更快的 Supertonic 3 引擎

SuperClonica 是基于 Supertonic 3 的语音合成引擎：在 CPU 和 GPU 上更快，声音更干净，兼容 Supertonic 3 音色 JSON 文件。

SuperClonica 是我们基于 Supertonic 3 打造的语音合成引擎。它在 CPU 和 GPU 上都更快，声音更干净，并且可以使用相同的音色 JSON 文件。

软件包已在 PyPI 上发布：superclonica-cpu 和 superclonica-gpu-cuda。

## 1. 安装软件包

需要 Python 3.10 或更高版本。两个包只装一个：CPU 版或 NVIDIA 显卡版。显卡版的 CUDA 和 cuDNN 由 pip 自动安装。

## 2. 下载音色

打开“我的音色库”并下载音色 JSON。为 Supertonic 3 制作的文件同样适用。

## 3. 输入文本并合成语音

将 JSON 路径传给 voice 参数。首次运行时会下载 Supertonic 3 基础模型（约 400 MB）。

## 安装

### CPU：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 MB）在首次启动时下载到 superclonica-models 卷中。

### CPU

```
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 MB，因此最好把请求写进文件：

```
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 密钥、配置、自定义音色和生产部署：Docker 文字转语音 API。

## 语音合成指南

- [如何在自己的电脑上离线把文字转成语音](https://superclonica.com/zh/guides/offline-text-to-speech)
- [声音克隆：如何得到一个像录音里那样的声音](https://superclonica.com/zh/guides/voice-cloning)
- [2026 年适合本地运行的免费语音合成模型](https://superclonica.com/zh/guides/best-free-tts-models)
- [为视频、有声书、游戏和应用做文字转语音配音](https://superclonica.com/zh/guides/text-to-speech-for-videos)
- [Supertonic 3 音色：自定义音色的来源与使用方法](https://superclonica.com/zh/guides/supertonic-3-voices)
- [Python 文字转语音：离线、免费、自然的音色](https://superclonica.com/zh/guides/python-text-to-speech)
- [在 Docker 中自建文字转语音 API](https://superclonica.com/zh/guides/text-to-speech-api-docker)
- [SuperClonica](https://superclonica.com/zh/)
- [文字转语音 AI 声音目录](https://superclonica.com/zh/explore)
- [Supertonic 3 定制音色委托](https://superclonica.com/zh/requests)
- [工作原理：音色、本地语音、训练](https://superclonica.com/zh/guide)
- [安装更快的 Supertonic 3 引擎](https://superclonica.com/zh/superclonica)
- [关于我们：语音合成爱好者团队](https://superclonica.com/zh/about)
- [联系方式、支持与音色投诉](https://superclonica.com/zh/contacts)
- [隐私政策](https://superclonica.com/zh/privacy)
- [使用条款](https://superclonica.com/zh/terms)
- [语音合成](https://superclonica.com/zh/text-to-speech)