> ## 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 vers Gradium

> Migrez vos intégrations API vocales existantes vers Gradium avec un minimum de modifications de code.

La plupart des migrations d'API vocales se résument au même petit changement :
pointer votre code de requête existant vers Gradium, envoyer votre clé API
Gradium dans l'en-tête `x-api-key`, et utiliser un `voice_id` ou un réglage de
modèle Gradium. Le vrai gain, c'est que la même API couvre la synthèse vocale
(TTS) en temps réel, la transcription (STT) en temps réel, la VAD sémantique,
le délai adaptatif, des tokens WebSocket utilisables en toute sécurité dans le
navigateur et les voix personnalisées.

Votre application peut garder la même structure :

* **POST** lorsque vous disposez déjà de l'intégralité de l'entrée.
* **WebSocket** lorsque vous voulez une entrée en streaming ou une sortie à
  faible latence.
* **Les octets audio ou les fragments en flux** reviennent aux mêmes endroits
  que ceux où votre intégration actuelle les traite déjà.
* **La VAD sémantique et le délai adaptatif** fournissent aux agents vocaux des
  signaux de gestion des tours de parole de premier ordre, sans vous obliger à
  greffer des heuristiques de détection de fin de parole.
* **Les clients navigateur** doivent utiliser des tokens Gradium à courte durée
  de vie au lieu d'embarquer des clés API. Consultez
  [WebSockets dans le navigateur](/fr/guides/browser-websockets).

<Note>
  Si vous avez déjà encapsulé ElevenLabs, Cartesia, Deepgram ou Fish Audio
  derrière un petit adaptateur de fournisseur, la migration consiste
  généralement à changer l'URL, l'en-tête d'authentification et quelques noms
  de champs.
</Note>

## Exemple POST Gradium

Pour un bloc de texte complet, envoyez une seule requête HTTP et écrivez la
réponse audio dans un fichier :

```bash theme={null}
curl -L -X POST https://api.gradium.ai/api/post/speech/tts \
  -H "x-api-key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello from Gradium.", "voice_id": "YTpq7expH9539ERJ", "output_format": "wav", "only_audio": true}' \
  > output.wav
```

C'est tout le parcours pour une synthèse vocale ponctuelle : un corps de
requête en entrée, des octets audio en sortie. Pour le schéma complet,
consultez [Synthèse vocale REST](/fr/guides/text-to-speech-rest).

## Exemple WebSocket Gradium

Pour la synthèse vocale en streaming, connectez-vous au WebSocket Gradium,
envoyez `setup` une fois, puis envoyez le texte :

```bash theme={null}
wscat -c "wss://api.gradium.ai/api/speech/tts" \
  -H "x-api-key: your_api_key"
```

Une fois la connexion ouverte, envoyez :

```json theme={null}
{"type":"setup","voice_id":"YTpq7expH9539ERJ","model_name":"default","output_format":"wav"}
{"type":"text","text":"Hello from Gradium."}
{"type":"end_of_stream"}
```

Gradium renvoie en flux des messages `audio` contenant des fragments audio
encodés en base64. Pour le contrat de messages complet, consultez
[Synthèse vocale WebSocket](/fr/guides/text-to-speech).

## Guides par fournisseur

<CardGroup cols={3}>
  <Card title="D'ElevenLabs à Gradium" icon="right-left" href="/fr/guides/migration/elevenlabs">
    Migrez vos appels TTS existants vers les endpoints REST et WebSocket de Gradium.
  </Card>

  <Card title="De Cartesia à Gradium" icon="right-left" href="/fr/guides/migration/cartesia">
    Adaptez vos adaptateurs TTS et STT aux champs de requête et aux types de messages Gradium.
  </Card>

  <Card title="De Deepgram à Gradium" icon="right-left" href="/fr/guides/migration/deepgram">
    Remplacez vos adaptateurs vocaux par le STT, le TTS, la VAD sémantique et le flush de Gradium.
  </Card>

  <Card title="De Fish Audio à Gradium" icon="right-left" href="/fr/guides/migration/fish-audio">
    Migrez vos appels TTS, de clonage de voix et d'ASR vers les API JSON de Gradium.
  </Card>
</CardGroup>

## Ce qui change généralement

| Domaine | Changement |
| - | - |
| URL de base | Utilisez `https://api.gradium.ai/api` pour REST et `wss://api.gradium.ai/api` pour les WebSockets. |
| Authentification | Envoyez `x-api-key: your_api_key`. |
| Voix TTS | Passez un `voice_id` Gradium dans le corps de la requête ou dans le message WebSocket `setup`. |
| Sortie TTS | Utilisez `output_format`, par exemple `wav`, `pcm` ou `opus`. |
| Début du streaming | Envoyez d'abord un message `setup` Gradium sur les connexions WebSocket. |
| Fin du streaming | Envoyez `{"type":"end_of_stream"}` lorsque vous avez fini d'envoyer l'entrée. |
| Authentification navigateur | Générez un token temporaire avec `GET /api/api-keys/token`, puis connectez-vous avec `?token=...`. |
| Requêtes WebSocket concurrentes | Utilisez `client_req_id` et `close_ws_on_eos: false`. |
| Gestion des tours de parole | Utilisez les messages STT `step`, `inactivity_prob`, `delay_in_frames` et `flush`. |

## Endpoints de transcription

Si vous migrez une intégration STT, appliquez la même logique avec les routes
STT :

| Flux | Endpoint Gradium |
| - | - |
| Fichier audio complet | `POST https://api.gradium.ai/api/post/speech/asr` |
| Flux audio en direct | `wss://api.gradium.ai/api/speech/asr` |

Consultez [Transcription REST](/fr/guides/speech-to-text-rest) et
[Transcription WebSocket](/fr/guides/speech-to-text) pour les formats de
messages.

## Modèles pour la production

<CardGroup cols={2}>
  <Card title="Cycle de vie WebSocket" icon="diagram-project" href="/fr/guides/websocket-lifecycle">
    Setup, ready, entrée, flush, fin de flux, multiplexage et erreurs.
  </Card>

  <Card title="WebSockets dans le navigateur" icon="browser" href="/fr/guides/browser-websockets">
    Émettez des tokens à courte durée de vie pour les clients WebSocket navigateur et mobiles.
  </Card>
</CardGroup>


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