Los errores son JSON con un campo detail. Usa el estado y las cabeceras de reintento; conserva detail para registros y avisos.

Estado	Significado	Qué hacer
`400`	Entrada no válida, motor desconocido o enrutamiento incorrecto	Corrige la solicitud o elige un motor disponible
`401`	PIN o clave API ausente o incorrecta	Envía la credencial
`403`	El solicitante no puede usar una ruta local o de administrador	Usa loopback o una ruta permitida
`409`	Falta un modelo o estado necesario	Instala el modelo recomendado o resuelve el conflicto
`422`	El cuerpo no supera la validación	Corrige nombres, tipos o rangos de campos
`429`	La cola de GPU está llena	Espera `Retry-After` y vuelve a intentarlo
`500`	Fallo inesperado del motor o servidor	Registra `detail`; reintenta solo si es seguro
`503`	La carga del motor o la generación no está disponible temporalmente	Respeta `Retry-After`
`504`	Una transcripción o generación protegida agotó el tiempo	Reintenta una vez; reduce la tarea si se repite

Reintentos

Reintenta 429, 503 reintentables y 504 con espera exponencial limitada. VoiceStudio puede enviar:

Retry-After: 30
X-OmniVoice-Retryable: true

No reintentes automáticamente 400, 401, 403 ni 422. Un 409 requiere primero instalar un modelo u otro cambio explícito.

Para doblaje y tareas por lotes, retoma desde el estado de la tarea tras una desconexión en lugar de volver a subir el archivo.

Los errores son JSON con un campo detail. Usa el estado y las cabeceras de reintento; conserva detail para registros y avisos.

Estado	Significado	Qué hacer
`400`	Entrada no válida, motor desconocido o enrutamiento incorrecto	Corrige la solicitud o elige un motor disponible
`401`	PIN o clave API ausente o incorrecta	Envía la credencial
`403`	El solicitante no puede usar una ruta local o de administrador	Usa loopback o una ruta permitida
`409`	Falta un modelo o estado necesario	Instala el modelo recomendado o resuelve el conflicto
`422`	El cuerpo no supera la validación	Corrige nombres, tipos o rangos de campos
`429`	La cola de GPU está llena	Espera `Retry-After` y vuelve a intentarlo
`500`	Fallo inesperado del motor o servidor	Registra `detail`; reintenta solo si es seguro
`503`	La carga del motor o la generación no está disponible temporalmente	Respeta `Retry-After`
`504`	Una transcripción o generación protegida agotó el tiempo	Reintenta una vez; reduce la tarea si se repite

Reintenta 429, 503 reintentables y 504 con espera exponencial limitada. VoiceStudio puede enviar:

Retry-After: 30
X-OmniVoice-Retryable: true

No reintentes automáticamente 400, 401, 403 ni 422. Un 409 requiere primero instalar un modelo u otro cambio explícito.

Para doblaje y tareas por lotes, retoma desde el estado de la tarea tras una desconexión en lugar de volver a subir el archivo.

Errores y reintentos