Home → Assistenza

I modelli di un endpoint personalizzato non compaiono nell'elenco del client

Cosa vedi

• The model dropdown is empty after switching to a custom endpoint
• Only the provider's built-in model names are offered
• A model you know exists is not selectable
• Typing the model name manually works, picking it from the list does not

Perché succede

I client con nomi di modello scritti nel codice sono stati costruiti per un provider specifico. Puntarli altrove ti dà l'endpoint giusto con il menu sbagliato, e i nomi che inviano potrebbero non esistere affatto nell'upstream.

I client che recuperano l'elenco di solito chiamano GET /v1/models. Se alla tua base URL manca il prefisso di versione, quella chiamata riceve un 404 in silenzio e il menu a tendina resta vuoto senza mostrare alcun errore.

Alcuni client memorizzano l'elenco in cache in modo aggressivo. Un modello aggiunto nell'upstream dopo la configurazione del client non comparirà finché la cache non verrà svuotata o l'applicazione riavviata.

Verifica se la causa è questa

Interroga direttamente l'endpoint: è ciò che vede un client ben fatto:

curl -s 'YOUR_BASE_URL/models' -H 'Authorization: Bearer YOUR_KEY' \
  | head -c 400

Un elenco JSON significa che l'endpoint va bene e il problema è il client. Un 404 significa che la base URL è sbagliata; l'HTML significa che punta a un sito web.

Come risolvere

1. Scrivi a mano il nome del modello se il client lo consenteLa maggior parte dei client accetta da qualche parte un campo modello a testo libero, anche quando il menu a tendina è fisso. Così l'elenco viene aggirato del tutto.
2. Usa una mappatura dei modelli quando i nomi non si possono cambiareSe il client insiste sui propri identificatori, mappali su nomi serviti dall'endpoint. Alcuni strumenti lato client lo offrono direttamente.
3. Riavvia dopo aver cambiato endpointConfigurazione ed elenchi di modelli vengono di solito letti all'avvio. Chiudere la finestra non sempre basta: esci completamente dall'applicazione.

Articoli correlati

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