Referenz für Echtzeitereignisse | ElevenLabs Documentation

Referenz · Listet alle Events auf, die an die Realtime Speech to Text WebSocket- API gesendet und von ihr empfangen werden.

Weitere Informationen zur API und ihren Optionen finden Sie in der API-Referenz für die Realtime Speech to Text API.

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

Gesendete Events

Event	Beschreibung	Verwendung
`input_audio_chunk`	Audiodaten zur Transkription senden	Kontinuierlich beim Audio-Streaming

Empfangene Events

Event	Beschreibung	Empfangszeitpunkt
`session_started`	Bestätigt die Verbindung und gibt die Sitzungskonfiguration zurück	Unmittelbar nach Aufbau der WebSocket-Verbindung
`partial_transcript`	Live-Transkriptaktualisierung für das laufende Segment. Spätere Teiltranskripte ersetzen frühere. Wird auch als Keepalive gesendet — leeres `text`, wenn das Segment keinen nicht festgeschriebenen Text enthält, oder eine Wiederholung des neuesten Teiltranskripts, falls vorhanden	Während der Audioverarbeitung, bevor ein Commit erfolgt. Bei Konfiguration auch etwa einmal pro `keepalive_interval_ms` als Keepalive gesendet
`committed_transcript`	Abgeschlossenes Transkript für ein Segment. Dies ist der stabile, endgültige 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 empfangen, wenn `include_timestamps=true` oder `include_language_detection=true` in den Abfrageparametern enthalten ist
`committed_transcript_entities`	Im festgeschriebenen Transkriptsegment erkannte Entitäten mit Zeichen-Offsets	Kurz nach jedem festgeschriebenen Transkript gesendet. Nur empfangen, wenn `entity_detection` in den Abfrageparametern enthalten ist
`redacted_transcript`	Festgeschriebenes Transkriptsegment, in dem die geschwärzten Entitäten durch Markierungen ersetzt wurden, zusammen mit dem ursprünglichen festgeschriebenen Text	Kurz nach jedem festgeschriebenen Transkript gesendet. Nur empfangen, wenn `entity_redaction` in den Abfrageparametern enthalten ist
`edited_transcript`	Bearbeitete Version des festgeschriebenen Transkriptsegments, zusammen mit dem ursprünglichen festgeschriebenen Text	Kurz nach jedem festgeschriebenen Transkript gesendet. Nur empfangen, wenn `transcript_edit` in den Abfrageparametern enthalten ist

Fehlerbehandlung

Tritt ein Fehler auf, wird vor dem Schließen der WebSocket-Verbindung eine Fehlermeldung zurückgegeben.

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. Wird auch gesendet, wenn die Entitätsschwärzung fehlschlägt, bevor die Verbindung geschlossen wird
`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 Anfragen werden 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 führen Sie ein Upgrade Ihres Abonnements durch
`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