Risoluzione dei problemi con gli URL di base
Passare da un modello all'altro dovrebbe essere semplice. Cambi l'endpoint e continui a usare lo stesso SDK. Spesso, però, si verificano errori come 401, 404 o 429.
Prima di incolpare l'SDK, esegui questi 7 controlli.
Controlla il prefisso /v1 La maggior parte dei gateway richiede il suffisso /v1 nell'URL di base. Se utilizzi solo il dominio, l'SDK potrebbe chiamare il percorso errato. Copia sempre il formato esatto dalla documentazione del provider.
Verifica le tue chiavi API Mescolare le chiavi è la causa della maggior parte dei fallimenti. Fai attenzione a questi casi:
- Utilizzare una chiave OpenAI con un URL di relay.
- Utilizzare una chiave di relay con un URL OpenAI.
- Utilizzare chiavi di progetti disabilitati.
- Includere spazi extra nella chiave.
Se visualizzi un errore 401, stampa solo i primi e gli ultimi caratteri della tua chiave per confrontarla con la dashboard. Non registrare mai la chiave completa nei log.
Usa i nomi esatti dei modelli Non tirare a indovinare i nomi dei modelli. I nomi dei gateway cambiano in base alla disponibilità. Copia l'ID del modello esattamente dall'elenco del provider. Un nome errato porta a errori 404 o model_not_found.
Esegui una piccola richiesta di test Testa la tua connessione con una singola richiesta di piccole dimensioni prima di fare il debug dell'intera applicazione. Se un semplice "ping" funziona, l'URL, la chiave e il modello sono corretti. Il problema risiede nella logica della tua app, come lo streaming o il tool calling.
Comprendi i codici di errore
- 401 significa che la chiave o lo stato dell'account sono errati.
- 429 significa che hai raggiunto un limite di frequenza (rate limit) o che non hai credito. Se vedi un 429, controlla la pagina di fatturazione. Evita cicli di retry troppo serrati, poiché peggiorano la situazione del limite.
Controlla la pagina di stato Se il tuo codice funzionava ieri ma oggi fallisce, non riscrivere la tua integrazione. Controlla la pagina di stato del provider. Gli incidenti a monte sono comuni con i servizi di relay.
Usa un comando curl Mantieni un comando curl minimale nella documentazione del tuo progetto. Eseguilo quando l'app smette di funzionare.
- Se curl fallisce: esegui il debug del tuo account, del gateway o della rete.
- Se curl funziona: esegui il debug del codice della tua applicazione.
Le basi corrette rendono facile il passaggio tra i modelli.
Community di apprendimento opzionale: https://t.me/GyaanSetuAi