Referência de eventos em tempo real | ElevenLabs Documentation

Referência · Lista todos os eventos enviados e recebidos pela API WebSocket de Transcrição de Voz em Tempo Real.

Consulte a referência da API da API de Transcrição de Voz em Tempo Real para mais informações sobre a API e suas opções.

committed_transcript é o evento final e estável de cada segmento. A API pública não emite um evento final_transcript separado.

Eventos enviados

Evento	Descrição	Quando usar
`input_audio_chunk`	Envie dados de áudio para transcrição	Continuamente durante o streaming de áudio

Evento	Descrição	Quando é recebido
`session_started`	Confirma a conexão e retorna a configuração da sessão	Imediatamente após o estabelecimento da conexão WebSocket
`partial_transcript`	Atualização da transcrição ao vivo para o segmento em andamento. Parciais posteriores substituem as anteriores	Durante o processamento de áudio, antes de uma confirmação
`committed_transcript`	Transcrição consolidada de um segmento. Este é o texto final e estável do segmento e não será alterado	Após uma confirmação (manual ou acionada por VAD)
`committed_transcript_with_timestamps`	Transcrição confirmada com timestamps por palavra e o `language_code` detectado	Enviado após a transcrição confirmada. Recebido apenas quando `include_timestamps=true` ou `include_language_detection=true` é incluído nos parâmetros de consulta
`committed_transcript_entities`	Entidades detectadas no segmento de transcrição confirmada, com deslocamentos de caracteres	Enviado pouco depois de cada transcrição confirmada. Recebido apenas quando `entity_detection` é incluído nos parâmetros de consulta
`edited_transcript`	Versão editada do segmento de transcrição confirmada, junto com o texto confirmado original	Enviado pouco depois de cada transcrição confirmada. Recebido apenas quando `transcript_edit` é incluído nos parâmetros de consulta

Se ocorrer um erro, uma mensagem de erro será retornada antes de a conexão WebSocket ser encerrada.

Tipo de erro	Descrição
`auth_error`	Ocorreu um erro ao autenticar a solicitação. Verifique sua chave de API
`quota_exceeded`	Você excedeu sua cota de uso
`transcriber_error`	Ocorreu um erro ao transcrever o áudio.
`input_error`	Ocorreu um erro ao processar o bloco de áudio. Provavelmente devido a um formato ou parâmetros de entrada inválidos
`invalid_request`	Os parâmetros da conexão foram rejeitados. Verifique os parâmetros de consulta na referência da API
`error`	Um erro genérico do servidor
`commit_throttled`	A confirmação foi limitada devido ao excesso de solicitações de confirmação em um curto período
`unaccepted_terms`	Você não aceitou os termos de serviço para usar o Scribe. Revise e aceite os termos e condições no painel da ElevenLabs
`rate_limited`	Sua taxa de solicitações está limitada. Reduza a quantidade de solicitações feitas em um curto período
`queue_overflow`	A fila de processamento está cheia. Envie menos solicitações em um curto período
`resource_exhausted`	Os recursos do servidor estão no limite. Tente novamente mais tarde
`session_time_limit_exceeded`	O tempo máximo da sessão foi atingido. Inicie uma nova sessão ou atualize sua assinatura
`chunk_size_exceeded`	O tamanho do bloco de áudio é grande demais. Reduza o tamanho do bloco
`insufficient_audio_activity`	Você não enviou atividade de áudio suficiente para manter a conexão