Référence des événements en temps réel

Référence · Répertorie tous les événements envoyés à l’API WebSocket Realtime Speech to Text et reçus de celle-ci.

Consultez la référence de l’API Realtime Speech to Text pour en savoir plus sur l’API et ses options.

committed_transcript est l’événement final et stable de chaque segment. L’API publique n’émet pas d’événement final_transcript distinct.

Événements envoyés

Événement	Description	Quand l’utiliser
`input_audio_chunk`	Envoyer des données audio à transcrire	En continu pendant le streaming audio

Événements reçus

Événement	Description	Moment de réception
`session_started`	Confirme la connexion et renvoie la configuration de la session	Immédiatement après l’établissement de la connexion WebSocket
`partial_transcript`	Mise à jour en direct de la transcription du segment en cours. Les résultats partiels ultérieurs remplacent les précédents. Également envoyé comme signal de maintien : `text` vide si le segment ne contient aucun texte non validé, ou répétition du dernier résultat partiel dans le cas contraire	Pendant le traitement audio, avant une validation. Également envoyé comme signal de maintien environ une fois par `keepalive_interval_ms` lorsqu’il est configuré
`committed_transcript`	Transcription finalisée d’un segment. Il s’agit du texte final et stable du segment, qui ne changera pas	Après une validation, manuelle ou déclenchée par VAD
`committed_transcript_with_timestamps`	Transcription validée avec horodatages au niveau des mots et `language_code` détecté	Envoyé après la transcription validée. Reçu uniquement lorsque `include_timestamps=true` ou `include_language_detection=true` est inclus dans les paramètres de requête
`committed_transcript_entities`	Entités détectées dans le segment de transcription validée, avec leurs décalages de caractères	Envoyé peu après chaque transcription validée. Reçu uniquement lorsque `entity_detection` est inclus dans les paramètres de requête
`edited_transcript`	Version modifiée du segment de transcription validée, accompagnée du texte validé d’origine	Envoyé peu après chaque transcription validée. Reçu uniquement lorsque `transcript_edit` est inclus dans les paramètres de requête

Gestion des erreurs

En cas d’erreur, un message d’erreur est renvoyé avant la fermeture de la connexion WebSocket.

Type d’erreur	Description
`auth_error`	Une erreur est survenue lors de l’authentification de la requête. Vérifiez votre clé API
`quota_exceeded`	Vous avez dépassé votre quota d’utilisation
`transcriber_error`	Une erreur est survenue lors de la transcription de l’audio.
`input_error`	Une erreur est survenue lors du traitement du fragment audio, probablement en raison d’un format d’entrée ou de paramètres non valides
`invalid_request`	Les paramètres de connexion ont été refusés. Vérifiez les paramètres de requête dans la référence de l’API
`error`	Erreur générique du serveur
`commit_throttled`	La validation a été limitée en raison d’un trop grand nombre de demandes de validation sur une courte période
`unaccepted_terms`	Vous n’avez pas accepté les conditions d’utilisation de Scribe. Consultez et acceptez les conditions générales dans le Dashboard ElevenLabs
`rate_limited`	Votre débit de requêtes est limité. Réduisez le nombre de requêtes effectuées sur une courte période
`queue_overflow`	La file de traitement est pleine. Envoyez moins de requêtes sur une courte période
`resource_exhausted`	Les ressources du serveur sont à pleine capacité. Réessayez plus tard
`session_time_limit_exceeded`	La durée maximale de session a été atteinte. Démarrez une nouvelle session ou effectuez un upgrade de votre abonnement
`chunk_size_exceeded`	La taille du fragment audio est trop importante. Réduisez-la
`insufficient_audio_activity`	Vous n’avez pas envoyé suffisamment d’activité audio pour maintenir la connexion