> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Referência de eventos em tempo real

> **Note**
>
> **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](/docs/pt/api-reference/speech-to-text/v-1-speech-to-text-realtime) 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](/docs/pt/eleven-api/guides/how-to/speech-to-text/realtime/transcripts-and-commit-strategies#keeping-the-connection-alive-during-silence) — `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                                                     |