Errores

Pixapi usa códigos de estado HTTP más tipos de error legibles por máquina.

Estructura del error

{
  "error": {
    "code": 400,
    "message": "xxx",
    "type": "invalid_request_error"
  }
}

Errores comunes

Estado HTTP	Tipo	Significado
400	invalid_request_error	Campo de petición ausente o no válido.
401	unauthorized	Missing or invalid API key.
402	insufficient_credits	La cuenta no tiene suficientes créditos.
404	model_not_found	El ID del modelo es desconocido o no está disponible.
422	prompt_rejected	El prompt o la entrada infringe la política del modelo.
429	rate_limited	Demasiadas peticiones en un periodo corto.
500	internal_error	Error inesperado del servidor.
503	model_unavailable	El proveedor no está disponible temporalmente.

Guía de reintentos

Reintenta solo errores transitorios:

• 429 rate_limited
• 500 internal_error
• 503 model_unavailable

Usa backoff exponencial y evita reintentar respuestas 400, 401, 402 o 422 sin cambiar la petición, la clave o el estado de la cuenta.