Skip to main content
N’embarquez jamais une clé API Gradium dans du code navigateur ou mobile. Les bundles navigateur peuvent être inspectés, et toute personne qui extrait la clé peut dépenser les crédits de votre compte. À la place, votre serveur doit échanger sa clé API contre un token Gradium éphémère à usage unique, puis transmettre ce token au client authentifié. Le client se connecte à l’endpoint WebSocket avec ?token=....

Déroulement

Générer un token

Générez le token depuis du code serveur de confiance :
La réponse contient le token et son horodatage d’expiration :
La durée de vie exacte est fixée par le serveur. Lisez expires_at et créez un nouveau token pour chaque nouvelle connexion WebSocket. Un token est consommé dès sa vérification : ne le réutilisez donc pas pour les reconnexions.

Exemple côté serveur

Exemple TTS dans le navigateur

Remarques sur le STT dans le navigateur

Pour le streaming depuis le micro :
  • Utilisez AudioWorklet ou MediaStreamTrackProcessor pour capturer l’audio.
  • Convertissez l’audio en PCM mono 16 bits.
  • Définissez input_format sur la fréquence d’échantillonnage réellement envoyée, par exemple pcm_16000, pcm_24000 ou pcm_48000.
  • Envoyez de petits fragments, d’environ 80 à 100 ms, pour réduire la latence.
Consultez Du micro du navigateur au STT pour un squelette complet.

Checklist de sécurité

  • Conservez GRADIUM_API_KEY uniquement sur votre serveur.
  • Authentifiez l’utilisateur avant d’émettre un token.
  • Émettez un token par connexion WebSocket.
  • Ne journalisez pas les tokens dans vos outils d’analytics ni dans la console du navigateur.
  • En cas de reconnexion, demandez un nouveau token à votre serveur avant d’ouvrir le socket suivant.

Étapes suivantes

Cycle de vie du WebSocket

Setup, ready, entrée, flush, fin, multiplexage et erreurs.

Du micro du navigateur au STT

Capturez l’audio du micro et envoyez-le en flux à Gradium.