Ephia Logo
Ephia Docs
Démarrage
Référence API
SDKs
Guides
Guides essentielsDépannageIndex

Dépannage

Guide de résolution des problèmes courants avec l’API Ephia Voice.

Problèmes courants

”Je ne reçois aucun événement”

Cause probable :

  • Message configure non envoyé ou envoyé après l’audio
  • Ordre des messages incorrect
  • Connexion WebSocket fermée

Solution :

  1. Vérifier que configure est le premier message envoyé
  2. Attendre la réponse configured avant d’envoyer l’audio
  3. Vérifier que la connexion WebSocket est toujours ouverte

Exemple de code correct :

ws.onopen = () => {
  // 1. Envoyer configure en premier
  ws.send(JSON.stringify({
    type: "configure",
    config: { language: "fr", specialty: "radiology" }
  }));
};
 
ws.onmessage = (event) => {
  const msg = JSON.parse(event.data);
  
  if (msg.type === "configured") {
    // 2. Attendre configured avant d'envoyer l'audio
    startAudioStreaming();
  }
};

“Mes textes changent”

Cause probable :

  • Comportement normal des transcriptions intermédiaires
  • Événements batch.replace pour corrections

Explication : Si les résultats intermédiaires sont activés, un énoncé peut évoluer tant que status="streaming" ou status="interim". Les segments avec status="final" sont confirmés mais peuvent être remplacés par un événement batch.replace.

Solution :

  • Afficher visuellement la distinction entre streaming, interim et final
  • Gérer les événements batch.replace pour remplacer les segments précédents
  • Consulter la documentation des types de transcriptions

”429 / trop de sessions”

Cause probable :

  • Rate limit dépassé
  • Limite de concurrence atteinte

Solution :

  1. Vérifier le plan actuel et les limites
  2. Réduire la concurrence (fermer les sessions inactives)
  3. Attendre le délai indiqué dans retry_after
  4. Considérer l’augmentation du plan

Voir aussi : Limites & quotas

”La connexion WebSocket se ferme immédiatement”

Cause probable :

  • Token API invalide ou expiré
  • Erreur d’authentification
  • Problème réseau

Solution :

  1. Vérifier que le token API est valide
  2. Vérifier le format du token (epk_live_...)
  3. Vérifier la connexion réseau
  4. Implémenter une stratégie de reconnexion

Voir aussi : Gestion des reconnexions

”Je ne reçois que des transcriptions vides”

Cause probable :

  • Qualité audio insuffisante
  • Format audio non supporté
  • Pas d’audio envoyé

Solution :

  1. Vérifier que l’audio est bien envoyé (logs)
  2. Vérifier le format audio (PCM 16-bit, 16kHz, mono recommandé)
  3. Vérifier le niveau audio (pas trop faible)
  4. Tester avec un fichier audio de référence

Voir aussi : Formats audio supportés

”La latence est trop élevée”

Cause probable :

  • Preset non optimisé pour la latence
  • Problème réseau
  • Qualité audio trop élevée

Solution :

  1. Utiliser le preset low_latency
  2. Désactiver enable_final_proofreading
  3. Vérifier la connexion réseau
  4. Réduire la taille des chunks audio

Voir aussi : Optimisation de la latence

”Erreur 429 fréquente”

Cause probable :

  • Rate limit dépassé régulièrement
  • Trop de requêtes par minute

Solution :

  1. Implémenter un retry avec backoff exponentiel
  2. Réduire la fréquence des requêtes
  3. Vérifier les headers X-RateLimit-Remaining
  4. Considérer l’augmentation du plan

Voir aussi : Gestion des erreurs

”Qualité audio insuffisante”

Cause probable :

  • Microphone de mauvaise qualité
  • Bruit de fond important
  • Format audio compressé

Solution :

  1. Utiliser un microphone de qualité
  2. Réduire le bruit de fond
  3. Utiliser un format non compressé (PCM, WAV)
  4. Utiliser le preset high_quality
  5. Ajouter un vocabulaire personnalisé

Voir aussi : Optimisation de la qualité

Guide de diagnostic

Checklist de vérification

Avant de contacter le support, vérifiez :

  • Le token API est valide et non expiré
  • Le message configure est envoyé en premier
  • La réponse configured est reçue avant l’envoi audio
  • Le format audio est correct (PCM 16-bit, 16kHz, mono)
  • La connexion WebSocket est stable
  • Les limites de rate limit ne sont pas dépassées
  • Le plan actuel correspond aux besoins

Logs à collecter

Pour faciliter le diagnostic, collectez :

  • Session ID : Identifiant de la session
  • Timestamp : Heure de l’erreur
  • Code d’erreur : Code retourné par l’API
  • Configuration : Paramètres utilisés
  • User-Agent : Version du SDK ou client
  • Logs réseau : Requêtes et réponses (si disponibles)

Outils de diagnostic

  • Console navigateur : Pour les erreurs JavaScript
  • Network tab : Pour inspecter les requêtes WebSocket
  • wscat : Pour tester la connexion WebSocket en ligne de commande
  • Dashboard Ephia : Pour voir les métriques et logs

Contact support

Si le problème persiste après avoir suivi ce guide :

  1. Consulter la FAQ
  2. Vérifier les codes d’erreur
  3. Contacter le support avec les informations collectées

Ressources supplémentaires

IndexIndex