실시간 이벤트 레퍼런스 | ElevenLabs Documentation

레퍼런스 · Realtime Speech to Text WebSocket에서 전송하고 수신하는 모든 이벤트를 나열합니다.

API 및 옵션에 관한 자세한 내용은 Realtime Speech to Text API의 API 레퍼런스를 확인하세요.

committed_transcript는 각 세그먼트의 안정적인 최종 이벤트입니다. 공개 API는 별도의 final_transcript 이벤트를 전송하지 않습니다.

전송 이벤트

이벤트	설명	사용 시점
`input_audio_chunk`	전사를 위해 오디오 데이터를 전송	오디오 스트리밍 중 지속적으로

수신 이벤트

이벤트	설명	수신 시점
`session_started`	연결을 확인하고 세션 구성을 반환합니다	WebSocket 연결이 설정된 직후
`partial_transcript`	진행 중인 세그먼트의 실시간 전사 업데이트입니다. 이후의 부분 전사가 이전 전사를 대체합니다. 연결 유지 용도로도 전송됩니다. 세그먼트에 커밋되지 않은 텍스트가 없으면 `text`는 비어 있고, 있으면 최신 부분 전사가 반복됩니다	오디오 처리 중이며 커밋되기 전입니다. 구성된 경우 `keepalive_interval_ms`마다 약 한 번 연결 유지 용도로도 전송됩니다
`committed_transcript`	세그먼트의 확정된 전사입니다. 세그먼트의 안정적인 최종 텍스트이며 변경되지 않습니다	커밋 후(수동 또는 VAD 트리거)
`committed_transcript_with_timestamps`	단어 수준 타임스탬프와 감지된 `language_code`가 포함된 커밋된 전사입니다	커밋된 전사 후 전송됩니다. 쿼리 매개변수에 `include_timestamps=true` 또는 `include_language_detection=true`가 포함된 경우에만 수신됩니다
`committed_transcript_entities`	문자 오프셋이 포함된, 커밋된 전사 세그먼트에서 감지된 엔터티입니다	각 커밋된 전사 직후 전송됩니다. 쿼리 매개변수에 `entity_detection`이 포함된 경우에만 수신됩니다
`edited_transcript`	원본 커밋 텍스트와 함께 제공되는 커밋된 전사 세그먼트의 편집 버전입니다	각 커밋된 전사 직후 전송됩니다. 쿼리 매개변수에 `transcript_edit`가 포함된 경우에만 수신됩니다

오류 처리

오류가 발생하면 WebSocket 연결이 닫히기 전에 오류 메시지가 반환됩니다.

오류 유형	설명
`auth_error`	요청을 인증하는 동안 오류가 발생했습니다. API 키를 다시 확인하세요
`quota_exceeded`	사용량 할당량을 초과했습니다
`transcriber_error`	오디오를 전사하는 동안 오류가 발생했습니다.
`input_error`	오디오 청크를 처리하는 동안 오류가 발생했습니다. 입력 형식이나 매개변수가 잘못되었을 가능성이 높습니다
`invalid_request`	연결 매개변수가 거부되었습니다. API 레퍼런스와 쿼리 매개변수를 확인하세요
`error`	일반적인 서버 오류
`commit_throttled`	짧은 시간에 너무 많은 커밋 요청이 발생하여 커밋이 제한되었습니다
`unaccepted_terms`	Scribe를 사용하기 위한 서비스 약관에 동의하지 않았습니다. ElevenLabs 대시보드에서 이용약관을 검토하고 동의하세요
`rate_limited`	요청 속도가 제한되었습니다. 짧은 시간 내 요청 수를 줄이세요
`queue_overflow`	처리 대기열이 가득 찼습니다. 짧은 시간 내 요청 수를 줄이세요
`resource_exhausted`	서버 리소스가 최대 용량에 도달했습니다. 나중에 다시 시도하세요
`session_time_limit_exceeded`	최대 세션 시간에 도달했습니다. 새 세션을 시작하거나 구독을 업그레이드하세요
`chunk_size_exceeded`	오디오 청크 크기가 너무 큽니다. 청크 크기를 줄이세요
`insufficient_audio_activity`	연결을 유지하기에 충분한 오디오 활동을 전송하지 않았습니다