# 高速な 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以降が必要です。2つのパッケージのどちらか1つを入れてください：CPU用かNVIDIA GPU用です。GPU用では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 GPU：WindowsまたはLinux x86-64

Python 3.11以降とNVIDIAドライバーが必要です。

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

パッケージは1つだけ入れてください。両方あると互いに干渉します。切り替えるときは、先に以前のものを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 GPU

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。

## 音声合成ガイド

- [自分のPCでテキストをオフライン読み上げする方法](https://superclonica.com/ja/guides/offline-text-to-speech)
- [ボイスクローン：録音の声に近い音声を手に入れる方法](https://superclonica.com/ja/guides/voice-cloning)
- [2026年、ローカルで使える無料の音声合成モデル](https://superclonica.com/ja/guides/best-free-tts-models)
- [動画、オーディオブック、ゲーム、アプリのテキスト読み上げ](https://superclonica.com/ja/guides/text-to-speech-for-videos)
- [Supertonic 3 の音声：カスタム音声の入手先と使い方](https://superclonica.com/ja/guides/supertonic-3-voices)
- [Pythonで音声合成：オフライン・無料・自然な声で](https://superclonica.com/ja/guides/python-text-to-speech)
- [Dockerで動かすセルフホスト音声合成API](https://superclonica.com/ja/guides/text-to-speech-api-docker)
- [SuperClonica](https://superclonica.com/ja/)
- [テキスト読み上げ用AI音声カタログ](https://superclonica.com/ja/explore)
- [Supertonic 3 カスタム音声の依頼](https://superclonica.com/ja/requests)
- [仕組み：音声、ローカル合成、学習](https://superclonica.com/ja/guide)
- [高速な Supertonic 3 エンジンのインストール](https://superclonica.com/ja/superclonica)
- [私たちについて：音声合成が好きなチーム](https://superclonica.com/ja/about)
- [お問い合わせ・サポート・音声の通報](https://superclonica.com/ja/contacts)
- [プライバシーポリシー](https://superclonica.com/ja/privacy)
- [利用規約](https://superclonica.com/ja/terms)
- [音声合成](https://superclonica.com/ja/text-to-speech)