Referência de eventos em tempo real | ElevenLabs Documentation

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

Consulte a referência da API de Transcrição de Voz em Tempo Real para obter 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 a transmissão de áudio

Eventos recebidos

Evento	Descrição	Quando recebido
`session_started`	Confirma a conexão e retorna a configuração da sessão	Imediatamente após a conexão WebSocket ser estabelecida
`partial_transcript`	Atualização da transcrição ao vivo para o segmento em andamento. Parciais posteriores substituem as anteriores. Também é enviado como um keepalive — `text` vazio se o segmento não tiver texto não confirmado ou uma repetição da parcial mais recente caso tenha	Durante o processamento de áudio, antes de um commit. Também é enviado como keepalive cerca de uma vez por `keepalive_interval_ms` quando configurado
`committed_transcript`	Transcrição consolidada de um segmento. Este é o texto final e estável do segmento e não será alterado	Após um commit (manual ou acionado pelo 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` estiver incluído nos parâmetros de consulta
`committed_transcript_entities`	Entidades detectadas no segmento de transcrição confirmado, com deslocamentos de caracteres	Enviado pouco depois de cada transcrição confirmada. Recebido apenas quando `entity_detection` estiver incluído nos parâmetros de consulta
`edited_transcript`	Versão editada do segmento de transcrição confirmado, junto com o texto confirmado original	Enviado pouco depois de cada transcrição confirmada. Recebido apenas quando `transcript_edit` estiver incluído nos parâmetros de consulta

Tratamento de erros

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

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 formato de entrada ou parâmetros inválidos
`invalid_request`	Os parâmetros de conexão foram rejeitados. Verifique os parâmetros de consulta na referência da API
`error`	Um erro genérico do servidor
`commit_throttled`	O commit foi limitado devido a muitas solicitações de commit feitas 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 foi 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 de sessão foi atingido. Inicie uma nova sessão ou faça upgrade da sua assinatura
`chunk_size_exceeded`	O tamanho do bloco de áudio é muito grande. Reduza o tamanho do bloco
`insufficient_audio_activity`	Você não enviou atividade de áudio suficiente para manter a conexão