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

# Migrer depuis ElevenLabs

> Remplacez vos appels TTS ElevenLabs par les endpoints REST et WebSocket de Gradium.

Si votre application envoie déjà du texte à un fournisseur et écrit l'audio
renvoyé dans un fichier ou un flux, la migration est volontairement légère : remplacez
l'endpoint par celui de Gradium, envoyez votre clé API Gradium dans `x-api-key` et
utilisez un `voice_id` Gradium. La chaîne de lecture peut généralement rester inchangée.

## Changement d'endpoint

| Flux | Intégration existante | Gradium |
| - | - | - |
| TTS en une seule requête | `POST https://api.elevenlabs.io/v1/text-to-speech/{voice_id}` | `POST https://api.gradium.ai/api/post/speech/tts` |
| TTS en streaming | `wss://api.elevenlabs.io/v1/text-to-speech/{voice_id}/stream-input` | `wss://api.gradium.ai/api/speech/tts` |

## Correspondance des requêtes

Pour les requêtes POST, le changement le plus important est que Gradium reçoit la
voix dans le corps JSON et non dans le chemin de l'URL :

| Concept existant | Champ Gradium |
| - | - |
| Paramètre de chemin `{voice_id}` | `voice_id` |
| `text` | `text` |
| `model_id` | `model_name` |
| Paramètres de format de sortie (query ou corps) | `output_format` |
| En-tête de clé API du fournisseur | En-tête `x-api-key` |

Utilisez l'[exemple POST Gradium](/fr/guides/migration#exemple-post-gradium)
comme requête de remplacement. Il renvoie les octets audio bruts lorsque
`only_audio` vaut `true` : le code existant qui « enregistre le corps de la réponse comme audio »
peut donc rester inchangé.

## Correspondance WebSocket

Pour le TTS en streaming, le cycle de vie Gradium est le suivant :

1. Connectez-vous à `wss://api.gradium.ai/api/speech/tts`.
2. Envoyez un message `setup` avec `voice_id`, `model_name` et `output_format`.
3. Envoyez un ou plusieurs messages `text`.
4. Envoyez `end_of_stream`.
5. Lisez les messages `audio` jusqu'à ce que Gradium envoie `end_of_stream`.

Utilisez l'[exemple WebSocket Gradium](/fr/guides/migration#exemple-websocket-gradium)
comme remplacement minimal. Votre boucle de réception doit continuer à mettre en tampon
les fragments audio au même endroit que l'audio du fournisseur.

## Checklist

* Remplacez l'URL du fournisseur par l'endpoint Gradium.
* Passez l'authentification à `x-api-key`.
* Déplacez l'identifiant de voix du chemin de l'URL vers `voice_id`.
* Utilisez un identifiant de voix Gradium issu de la [bibliothèque de voix](/fr/guides/voices/flagship-voices).
* Conservez votre chaîne existante d'écriture et de lecture audio.

<Card title="Guide REST du TTS Gradium" icon="file-lines" href="/fr/guides/text-to-speech-rest">
  Schéma POST complet, modes de réponse et formats de sortie pris en charge.
</Card>


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