Errori

Codici di errore HTTP, formati di risposta e regole di ripetizione.

HTTP	Senso	Azione consigliata
400	Richiesta non valida	Correggere JSON e campi obbligatori
401	Chiave non valida, bloccata o revocata	Ruotare o sbloccare la chiave
402	Saldo dell'account insufficiente o limite di utilizzo della chiave raggiunto	Aggiungi fondi o reimposta/aumenta il limite della chiave
403	Modello non disponibile per la chiave o l'IP di origine rifiutato da una lista consentita API	Aggiorna le autorizzazioni chiave o utilizza un IP di origine consentito
404	Endpoint, modello o richiesta asincrona sconosciuti	Controlla l'identificatore e il percorso
413	Richiesta troppo grande	Ridurre le dimensioni del contesto
429	RPM o concorrenza superati	Onore `Retry-After`
500	Errore del gateway	Riprovare e controllare i log
502/503/504	Upstream non disponibile o scaduto	Riprova con backoff esponenziale

Pagamento richiesto

Il saldo aziendale/account insufficiente restituisce HTTP 402 Payment Required nella busta compatibile con OpenAI:

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

Lo stesso motivo/codice stabile viene registrato nella cronologia delle richieste. UN 402 la richiesta viene rifiutata prima dell'esecuzione da parte del fornitore e non deve essere ritentata automaticamente fino a quando il finanziamento o il vincolo di spesa applicabile non vengono corretti.

Rifiuto della lista consentita IP

Quando una chiave API autenticata è valida ma l'indirizzo di origine non rientra nella lista consentita dell'API personale o aziendale effettiva, Model Gate rifiuta la richiesta prima dell'esecuzione upstream. Le risposte compatibili con OpenAI utilizzano HTTP 403 con codice ip_not_allowed. Le risposte compatibili con Anthropic utilizzano la busta di errore Anthropic con HTTP 403 E authentication_error. Non riprovare dalla stessa fonte non consentita; modificare la lista consentita configurata o inviare la richiesta da un indirizzo consentito.

Riprova 429 Dopo Retry-After. Riprova 500, 502, 503, E 504 fino a tre volte con backoff di 1/2/4 secondo. Non riprovare automaticamente la convalida, l'autenticazione, il saldo o gli errori non trovati.

Utilizza l'ID pubblico della richiesta da X-Request-ID per correlare la risposta con il registro delle richieste.

Errori dopo le intestazioni del flusso

SSE può fallire dopo che HTTP200 è già stato inviato. La risposta contiene quindi un evento di errore compatibile con il protocollo; la cronologia delle richieste del gateway registra il guasto del terminale indipendentemente dallo stato del cavo. I messaggi upstream sconosciuti sono nascosti per impostazione predefinita, i messaggi approvati possono essere esposti dai criteri dell'amministratore e l'esposizione completa agli errori upstream è esplicita. I metadati upstream interni e i dati grezzi temporanei rimangono riservati esclusivamente all'amministratore. L'utilizzo mancante dopo un flusso interrotto è sconosciuto/richiede una revisione, non una stima automatica dai byte cablati. Conservare l'ID della richiesta e riprovare solo deliberatamente dopo aver controllato l'output parziale.