# Installer le moteur rapide pour Supertonic 3

Moteur de synthèse vocale basé sur Supertonic 3: plus rapide sur CPU et GPU, un son plus net, compatible avec les JSON de voix Supertonic 3.

SuperClonica est notre moteur de synthèse vocale basé sur Supertonic 3. Il est plus rapide sur CPU et GPU, offre un son plus net et utilise les mêmes fichiers JSON de voix.

Les paquets sont publiés sur PyPI: superclonica-cpu et superclonica-gpu-cuda.

## 1. Installez le paquet

Python 3.10 ou plus récent est requis. Installez l’un des deux paquets: pour le processeur ou pour un GPU NVIDIA. Pour le GPU, pip installe lui-même CUDA et cuDNN.

## 2. Téléchargez une voix

Ouvrez « Ma bibliothèque » et téléchargez le JSON de la voix. Les fichiers créés pour Supertonic 3 conviennent aussi.

## 3. Convertissez le texte en audio

Passez le chemin du JSON au paramètre voice. Le modèle de base Supertonic 3 (environ 400 Mo) est téléchargé au premier lancement.

## Installation

### Processeur: Windows, macOS, Linux

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

### GPU NVIDIA: Windows ou Linux x86-64

Python 3.11 ou plus récent et un pilote NVIDIA sont requis.

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

N’installez qu’un seul paquet: ensemble, ils se gênent. Pour changer, désinstallez d’abord le précédent avec son ONNX Runtime:

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

## Synthèse vocale depuis 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)
```

Textes longs, dialogues, voix personnalisées et comparaison avec pyttsx3 et gTTS: Synthèse vocale en Python.

## Synthèse vocale en ligne de commande

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

## Avec Docker

Une image prête avec un serveur HTTP et la ligne de commande: superclonica/superclonica. Le modèle (environ 400 Mo) se télécharge au premier démarrage dans le volume superclonica-models.

### Processeur

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

### GPU NVIDIA

Nécessite le pilote NVIDIA et NVIDIA Container Toolkit.

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

### Synthèse vocale via le serveur

La voix est transmise dans la requête sous forme du fichier JSON lui-même. Il pèse environ 0,3 Mo, il vaut donc mieux préparer la requête dans un fichier:

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

Clé d’API, réglages, voix personnalisées et mise en production: API de synthèse vocale dans Docker.

## Guides de synthèse vocale

- [Convertir un texte en voix hors ligne sur votre ordinateur](https://superclonica.com/fr/guides/offline-text-to-speech)
- [Clonage de voix : obtenir une voix proche d’un enregistrement](https://superclonica.com/fr/guides/voice-cloning)
- [Les meilleurs modèles de synthèse vocale gratuits pour un usage local en 2026](https://superclonica.com/fr/guides/best-free-tts-models)
- [Synthèse vocale pour vidéos, livres audio, jeux et applications](https://superclonica.com/fr/guides/text-to-speech-for-videos)
- [Voix Supertonic 3 : où trouver des voix personnalisées et comment les utiliser](https://superclonica.com/fr/guides/supertonic-3-voices)
- [Synthèse vocale en Python : hors ligne, gratuite et avec des voix naturelles](https://superclonica.com/fr/guides/python-text-to-speech)
- [API de synthèse vocale auto-hébergée dans Docker](https://superclonica.com/fr/guides/text-to-speech-api-docker)
- [SuperClonica](https://superclonica.com/fr/)
- [Catalogue de voix IA pour la synthèse vocale](https://superclonica.com/fr/explore)
- [Commandes de voix personnalisées](https://superclonica.com/fr/requests)
- [Guide: voix, TTS local et entraînement](https://superclonica.com/fr/guide)
- [Installer le moteur rapide pour Supertonic 3](https://superclonica.com/fr/superclonica)
- [À propos: des passionnés de synthèse vocale](https://superclonica.com/fr/about)
- [Contact, support et signalement de voix](https://superclonica.com/fr/contacts)
- [Politique de confidentialité](https://superclonica.com/fr/privacy)
- [Conditions d'utilisation](https://superclonica.com/fr/terms)
- [Synthèse vocale](https://superclonica.com/fr/text-to-speech)