Dokumentacja zdarzeń w czasie rzeczywistym

Dokumentacja · Zawiera wszystkie zdarzenia wysyłane do i odbierane z WebSocket API Realtime Speech to Text.

Więcej informacji o API i jego opcjach znajdziesz w dokumentacji API Realtime Speech to Text.

committed_transcript to stabilne, końcowe zdarzenie dla każdego segmentu. Publiczne API nie wysyła osobnego zdarzenia final_transcript.

Wysyłane zdarzenia

Zdarzenie	Opis	Kiedy używać
`input_audio_chunk`	Wyślij dane audio do transkrypcji	Ciągle podczas streamingu audio

Zdarzenie	Opis	Kiedy otrzymywane
`session_started`	Potwierdza połączenie i zwraca konfigurację sesji	Natychmiast po ustanowieniu połączenia WebSocket
`partial_transcript`	Aktualizacja transkrypcji na żywo dla trwającego segmentu. Późniejsze wersje zastępują wcześniejsze	Podczas przetwarzania audio, przed zatwierdzeniem
`committed_transcript`	Ustalona transkrypcja segmentu. To stabilny, końcowy tekst segmentu, który się nie zmieni	Po zatwierdzeniu ręcznym lub przez VAD
`committed_transcript_with_timestamps`	Zatwierdzona transkrypcja ze znacznikami czasu na poziomie słów i wykrytym `language_code`	Wysyłane po zatwierdzonej transkrypcji. Otrzymywane tylko, gdy parametry zapytania zawierają `include_timestamps=true` lub `include_language_detection=true`
`committed_transcript_entities`	Encje wykryte w zatwierdzonym segmencie transkrypcji wraz z przesunięciami znaków	Wysyłane wkrótce po każdej zatwierdzonej transkrypcji. Otrzymywane tylko, gdy parametry zapytania zawierają `entity_detection`
`edited_transcript`	Edytowana wersja zatwierdzonego segmentu transkrypcji wraz z oryginalnym zatwierdzonym tekstem	Wysyłane wkrótce po każdej zatwierdzonej transkrypcji. Otrzymywane tylko, gdy parametry zapytania zawierają `transcript_edit`

Jeśli wystąpi błąd, przed zamknięciem połączenia WebSocket zostanie zwrócony komunikat o błędzie.

Typ błędu	Opis
`auth_error`	Wystąpił błąd podczas uwierzytelniania żądania. Sprawdź klucz API
`quota_exceeded`	Przekroczono limit użycia
`transcriber_error`	Wystąpił błąd podczas transkrypcji audio.
`input_error`	Wystąpił błąd podczas przetwarzania fragmentu audio, prawdopodobnie przez nieprawidłowy format wejściowy lub parametry
`invalid_request`	Parametry połączenia zostały odrzucone. Porównaj parametry zapytania z dokumentacją API
`error`	Ogólny błąd serwera
`commit_throttled`	Zatwierdzanie zostało ograniczone z powodu zbyt wielu żądań zatwierdzenia w krótkim czasie
`unaccepted_terms`	Nie zaakceptowałeś warunków korzystania ze Scribe. Sprawdź i zaakceptuj regulamin w panelu ElevenLabs
`rate_limited`	Osiągnięto limit żądań. Zmniejsz liczbę żądań wysyłanych w krótkim czasie
`queue_overflow`	Kolejka przetwarzania jest pełna. Wysyłaj mniej żądań w krótkim czasie
`resource_exhausted`	Zasoby serwera są wyczerpane. Spróbuj ponownie później
`session_time_limit_exceeded`	Osiągnięto maksymalny czas sesji. Rozpocznij nową sesję lub zmień subskrypcję na wyższą
`chunk_size_exceeded`	Fragment audio jest zbyt duży. Zmniejsz jego rozmiar
`insufficient_audio_activity`	Nie wysłano wystarczającej aktywności audio, aby utrzymać połączenie