Saltar al contenido principal
Cada endpoint de chat devuelve los errores con la misma forma que el estándar de API con el que es compatible (OpenAI, Anthropic o Gemini). Toda respuesta de error incluye además una cabecera X-Request-Id y devuelve únicamente la información que necesitas para depurar tu solicitud.

OpenAI — /v1/chat/completions (y endpoints de imagen/vídeo)

{
  "error": {
    "message": "Insufficient credits",
    "type": "insufficient_quota",
    "code": "insufficient_credits",
    "param": null
  }
}

Anthropic — /v1/messages

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "Invalid API key"
  }
}

Gemini — /v1beta/models/{model}:generateContent

{
  "error": {
    "code": 400,
    "message": "model is required",
    "status": "INVALID_ARGUMENT"
  }
}

Mapeo de estados

El type / status del error se deriva del estado HTTP:
HTTPOpenAI typeAnthropic typeGemini status
400invalid_request_errorinvalid_request_errorINVALID_ARGUMENT
401authentication_errorauthentication_errorUNAUTHENTICATED
403permission_errorpermission_errorPERMISSION_DENIED
404not_found_errornot_found_errorNOT_FOUND
402insufficient_quotainvalid_request_errorRESOURCE_EXHAUSTED
429rate_limit_errorrate_limit_errorRESOURCE_EXHAUSTED
5xxapi_errorapi_error / overloaded_errorSERVER_ERROR / UNAVAILABLE