Echtzeit-Ereignisreferenz | ElevenLabs Documentation

Referenz · Listet alle Ereignisse auf, die an die WebSocket-API für Echtzeit-Spracherkennung gesendet und von ihr empfangen werden.

Weitere Informationen zur API und ihren Optionen finden Sie in der API-Referenz für die API für Echtzeit-Spracherkennung.

committed_transcript ist das stabile, finale Ereignis für jedes Segment. Die öffentliche API gibt kein separates final_transcript-Ereignis aus.

Gesendete Ereignisse

Ereignis	Beschreibung	Verwendung
`input_audio_chunk`	Audiodaten zur Transkription senden	Fortlaufend beim Audio-Streaming

Empfangene Ereignisse

Ereignis	Beschreibung	Empfangszeitpunkt
`session_started`	Bestätigt die Verbindung und gibt die Sitzungskonfiguration zurück	Unmittelbar nach Herstellung der WebSocket-Verbindung
`partial_transcript`	Live-Transkriptaktualisierung für das laufende Segment. Spätere partielle Transkripte ersetzen frühere. Wird auch als Keepalive gesendet – leeres `text`, wenn das Segment keinen nicht festgeschriebenen Text enthält, oder Wiederholung des neuesten partiellen Texts	Während der Audioverarbeitung, bevor ein Commit erfolgt. Bei Konfiguration auch etwa einmal pro `keepalive_interval_ms` als Keepalive
`committed_transcript`	Festgeschriebenes Transkript für ein Segment. Dies ist der stabile, finale Text für das Segment und wird nicht geändert	Nach einem Commit (manuell oder durch VAD ausgelöst)
`committed_transcript_with_timestamps`	Festgeschriebenes Transkript mit Zeitstempeln auf Wortebene und dem erkannten `language_code`	Wird nach dem festgeschriebenen Transkript gesendet. Nur bei `include_timestamps=true` oder `include_language_detection=true` in den Abfrageparametern
`committed_transcript_entities`	Im festgeschriebenen Transkriptsegment erkannte Entitäten mit Zeichen-Offsets	Wird kurz nach jedem festgeschriebenen Transkript gesendet. Nur bei `entity_detection` in den Abfrageparametern
`edited_transcript`	Bearbeitete Version des festgeschriebenen Transkriptsegments zusammen mit dem ursprünglichen festgeschriebenen Text	Wird kurz nach jedem festgeschriebenen Transkript gesendet. Nur bei `transcript_edit` in den Abfrageparametern

Fehlerbehandlung

Wenn ein Fehler auftritt, wird eine Fehlermeldung zurückgegeben, bevor die WebSocket-Verbindung geschlossen wird.

Fehlertyp	Beschreibung
`auth_error`	Bei der Authentifizierung der Anfrage ist ein Fehler aufgetreten. Überprüfen Sie Ihren API-Schlüssel
`quota_exceeded`	Sie haben Ihr Nutzungskontingent überschritten
`transcriber_error`	Bei der Transkription des Audios ist ein Fehler aufgetreten.
`input_error`	Bei der Verarbeitung des Audio-Chunks ist ein Fehler aufgetreten. Wahrscheinlich aufgrund eines ungültigen Eingabeformats oder ungültiger Parameter
`invalid_request`	Die Verbindungsparameter wurden abgelehnt. Prüfen Sie die Abfrageparameter anhand der API-Referenz
`error`	Ein allgemeiner Serverfehler
`commit_throttled`	Der Commit wurde aufgrund zu vieler Commit-Anfragen in kurzer Zeit gedrosselt
`unaccepted_terms`	Sie haben die Nutzungsbedingungen für Scribe nicht akzeptiert. Prüfen und akzeptieren Sie die Allgemeinen Geschäftsbedingungen im ElevenLabs-Dashboard
`rate_limited`	Ihre Rate ist begrenzt. Reduzieren Sie die Anzahl der Anfragen in kurzer Zeit
`queue_overflow`	Die Verarbeitungswarteschlange ist voll. Senden Sie weniger Anfragen in kurzer Zeit
`resource_exhausted`	Die Serverressourcen sind ausgelastet. Versuchen Sie es später erneut
`session_time_limit_exceeded`	Die maximale Sitzungsdauer wurde erreicht. Starten Sie eine neue Sitzung oder upgraden Sie Ihr Abonnement
`chunk_size_exceeded`	Der Audio-Chunk ist zu groß. Reduzieren Sie die Chunk-Größe
`insufficient_audio_activity`	Sie haben nicht genügend Audioaktivität gesendet, um die Verbindung aufrechtzuerhalten