> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gradium.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Vue d'ensemble de la synthèse vocale (TTS)

> Quand utiliser l'API WebSocket plutôt que l'endpoint REST, et comment les éléments s'articulent

Gradium expose la synthèse vocale via deux transports. Ils partagent les mêmes
modèles et les mêmes voix ; vous choisissez le transport adapté à la forme de
votre entrée et à vos besoins de latence.

## WebSocket ou REST

| Si votre texte est... | Utilisez | Pourquoi |
| - | - | - |
| Reçu en flux, token par token (sortie de LLM, boucle d'agent, interface en direct) | [WebSocket](/fr/guides/text-to-speech) | Latence du premier octet la plus faible. Envoyez le texte au fil de l'eau ; les fragments audio reviennent dès qu'ils sont générés. |
| Un bloc déjà complet (article, réplique scriptée, traitement par lots) | [REST](/fr/guides/text-to-speech-rest) | Un seul appel HTTP, aucune connexion à gérer. Enregistrez le corps de la réponse dans un fichier, et c'est terminé. |
| De nombreuses requêtes de synthèse simultanées | [WebSocket + multiplexage](/fr/guides/multiplexing) | Exécutez plusieurs requêtes sur un seul socket, associées par `client_req_id`. |
| De l'audio pour une application navigateur ou mobile | [WebSockets dans le navigateur](/fr/guides/browser-websockets) | Utilisez des tokens à courte durée de vie au lieu d'exposer une clé API. |

En cas de doute, commencez par REST. Il suffit d'un POST, et le corps de la
réponse est l'audio. Passez au WebSocket lorsque la latence ou le besoin d'une
entrée en streaming font de REST le goulot d'étranglement.

## Ce que les deux transports ont en commun

* **Voix** : n'importe quel `voice_id` de la [bibliothèque de voix](/fr/guides/voices/overview) fonctionne sur les deux. Les candidats [Voice Design](/fr/guides/voices/voice-design) font exception : REST uniquement, jusqu'à leur conversion.
* **Formats de sortie** : PCM, WAV, Opus et les codecs de téléphonie (`ulaw_8000`, `alaw_8000`).
* **Paramètres de voix** : `temp`, `padding_bonus` et `rewrite_rules`, tous passés dans `json_config`. Consultez [Paramètres de voix](/fr/guides/voice-settings).

## Ce qui est propre à chaque transport

* **Les balises `<flush>` et `<break time="..." />`** sont traitées par le modèle sur les deux transports, mais ne sont vraiment utiles que lorsque vous envoyez le texte en flux via le WebSocket.
* **WebSocket uniquement** : contrôles du flux dans le message de setup (`send_setup_on_start`, `wait_for_ready_on_start`), multiplexage, `flush` en cours de flux, tokens navigateur, dictionnaires de prononciation (`pronunciation_id`). Consultez [Cycle de vie WebSocket](/fr/guides/websocket-lifecycle). En REST, utilisez `rewrite_rules` dans `json_config` pour contrôler la prononciation.
* **REST uniquement** : l'option `only_audio`, pour choisir entre des octets audio bruts et un flux NDJSON qui reproduit le protocole WebSocket.

## Étapes suivantes

<CardGroup cols={2}>
  <Card title="Utiliser l'API WebSocket" icon="waveform-lines" href="/fr/guides/text-to-speech">
    Utilisation via le SDK ou directement en WebSocket, sortie en streaming, flush, horodatages.
  </Card>

  <Card title="Utiliser l'API REST" icon="file-lines" href="/fr/guides/text-to-speech-rest">
    Synthèse ponctuelle avec un seul POST HTTP.
  </Card>

  <Card title="Du LLM au TTS" icon="message-lines" href="/fr/guides/recipes/llm-to-tts">
    Envoyez en flux le texte généré vers le TTS tout en préservant une prosodie naturelle.
  </Card>

  <Card title="Paramètres de voix" icon="sliders" href="/fr/guides/voice-settings">
    Vitesse, température et règles de réécriture.
  </Card>

  <Card title="Bibliothèque de voix" icon="user-music" href="/fr/guides/voices/overview">
    Parcourez les voix phares ou créez vos propres clones.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.