Errors

HTTP	Significat	Acció recomanada
400	Sol·licitud no vàlida	JSON correcte i camps obligatoris
401	Clau no vàlida, bloquejada o revocada	Gira o descongela la clau
402	S'ha assolit el saldo del compte o el límit d'ús de claus insuficients	Afegiu fons o reinicieu/augmenteu el límit de claus
403	Model no disponible per a la clau o la IP d'origen rebutjada per una llista d'API	Actualitzeu els permisos de la clau o utilitzeu una IP d'origen permesa
404	Punt final, model o sol·licitud asíncrona desconegut	Comproveu l'identificador i el camí
413	La sol·licitud és massa gran	Redueix la mida del context
429	S'han superat les RPM o la concurrència	Honor Retry-After
500	Error de passarel·la	Torneu a provar i inspeccioneu els registres
502/503/504	Amunt no disponible o s'ha esgotat el temps d'espera	Torna-ho a provar amb un retrocés exponencial

Cal pagar

El saldo insuficient de l'empresa/compte retorna HTTP 402 Payment Required al sobre compatible amb OpenAI:

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

La mateixa raó/codi estable es registra a l'historial de sol·licituds. A 402 La sol·licitud es rebutja abans de l'execució del proveïdor i no s'ha de tornar a intentar automàticament fins que no s'hagi corregit el finançament o la restricció de despesa aplicable.

Rebuig de la llista d'IP permès

Quan una clau d'API autenticada és vàlida però l'adreça d'origen està fora de la llista de permesos de l'API personal o de l'organització empresarial efectiva, Model Gate rebutja la sol·licitud abans de l'execució amunt. Les respostes compatibles amb OpenAI utilitzen HTTP 403 amb codi ip_not_allowed. Les respostes compatibles amb antròpics utilitzen l'embolcall d'error antròpic amb HTTP 403 i authentication_error. No torneu a intentar des de la mateixa font no permesa; canviar la llista d'autorització configurada o enviar la sol·licitud des d'una adreça permesa.

Torna-ho a provar 429 després Retry-After. Torna-ho a provar 500, 502, 503, i 504 fins a tres vegades amb retrocés d'1/2/4 de segon. No torneu a intentar automàticament la validació, l'autenticació, el saldo o els errors no trobats.

Utilitzeu l'identificador públic de sol·licitud de X-Request-ID per correlacionar la resposta amb la registre de sol·licituds.