Migrer depuis ElevenLabs

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

​

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 : Utilisez l’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 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.
• Conservez votre chaîne existante d’écriture et de lecture audio.