---
title: @synapxlab/voice — Synthèse vocale neuronale locale
source: https://synapx.fr/sdk/Voice/
site: SynapxLab
---

# Synapx Voice — synthèse vocale neuronale Markdown

Micro-service de synthèse vocale neuronale qui transforme un document Markdown structuré en fichier audio MP3.

## Présentation

`@synapxlab/voice` convertit un document Markdown en voix de synthèse locale. Le service ne lit pas seulement une suite de caractères : il interprète la structure éditoriale du document pour guider le rythme, les pauses et la prosodie.

Les titres, paragraphes, listes et citations deviennent des blocs de lecture distincts. Cette approche permet à la forme du document d'influencer le rendu vocal.

## Architecture

```text
Document Markdown
    → Rendu HTML
    → Parcours des blocs
    → Synthèse Piper
    → Assemblage MP3
```

Le service repose sur Python, FastAPI et Uvicorn. La génération vocale est assurée par Piper avec des modèles vocaux ONNX.

Le Markdown est d'abord rendu en HTML, puis parcouru bloc par bloc. Chaque bloc est synthétisé séparément avant assemblage dans un fichier audio final.

## Voix et humanisation

Deux voix françaises sont disponibles : `tom`, utilisée par défaut, et `upmc`. La vitesse standard est fixée à `1.2x`, soit 20 % plus rapide que le débit par défaut.

La lecture adapte sa vitesse selon la structure du document. Les titres ralentissent davantage selon leur niveau, les silences reçoivent un léger jitter aléatoire, et des pauses sont ajoutées après la ponctuation.

```text
h1
    → rythme plus posé
h2-h6
    → ralentissement progressif
paragraphes et listes
    → débit standard humanisé
```

Le service inclut aussi des fonctions avancées : studio, table de mixage et grammaire de prononciation SSM.

## API

L'API est asynchrone : on soumet le Markdown, on suit l'avancement du travail, puis on récupère le MP3 généré.

```http
POST /tts
Content-Type: text/markdown

# Titre
Le contenu à synthétiser.
```

```text
POST /tts            → 202 { "job_id": "…" }
GET  /tts/{job_id}   → { "status": "done", "key": "…" }
GET  /audio/{key}.mp3 → fichier audio MP3
GET  /voices         → ["tom", "upmc"]
GET  /health         → { "status": "ok" }
```

## Souveraineté

Synapx Voice fonctionne localement. Aucun texte, document ou fichier audio n'est envoyé à une API tierce.

Cette architecture offre une alternative souveraine aux services TTS cloud comme Google, Amazon ou ElevenLabs, tout en conservant le contrôle sur les documents sources et les fichiers générés.

## Ressources

- [Démonstration HTML](https://synapx.fr/sdk/Voice/)
- [Catalogue des SDK](https://synapx.fr/sdk/)
- [Index de toutes les documentations Markdown](https://synapx.fr/markdown/)