Referentie voor realtime-gebeurtenissen | ElevenLabs Documentation

Referentie · Bevat alle gebeurtenissen die naar en van de Realtime Speech to Text WebSocket API worden verzonden.

Bekijk de API-referentie voor de Realtime Speech to Text API voor meer informatie over de API en de opties.

committed_transcript is de stabiele, definitieve gebeurtenis voor elk segment. De openbare API verstuurt geen afzonderlijke final_transcript-gebeurtenis.

Verzonden gebeurtenissen

Gebeurtenis	Beschrijving	Wanneer gebruiken
`input_audio_chunk`	Audiogegevens voor transcriptie verzenden	Doorlopend tijdens het streamen van audio

Ontvangen gebeurtenissen

Gebeurtenis	Beschrijving	Wanneer ontvangen
`session_started`	Bevestigt de verbinding en retourneert de sessieconfiguratie	Meteen nadat de WebSocket-verbinding tot stand is gebracht
`partial_transcript`	Live transcriptupdate voor het segment dat wordt verwerkt. Latere partials vervangen eerdere. Ook verzonden als keepalive — lege `text` als het segment geen niet-gecommitteerde tekst heeft, of een herhaling van de nieuwste partial als dat wel zo is	Tijdens de audioverwerking, voordat een commit wordt uitgevoerd. Ook ongeveer eenmaal per `keepalive_interval_ms` als keepalive verzonden wanneer dit is geconfigureerd
`committed_transcript`	Vastgesteld transcript voor een segment. Dit is de stabiele, definitieve tekst voor het segment en verandert niet	Na een commit (handmatig of geactiveerd door VAD)
`committed_transcript_with_timestamps`	Gecommitteerd transcript met timestamps op woordniveau en de gedetecteerde `language_code`	Verzonden na het gecommitteerde transcript. Alleen ontvangen wanneer `include_timestamps=true` of `include_language_detection=true` is opgenomen in de queryparameters
`committed_transcript_entities`	Entiteiten die zijn gedetecteerd in het gecommitteerde transcriptsegment, met tekenoffsets	Kort na elk gecommitteerd transcript verzonden. Alleen ontvangen wanneer `entity_detection` is opgenomen in de queryparameters
`redacted_transcript`	Gecommitteerd transcriptsegment waarin de geredigeerde entiteiten zijn vervangen door markeringen, naast de oorspronkelijke gecommitteerde tekst	Kort na elk gecommitteerd transcript verzonden. Alleen ontvangen wanneer `entity_redaction` is opgenomen in de queryparameters
`edited_transcript`	Bewerkte versie van het gecommitteerde transcriptsegment, naast de oorspronkelijke gecommitteerde tekst	Kort na elk gecommitteerd transcript verzonden. Alleen ontvangen wanneer `transcript_edit` is opgenomen in de queryparameters

Foutafhandeling

Als er een fout optreedt, wordt een foutmelding geretourneerd voordat de WebSocket-verbinding wordt gesloten.

Fouttype	Beschrijving
`auth_error`	Er is een fout opgetreden bij het verifiëren van de request. Controleer je API-sleutel
`quota_exceeded`	Je hebt je gebruikslimiet overschreden
`transcriber_error`	Er is een fout opgetreden bij het transcriberen van de audio.
`input_error`	Er is een fout opgetreden bij het verwerken van het audiochunk. Waarschijnlijk door een ongeldige invoerindeling of parameters
`invalid_request`	De verbindingsparameters zijn afgewezen. Controleer de queryparameters aan de hand van de API-referentie
`error`	Een algemene serverfout. Ook verzonden wanneer het redigeren van entiteiten mislukt, voordat de verbinding wordt gesloten
`commit_throttled`	De commit is beperkt vanwege te veel commitrequests in korte tijd
`unaccepted_terms`	Je hebt de servicevoorwaarden voor het gebruik van Scribe niet geaccepteerd. Bekijk en accepteer de algemene voorwaarden in het ElevenLabs-dashboard
`rate_limited`	Je hebt een rate limit bereikt. Verstuur minder requests in korte tijd
`queue_overflow`	De verwerkingswachtrij is vol. Verstuur minder requests in korte tijd
`resource_exhausted`	De serverresources hebben hun capaciteit bereikt. Probeer het later opnieuw
`session_time_limit_exceeded`	De maximale sessieduur is bereikt. Start een nieuwe sessie of upgrade je abonnement
`chunk_size_exceeded`	Het audiochunk is te groot. Verklein het chunk
`insufficient_audio_activity`	Je hebt niet genoeg audioactiviteit verstuurd om de verbinding te behouden