Home → Assistenza

Model not found: quando il nome del modello è quasi giusto

Elenca i modelli raggiungibili dalla tua chiave e confronta il nome carattere per carattere. Gli ID dei modelli sono esatti, e le famiglie raramente sono coerenti nei separatori.

Cosa vedi

Perché succede

Il nome è il colpevole abituale, ed è davvero difficile da indovinare. All'interno della stessa famiglia troverai versioni scritte con il punto in un rilascio e con il trattino nel successivo: un nome che per una persona si legge uguale è una stringa diversa per l'API.

La seconda causa è l'accesso, non il nome. Sui gateway in cui le chiavi appartengono a un piano o a un gruppo, un modello può esistere sulla piattaforma ed essere comunque fuori da ciò che la tua chiave può chiamare. Il messaggio spesso non distingue i due casi, e così si va a caccia di un errore di battitura che non c'è.

Su un gateway il messaggio può anche nominare il gruppo invece del modello: Model "gpt-4o" is not supported by any configured account in this group. Conviene leggerlo con attenzione — non dice che il modello non è disponibile da nessuna parte, solo che gli account dietro il gruppo della tua chiave non lo offrono. Lo stesso testo compare sia che tu abbia sbagliato a scrivere il nome sia che tu abbia scelto un modello fuori dal tuo piano, quindi controlla l'elenco prima di presumere l'una o l'altra cosa.

Verifica se la causa è questa

Chiedi all'API cosa vede la tua chiave, invece di fidarti di una pagina di documentazione:

curl -s 'YOUR_BASE_URL/models' \
  -H 'Authorization: Bearer YOUR_KEY' \
  | grep -o '"id":"[^"]*"'

Se il modello non è in quell'elenco, correggere l'ortografia non servirà a nulla: la chiave non può raggiungerlo.

Come risolvere

  1. Copia l'ID, non riscriverlo maiPrendi la stringa direttamente dall'elenco dei modelli. Punti contro trattini e suffissi di versione con data sono i due errori più frequenti.
  2. Controlla l'ambito della tua chiaveSe il modello compare nella documentazione pubblica ma non nel tuo elenco, il problema è ciò che la chiave può raggiungere. Una chiave di un piano di solito non può chiamare i modelli di un altro piano.
  3. Attenzione agli alias che sparisconoGli alias di comodo che puntano alla versione attuale possono essere ritirati senza preavviso. Fissare l'ID completo è più prolisso e decisamente più stabile.
Su APICLAN ogni chiave appartiene a un gruppo, e GET /v1/models restituisce esattamente ciò che quella chiave può chiamare. Gli ID dei modelli attuali e i relativi prezzi sono nella home page.

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.