Listagem de Erros de API para Requisições

Esta página fornece uma visão geral abrangente das mensagens de exceção que podem ser retornadas pelo serviço. Essas mensagens de exceção são categorizadas com base no tipo de requisição ou operação, oferecendo informações detalhadas sobre possíveis problemas encontrados durante o uso do serviço, como Requisições Não Roteirizadas, Requisições Roteirizadas e erros específicos de Autenticação ou Processamento de Áudio.

Cada erro é listado com:

• Nome: O nome da exceção.
• Mensagem: A mensagem de erro detalhada retornada pelo sistema.
• Parâmetros: Informações adicionais ou contexto necessário para o erro.
• Descrição: Uma breve explicação de quando e por que o erro ocorre.

Use esta listagem como referência para entender, depurar e tratar possíveis problemas ao interagir com a API de forma eficaz.

Requisições Não Roteirizadas​

Requisições não roteirizadas envolvem operações em tempo real ou assíncronas em que a API processa a entrada dinamicamente sem depender de scripts ou fluxos de trabalho predefinidos. Essas requisições são frequentemente usadas em cenários como processamento de áudio ao vivo, tarefas de ASR (Reconhecimento Automático de Fala) ad-hoc ou outras interações dinâmicas.

Exceções de ASR​

Exceção

Mensagem

Parâmetros

Descrição

ASRInterProcessException

exception in ASR: {error}

error (str): Detalhes do erro.

Gerada quando há uma exceção entre processos no sistema de ASR.

ASRSocketTimeout

ASR timeout

None

Gerada quando o sistema de ASR expira o tempo limite durante o processamento.

ASRConnectionFailed

ASR Connection Failed

None

Gerada quando a conexão com o sistema de ASR falha.

Exceções de Áudio​

Exceção

Mensagem

Parâmetros

Descrição

FailedToReadAudioFromURL

Failed to read audio from the URL

None

Gerada quando o servidor não consegue ler o áudio da URL fornecida.

FailedToParseAudioHeader

Failed to parse audio header

None

Gerada quando o cabeçalho de áudio não pode ser analisado.

InvalidAudioFormat

Only 16 kHz mono WAV, FLAC or OGG-Opus audio allowed

None

Gerada quando o formato de áudio fornecido é inválido.

FailedToConvertAudio

The server failed to parse your {audio_format} audio

audio_format (str): O formato do áudio que falhou na conversão.

Gerada quando o servidor falha ao converter o formato de áudio fornecido.

FailedToDecodeAudioFromBytes

Failed to decode audio

None

Gerada quando o servidor falha ao decodificar dados de áudio a partir de bytes.

MissingAudioParam

Missing audio param!

None

Gerada quando o parâmetro audio obrigatório está ausente.

AudioTooBigForSync

Audio is too big for sync mode, please change to async mode

stream_dir (str): Diretório ou localização do fluxo de áudio.

Gerada quando o áudio fornecido é grande demais para o processamento síncrono.

FailedToUseAudio

An unexpected error occurred while processing the audio. Please check if the audio is valid and it's not corrupted.

None

Gerada quando ocorre um erro inesperado durante o processamento do áudio.

Exceções de Autenticação​

Exceção

Mensagem

Parâmetros

Descrição

NoTokenProvided

No session token provided

None

Gerada quando nenhum token de sessão é fornecido.

InvalidSessionToken

Invalid session token: {token}

token (str): O token de sessão inválido.

Gerada quando um token de sessão inválido é fornecido.

UserDoesNotExist

Could not find {user_type} ID

user_type (str): O tipo de ID de usuário.

Gerada quando o usuário especificado não existe.

ClientIsNotActive

Client with {user_id} is not active

user_id (str): O ID do usuário.

Gerada quando o cliente especificado não está ativo.

ClientDoesNotHaveAccess

User {user_id} does not have access for this API

user_id (str): O ID do usuário.

Gerada quando o cliente especificado não tem acesso à API.

ClientHasNoMoreMinutes

User has no remaining minutes

None

Gerada quando o usuário não possui minutos restantes para uso da API.

Requisições Roteirizadas​

Requisições roteirizadas envolvem fluxos de trabalho ou operações predefinidas que seguem uma sequência ou script específico. Essas requisições são comumente usadas em cenários onde a entrada e a saída esperada são bem definidas, como o processamento de áudio com base em um script predeterminado, a execução de tarefas automatizadas ou o tratamento de fluxos de trabalho estruturados.

Exceções de Áudio​

Exceção

Mensagem

Parâmetros

Descrição

MissingAudioParam

Missing audio param!

None

Gerada quando o parâmetro audio obrigatório está ausente.

FailedToReadAudioFromURL

Failed to read audio from the URL

None

Gerada quando o servidor não consegue ler o áudio da URL fornecida.

FailedToConvertAudio

The server failed to parse your {audio_format} audio

audio_format (str): O formato do áudio que falhou na conversão.

Gerada quando o servidor falha ao converter o formato de áudio fornecido.

FailedToUseAudio

An unexpected error occurred while processing the audio. Please check if the audio is valid and it's not corrupted.

None

Gerada quando ocorre um erro inesperado durante o processamento do áudio.

Exceções de Autenticação​

Exceção

Mensagem

Parâmetros

Descrição

NoTokenProvided

No session token provided

None

Gerada quando nenhum token de sessão é fornecido.

ClientIsNotActive

Client with {user_id} is not active

user_id (str): O ID do usuário.

Gerada quando o cliente especificado não está ativo.

ClientDoesNotHaveAccess

User {user_id} does not have access for this API

user_id (str): O ID do usuário.

Gerada quando o cliente especificado não tem acesso à API.

UserDoesNotExist

Could not find {user_type} ID

user_type (str): O tipo de ID de usuário.

Gerada quando o usuário especificado não existe.

InvalidHeaderParameter

A valid authorization header is required

None

Gerada quando o cabeçalho de autorização é inválido ou está ausente.