Errors
Codis d'error HTTP, formats de resposta i regles de reintent.
| 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.
Errors després de les capçaleres del flux
SSE pot fallar després que ja s'hagi enviat HTTP200. Aleshores, la resposta conté un esdeveniment d'error compatible amb el protocol; l'historial de peticions de passarel·la registra la fallada del terminal independentment de l'estat del cable. Els missatges desconeguts aigües amunt s'oculten de manera predeterminada, els missatges aprovats poden estar exposats per la política de l'administrador i l'exposició completa dels errors aigües amunt és explícita. Les metadades internes de aigües amunt i les dades brutes temporals romanen només per a administradors. L'ús que falta després d'una reproducció interrompuda és desconegut/necessita una revisió, no una estimació automàtica a partir de bytes de cable. Conserveu l'identificador de sol·licitud i torneu-ho a provar només deliberadament després de comprovar la sortida parcial.