{"kind":"guides","slug":"python-text-to-speech","path":"/guides/python-text-to-speech","title":"Synthèse vocale en Python, hors ligne | SuperClonica","description":"Faire parler un texte en Python sans Internet : pyttsx3, gTTS et modèles neuronaux comparés, puis du code qui marche avec pip, des voix et Docker.","h1":"Synthèse vocale en Python : hors ligne, gratuite et avec des voix naturelles","intro":"Python offre plusieurs façons de transformer un texte en parole. Certaines bibliothèques lisent avec les voix robotiques du système, d'autres envoient votre texte à un service en ligne, et d'autres font tourner un modèle neuronal sur votre propre ordinateur. Ces dernières sonnent aujourd'hui presque comme un humain tout en fonctionnant sans Internet.\n\nCe guide compare les options, puis montre du code fonctionnel pour le moteur SuperClonica, un paquet pip fondé sur le modèle ouvert Supertonic 3 : installation, premier script, voix personnalisées, textes longs et API HTTP locale dans Docker. Le moteur est le nôtre, nous le signalons donc quand il est question de nous.","sections":[{"heading":"Les façons de faire de la synthèse vocale en Python","paragraphs":["Avant de choisir une bibliothèque, tranchez deux questions : votre texte peut-il quitter l'ordinateur, et à quel point la voix doit-elle sembler naturelle ?"],"points":["pyttsx3 pilote le moteur vocal intégré au système : SAPI5 sous Windows, NSSpeechSynthesizer sous macOS et eSpeak sous Linux. Il fonctionne hors ligne et s'installe en quelques secondes, mais les voix sonnent robotiques et changent d'une machine à l'autre.","gTTS envoie le texte au service vocal de Google Traduction et enregistre un MP3. Le son est plus clair, mais il faut Internet, on choisit des langues et des accents plutôt que des voix, et c'est une interface non officielle qui peut cesser de fonctionner.","Les API cloud de Google, Amazon, Microsoft ou ElevenLabs sonnent très bien, mais elles demandent un compte et une clé, se paient au caractère et envoient chaque texte au fournisseur.","Les modèles neuronaux locaux comme Supertonic 3, Kokoro et Piper tournent sur votre propre CPU ou GPU. Après un unique téléchargement du modèle, ils fonctionnent hors ligne, ne coûtent rien au caractère et sonnent bien plus naturel que les voix système. Nos pages de comparaison les détaillent."]},{"heading":"Installer le moteur SuperClonica","paragraphs":["Le moteur est un seul paquet pip en deux versions. Pour n'importe quel CPU sous Windows, macOS ou Linux avec Python 3.10 ou plus récent : python -m pip install superclonica-cpu. Pour un GPU NVIDIA sous Windows ou Linux avec Python 3.11 ou plus récent : python -m pip install superclonica-gpu-cuda. N'installez que l'un des deux par environnement ; tous deux fournissent le même module superclonica.","La version GPU apporte CUDA et cuDNN via pip : il suffit d'un pilote NVIDIA compatible CUDA 12, et sans GPU fonctionnel elle bascule sur le CPU. Au premier lancement, le modèle Supertonic 3, environ 385 Mo, est téléchargé une seule fois dans ~/.cache/supertonic3. Définissez SUPERTONIC_CACHE_DIR pour le placer ailleurs."]},{"heading":"Votre premier script","paragraphs":["Importez le moteur, synthétisez une phrase et enregistrez-la : from superclonica import Superclonica, puis tts = Superclonica(), audio, sample_rate = tts.synthesize(\"Bonjour, cette voix tourne sur mon propre ordinateur.\", voice=\"F1\", lang=\"fr\", seed=7) et tts.save(\"bonjour.wav\", audio). Le modèle est livré avec dix voix, de M1 à M5 et de F1 à F5, qui ne demandent aucun fichier supplémentaire.","Créez le moteur une fois et réutilisez-le : le chargement prend quelques secondes, chaque phrase suivante une fraction de seconde. Dans nos mesures, une phrase courte a pris en médiane 0,12 s sur une RTX 5070 Ti et 0,43 s sur un Ryzen 7 5800X avec quatre threads."]},{"heading":"Utiliser une voix personnalisée","paragraphs":["Une voix Supertonic 3 est un fichier JSON d'environ 0,3 Mo. Des voix gratuites avec extraits audio se trouvent dans le dépôt superclonica/supertonic-voices sur GitHub, et le catalogue SuperClonica en propose plus de 170 autres, des personnages de jeux aux narrateurs, chacune avec une démo en ligne gratuite.","Passez le fichier au lieu d'un nom de préréglage : tts.synthesize(\"Bonjour à tous.\", voice=\"ciri.json\", lang=\"fr\", seed=7). En ligne de commande : superclonica --text \"Bonjour à tous.\" --voice ciri.json --lang fr --output bonjour.wav. Chaque voix parle les 31 langues du modèle ; réglez lang sur la langue du texte, par exemple en, de, es ou ja. Le chinois n'est pas pris en charge."]},{"heading":"Textes longs, dialogues et formats de fichier","paragraphs":["Quelques options couvrent la plupart des projets réels."],"points":["Un texte long, comme un chapitre, passe en un seul appel : le moteur le découpe en morceaux naturels de 160 caractères au plus, ce qui évite les mots répétés ou avalés.","normalize=True égalise le volume à −18 LUFS, utile quand vous assemblez de nombreux fichiers.","tts.synthesize_batch() fait parler plusieurs lignes à la fois, chacune avec sa voix, par exemple les répliques d'un dialogue ; les résultats gardent l'ordre d'entrée.","Le même texte avec la même voix et la même graine redonne le même audio : vous pouvez refaire une ligne sans toucher au reste.","Les nombres sont prononcés en toutes lettres, les abréviations courantes des messageries sont développées, et les emoji ou symboles inconnus sont nettoyés au lieu de provoquer une erreur.","tts.save() écrit du WAV, du FLAC ou de l'OGG selon l'extension du fichier."]},{"heading":"La synthèse vocale en API HTTP locale","paragraphs":["Si le programme qui a besoin de parole n'est pas écrit en Python, lancez le moteur dans Docker : docker run -d -p 8000:8000 -v superclonica-models:/models superclonica/superclonica:cpu, ou le tag cuda avec --gpus all sur un GPU NVIDIA. Le modèle se télécharge dans le volume au premier démarrage.","Envoyez POST /synthesize avec un JSON contenant le texte, la langue et le contenu du fichier de voix, et vous recevez un WAV. Une voix pèse environ 0,3 Mo : construisez donc la requête dans un fichier et envoyez-la avec curl -d @request.json."]},{"heading":"Licences et usage responsable","paragraphs":["Supertonic 3 est publié sous OpenRAIL-M, une licence libre de redevances avec une liste d'usages interdits plutôt qu'une clause non commerciale. N'utilisez pas la parole pour vous faire passer pour quelqu'un sans son consentement, pour tromper ou pour harceler, et indiquez que l'audio est généré par machine quand cela compte.","Certaines voix du catalogue s'inspirent de personnes connues. Ce ne sont pas leurs vraies voix : ne présentez donc pas cet audio comme leurs propres paroles."]}],"faq":[{"question":"Comment faire de la synthèse vocale en Python sans Internet ?","answer":"Utilisez une bibliothèque qui tourne sur votre ordinateur : pyttsx3 pour les voix du système, ou un modèle neuronal local pour une parole naturelle. Avec le moteur SuperClonica, installez superclonica-cpu avec pip ; une fois le modèle téléchargé, tout fonctionne hors ligne."},{"question":"Lequel est le meilleur, pyttsx3 ou gTTS ?","answer":"pyttsx3 fonctionne hors ligne avec les voix du système, qui sonnent robotiques ; gTTS sonne plus clair mais envoie le texte à Google par Internet. Un modèle neuronal local comme Supertonic 3 offre une parole naturelle sans Internet."},{"question":"Faut-il un GPU ?","answer":"Non. superclonica-cpu tourne sur un CPU ordinaire sous Windows, macOS et Linux, et une phrase courte prend bien moins d'une seconde. Un GPU NVIDIA est plusieurs fois plus rapide et aide pour les gros volumes."},{"question":"Puis-je utiliser la parole générée à des fins commerciales ?","answer":"La licence de Supertonic 3, OpenRAIL-M, est libre de redevances et sans clause non commerciale ; elle énumère des usages interdits, comme se faire passer pour quelqu'un sans son consentement. Les voix inspirées de personnes connues ne doivent pas être présentées comme leurs vraies paroles."}],"cta":{"catalog":"Voir des voix pour votre projet Python","install":"Installer le moteur SuperClonica"},"sources":[{"label":"pyttsx3 (PyPI)","url":"https://pypi.org/project/pyttsx3/"},{"label":"Documentation de gTTS","url":"https://gtts.readthedocs.io/"},{"label":"Moteur SuperClonica (PyPI)","url":"https://pypi.org/project/superclonica-cpu/"},{"label":"Fiche du modèle Supertonic 3 (Hugging Face)","url":"https://huggingface.co/supertone-oss-archive/supertonic-3"},{"label":"Voix Supertonic 3 gratuites (GitHub)","url":"https://github.com/superclonica/supertonic-voices"},{"label":"Image Docker SuperClonica (Docker Hub)","url":"https://hub.docker.com/r/superclonica/superclonica"}],"published":"2026-10-22","updated":"2026-10-22","pages":[{"slug":"offline-text-to-speech","path":"/guides/offline-text-to-speech","h1":"Convertir un texte en voix hors ligne sur votre ordinateur"},{"slug":"voice-cloning","path":"/guides/voice-cloning","h1":"Clonage de voix : obtenir une voix proche d’un enregistrement"},{"slug":"best-free-tts-models","path":"/guides/best-free-tts-models","h1":"Les meilleurs modèles de synthèse vocale gratuits pour un usage local en 2026"},{"slug":"text-to-speech-for-videos","path":"/guides/text-to-speech-for-videos","h1":"Synthèse vocale pour vidéos, livres audio, jeux et applications"},{"slug":"supertonic-3-voices","path":"/guides/supertonic-3-voices","h1":"Voix Supertonic 3 : où trouver des voix personnalisées et comment les utiliser"},{"slug":"python-text-to-speech","path":"/guides/python-text-to-speech","h1":"Synthèse vocale en Python : hors ligne, gratuite et avec des voix naturelles"},{"slug":"text-to-speech-api-docker","path":"/guides/text-to-speech-api-docker","h1":"API de synthèse vocale auto-hébergée dans Docker"}],"related":[{"slug":"text-to-speech","path":"/text-to-speech","h1":"Une synthèse vocale qui tourne sur votre propre ordinateur"},{"slug":"supertonic","path":"/compare/supertonic","h1":"Supertonic vs SuperClonica : le même modèle, plus rapide et plus net"},{"slug":"fish-audio","path":"/compare/fish-audio","h1":"Fish Audio et Fish Speech face à SuperClonica"},{"slug":"omnivoice","path":"/compare/omnivoice","h1":"OmniVoice ou SuperClonica : plus de langues ou plus de vitesse"},{"slug":"qwen3-tts","path":"/compare/qwen3-tts","h1":"Qwen3-TTS ou SuperClonica pour une synthèse vocale locale"},{"slug":"voxcpm","path":"/compare/voxcpm","h1":"VoxCPM 2 ou SuperClonica : son studio ou vitesse sur CPU"},{"slug":"f5-tts","path":"/compare/f5-tts","h1":"F5-TTS ou SuperClonica : clonage zero-shot ou synthèse rapide sur CPU"},{"slug":"elevenlabs","path":"/compare/elevenlabs","h1":"Une alternative hors ligne à ElevenLabs"},{"slug":"kokoro","path":"/compare/kokoro","h1":"Kokoro TTS ou SuperClonica : deux petits modèles de synthèse vocale locale"},{"slug":"piper","path":"/compare/piper","h1":"Piper TTS ou SuperClonica : petits appareils ou voix sur mesure"},{"slug":"xtts","path":"/compare/xtts","h1":"Coqui XTTS-v2 ou SuperClonica : une alternative à Coqui TTS"},{"slug":"chatterbox","path":"/compare/chatterbox","h1":"Chatterbox TTS ou SuperClonica : clonage instantané ou fichier de voix entraîné"}]}