# 더 빠른 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 GPU용. GPU용은 pip가 CUDA와 cuDNN도 함께 설치합니다.

## 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
```

패키지는 하나만 설치하세요. 함께 있으면 서로 방해합니다. 바꾸려면 먼저 이전 패키지를 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와의 비교: 파이썬 음성 합성.

## 명령줄에서 음성 합성

```
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.

## 음성 합성 가이드

- [내 컴퓨터에서 오프라인으로 텍스트를 음성으로 바꾸는 방법](https://superclonica.com/ko/guides/offline-text-to-speech)
- [목소리 복제: 녹음과 비슷한 목소리를 얻는 방법](https://superclonica.com/ko/guides/voice-cloning)
- [2026년 로컬에서 쓸 수 있는 무료 음성 합성 모델](https://superclonica.com/ko/guides/best-free-tts-models)
- [영상, 오디오북, 게임, 앱을 위한 음성 합성](https://superclonica.com/ko/guides/text-to-speech-for-videos)
- [Supertonic 3 목소리: 커스텀 목소리를 구하는 곳과 사용법](https://superclonica.com/ko/guides/supertonic-3-voices)
- [파이썬 텍스트 음성 변환: 오프라인, 무료, 자연스러운 목소리로](https://superclonica.com/ko/guides/python-text-to-speech)
- [Docker로 직접 운영하는 음성 합성 API](https://superclonica.com/ko/guides/text-to-speech-api-docker)
- [SuperClonica](https://superclonica.com/ko/)
- [텍스트 읽기용 AI 목소리 카탈로그](https://superclonica.com/ko/explore)
- [Supertonic 3 커스텀 목소리 의뢰](https://superclonica.com/ko/requests)
- [작동 방식: 목소리, 로컬 음성 합성, 학습](https://superclonica.com/ko/guide)
- [더 빠른 Supertonic 3 엔진 설치](https://superclonica.com/ko/superclonica)
- [소개: 음성 합성을 사랑하는 팀](https://superclonica.com/ko/about)
- [연락처, 지원 및 목소리 신고](https://superclonica.com/ko/contacts)
- [개인정보 처리방침](https://superclonica.com/ko/privacy)
- [이용약관](https://superclonica.com/ko/terms)
- [음성 합성](https://superclonica.com/ko/text-to-speech)