Errores

HTTP	Significado	Acción recomendada
400	Solicitud no válida	Corregir JSON y campos obligatorios
401	Clave no válida, congelada o revocada	Girar o descongelar la clave
402	Saldo de cuenta insuficiente o límite de uso de claves alcanzado	Agregar fondos o restablecer/aumentar el límite de claves
403	Modelo no disponible para la clave o IP de origen rechazada por una lista de permitidos de API	Actualice los permisos clave o use una IP de origen permitida
404	Punto final, modelo o solicitud asíncrona desconocidos	Verifique el identificador y la ruta
413	Solicitud demasiado grande	Reducir el tamaño del contexto
429	Se excedió el RPM o la simultaneidad	Honor Retry-After
500	Error de puerta de enlace	Reintentar e inspeccionar registros
502/503/504	Upstream no disponible o agotado	Reintentar con retroceso exponencial

Pago requerido

El saldo insuficiente de la empresa/cuenta devuelve HTTP 402 Payment Required en el sobre compatible con OpenAI:

{
  "error": {
    "message": "Insufficient account balance.",
    "type": "payment_required",
    "code": "insufficient_balance"
  }
}

El mismo motivo/código estable se registra en el Historial de solicitudes. A 402 La solicitud se rechaza antes de la ejecución del proveedor y no se debe volver a intentar automáticamente hasta que se haya corregido el financiamiento o la restricción de gasto aplicable.

Rechazo de la lista de IP permitidas

Cuando una clave API autenticada es válida pero la dirección de origen está fuera de la lista permitida de API personal o de organización empresarial efectiva, Model Gate rechaza la solicitud antes de la ejecución ascendente. Las respuestas compatibles con OpenAI utilizan HTTP 403 con codigo ip_not_allowed. Las respuestas compatibles con Anthropic utilizan el sobre de error de Anthropic con HTTP 403 y authentication_error. No vuelva a intentarlo desde la misma fuente no permitida; cambie la lista de permitidos configurada o envíe la solicitud desde una dirección permitida.

Rever 429 después Retry-After. Rever 500, 502, 503, y 504 hasta tres veces con un retroceso de 1/2/4 segundo. No reintente automáticamente errores de validación, autenticación, saldo o no encontrado.

Utilice la ID pública de solicitud de X-Request-ID correlacionar la respuesta con la registro de solicitudes.