Listado de errores de API para solicitudes

Esta página ofrece una visión general completa de los mensajes de excepción que puede devolver el servicio. Estos mensajes de excepción están categorizados según el tipo de solicitud u operación, y proporcionan información detallada sobre los posibles problemas que pueden surgir durante el uso del servicio, como Solicitudes no guiadas por script, Solicitudes guiadas por script y errores específicos de Autenticación o Procesamiento de audio.

Cada error se muestra con:

• Nombre: El nombre de la excepción.
• Mensaje: El mensaje de error detallado devuelto por el sistema.
• Parámetros: Cualquier información adicional o contexto necesario para el error.
• Descripción: Una breve explicación de cuándo y por qué ocurre el error.

Utilice este listado como referencia para comprender, depurar y gestionar posibles problemas al interactuar con la API de forma eficaz.

Solicitudes no guiadas por script​

Las solicitudes no guiadas por script implican operaciones en tiempo real o asíncronas en las que la API procesa la entrada de forma dinámica sin depender de scripts o flujos de trabajo predefinidos. Este tipo de solicitudes se utilizan frecuentemente en escenarios como el procesamiento de audio en vivo, tareas de ASR (Reconocimiento Automático de Voz) ad-hoc u otras interacciones dinámicas.

Excepciones de ASR​

Excepción

Mensaje

Parámetros

Descripción

ASRInterProcessException

exception in ASR: {error}

error (str): Detalles del error.

Se produce cuando hay una excepción entre procesos en el sistema ASR.

ASRSocketTimeout

ASR timeout

None

Se produce cuando el sistema ASR agota el tiempo de espera durante el procesamiento.

ASRConnectionFailed

ASR Connection Failed

None

Se produce cuando falla la conexión con el sistema ASR.

Excepciones de audio​

Excepción

Mensaje

Parámetros

Descripción

FailedToReadAudioFromURL

Failed to read audio from the URL

None

Se produce cuando el servidor no puede leer el audio desde la URL proporcionada.

FailedToParseAudioHeader

Failed to parse audio header

None

Se produce cuando no es posible analizar la cabecera del audio.

InvalidAudioFormat

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

None

Se produce cuando el formato de audio proporcionado no es válido.

FailedToConvertAudio

The server failed to parse your {audio_format} audio

audio_format (str): El formato del audio que no pudo convertirse.

Se produce cuando el servidor no puede convertir el formato de audio proporcionado.

FailedToDecodeAudioFromBytes

Failed to decode audio

None

Se produce cuando el servidor no puede decodificar los datos de audio desde bytes.

MissingAudioParam

Missing audio param!

None

Se produce cuando falta el parámetro audio requerido.

AudioTooBigForSync

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

stream_dir (str): Directorio o ubicación del flujo de audio.

Se produce cuando el audio proporcionado es demasiado grande para el procesamiento síncrono.

FailedToUseAudio

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

None

Se produce cuando ocurre un error inesperado durante el procesamiento del audio.

Excepciones de autenticación​

Excepción

Mensaje

Parámetros

Descripción

NoTokenProvided

No session token provided

None

Se produce cuando no se proporciona ningún token de sesión.

InvalidSessionToken

Invalid session token: {token}

token (str): El token de sesión no válido.

Se produce cuando se proporciona un token de sesión no válido.

UserDoesNotExist

Could not find {user_type} ID

user_type (str): El tipo de ID de usuario.

Se produce cuando el usuario especificado no existe.

ClientIsNotActive

Client with {user_id} is not active

user_id (str): El ID de usuario.

Se produce cuando el cliente especificado no está activo.

ClientDoesNotHaveAccess

User {user_id} does not have access for this API

user_id (str): El ID de usuario.

Se produce cuando el cliente especificado no tiene acceso a la API.

ClientHasNoMoreMinutes

User has no remaining minutes

None

Se produce cuando el usuario no tiene minutos restantes para el uso de la API.

Solicitudes guiadas por script​

Las solicitudes guiadas por script implican flujos de trabajo u operaciones predefinidas que siguen una secuencia o script específico. Este tipo de solicitudes se utilizan comúnmente en escenarios donde la entrada y la salida esperada están bien definidas, como el procesamiento de audio basado en un script predeterminado, la ejecución de tareas automatizadas o la gestión de flujos de trabajo estructurados.

Excepciones de audio​

Excepción

Mensaje

Parámetros

Descripción

MissingAudioParam

Missing audio param!

None

Se produce cuando falta el parámetro audio requerido.

FailedToReadAudioFromURL

Failed to read audio from the URL

None

Se produce cuando el servidor no puede leer el audio desde la URL proporcionada.

FailedToConvertAudio

The server failed to parse your {audio_format} audio

audio_format (str): El formato del audio que no pudo convertirse.

Se produce cuando el servidor no puede convertir el formato de audio proporcionado.

FailedToUseAudio

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

None

Se produce cuando ocurre un error inesperado durante el procesamiento del audio.

Excepciones de autenticación​

Excepción

Mensaje

Parámetros

Descripción

NoTokenProvided

No session token provided

None

Se produce cuando no se proporciona ningún token de sesión.

ClientIsNotActive

Client with {user_id} is not active

user_id (str): El ID de usuario.

Se produce cuando el cliente especificado no está activo.

ClientDoesNotHaveAccess

User {user_id} does not have access for this API

user_id (str): El ID de usuario.

Se produce cuando el cliente especificado no tiene acceso a la API.

UserDoesNotExist

Could not find {user_type} ID

user_type (str): El tipo de ID de usuario.

Se produce cuando el usuario especificado no existe.

InvalidHeaderParameter

A valid authorization header is required

None

Se produce cuando la cabecera de autorización no es válida o está ausente.