Home → Assistenza

Un modello che ieri funzionava ora fallisce per tutti nello stesso gruppo di chiavi

I gateway instradano per gruppi: una chiave appartiene a un gruppo, un gruppo punta a uno o più account upstream. Se il gruppo ha un solo account e quell'account smette di servire il modello (credito scaduto, chiave revocata, un elenco di modelli che non corrisponde più), tutte le chiavi del gruppo perdono il modello nello stesso momento.

Cosa vedi

Perché succede

Il testo dell'errore indica il modello, e così si va a controllare ortografia e disponibilità. La condizione realmente segnalata è «nessun account del tuo gruppo può servire questa richiesta», e la soluzione sta dal lato degli account.

I gruppi con un solo account non hanno ridondanza per costruzione. Con due o più account il router passa all'altro e nessuno se ne accorge; con uno solo, un singolo problema upstream è un blackout completo per quel gruppo.

Una versione più sottile: un account dichiara un modello che in realtà non è in grado di fornire. Tutte le richieste instradate verso di esso falliscono e, a seconda della logica di salute del router, gli errori ripetuti possono escludere dalla rotazione l'intero gruppo, così iniziano a fallire anche modelli che funzionavano. Lo abbiamo visto proprio così: un solo nome di modello dichiarato male nell'elenco di un account ha bloccato il traffico di un intero gruppo.

Verifica se la causa è questa

Chiedi al gateway cosa può davvero raggiungere la tua chiave, invece di supporlo:

curl -s 'YOUR_BASE_URL/models' \
  -H 'Authorization: Bearer YOUR_KEY' \
  | python3 -c 'import sys,json; d=json.load(sys.stdin); print(len(d["data"]), "models"); [print(" ", m["id"]) for m in d["data"]]'

Se il modello non è in questo elenco, il gruppo della chiave non può servirlo e nessuna correzione della richiesta servirà. Se c'è ma le chiamate continuano a fallire, a essere guasto è l'account upstream dietro il gruppo.

Come risolvere

  1. Controlla prima /models con la chiave che fallisceUna sola richiesta ti dice se è un problema di instradamento o di richiesta, e non costa nulla.
  2. Chiedi al provider a quale gruppo appartiene la chiaveDue chiavi che sembrano identiche possono stare in gruppi diversi con account upstream diversi. Conoscere il gruppo trasforma «a volte funziona» in una regola riproducibile.
  3. Tieni una seconda chiave in un altro gruppo per le cose importantiÈ la ridondanza più economica disponibile: quando un gruppo ha un problema upstream, cambiare chiave è una modifica di una riga invece di un disservizio.
  4. Non fare affidamento sul fatto che un modello compaia in un elenco pubblicoUn modello elencato in una pagina dei prezzi può comunque non essere disponibile per il tuo gruppo. La risposta autorevole è ciò che /models restituisce per la tua chiave.
Su APICLAN ogni chiave appartiene esattamente a un gruppo, e /models riflette sempre ciò che quella chiave può davvero chiamare. I modelli disponibili in ciascun gruppo sono elencati nella pagina dei prezzi.

Articoli correlati

Unexpected token '<' quando chiami un'API compatibile con OpenAI401 invalid API key: quando la chiave sembra giusta ma continua a fallire

Ultima verifica: 2026-10-01. Scritto a partire da problemi diagnosticati su un gateway compatibile con OpenAI in produzione, non raccolto da altri siti.