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 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 uma confirmação. 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 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` está incluído nos parâmetros de consulta
`committed_transcript_entities`	Entidades detectadas no segmento da transcrição confirmada, com deslocamentos de caracteres	Enviado pouco após cada transcrição confirmada. Recebido apenas quando `entity_detection` está incluído nos parâmetros de consulta
`redacted_transcript`	Segmento de transcrição confirmada com as entidades ocultadas substituídas por marcadores, junto do texto confirmado original	Enviado pouco após cada transcrição confirmada. Recebido apenas quando `entity_redaction` está incluído nos parâmetros de consulta
`edited_transcript`	Versão editada do segmento de transcrição confirmada, junto do texto confirmado original	Enviado pouco após cada transcrição confirmada. Recebido apenas quando `transcript_edit` está incluído nos parâmetros de consulta

Tratamento de erros

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

Tipo de erro	Descrição
`auth_error`	Ocorreu um erro ao autenticar a solicitação. Verifique novamente 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 trecho de áudio. Provavelmente devido a um 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. Também enviado quando a ocultação de entidades falha, antes de a conexão ser fechada
`commit_throttled`	A confirmação foi limitada devido a muitas solicitações de confirmação feitas em pouco tempo
`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`	Seu limite de taxa foi atingido. Reduza a quantidade de solicitações feitas em pouco tempo
`queue_overflow`	A fila de processamento está cheia. Envie menos solicitações em pouco tempo
`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 faça upgrade da sua assinatura
`chunk_size_exceeded`	O trecho de áudio é grande demais. Reduza seu tamanho
`insufficient_audio_activity`	Você não enviou atividade de áudio suficiente para manter a conexão