Corrige primero la causa
400 indica entradas incorrectas; 401, autenticación; 403, restricciones de origen o cuenta. Una clave con acceso API vencido devuelve 401 al solicitar decisiones. 413 rechaza cuerpos grandes y 415 exige JSON. Reintentar no arregla esas causas.
402 indica créditos insuficientes, o un plan inactivo al crear una clave API. Comprueba la cuenta y el endpoint antes de enviar más trabajo.
Conflictos y fallos temporales
409 puede indicar una solicitud en curso, una clave reutilizada con otro contenido o un fallo previo. 429 indica límite de solicitudes.
502 y 503 pueden indicar respuestas inválidas, tiempo agotado o servicios no disponibles. No cambiamos de modelo silenciosamente. Las decisiones fallidas de cuentas registradas se devuelven.
Recuperación limitada
Si desconoces el resultado de una conexión, espera y repite la misma solicitud como máximo dos veces con la misma clave. Si persiste, muestra el error. Facilita el identificador a soporte, nunca claves ni texto privado de clientes.