Esegui prima questo test curl
Prima di modificare il codice, rimuovi la tua app dalla considerazione. Questo comando invia la richiesta minima valida all'API:
curl -i https://api.unrestrictedaiapi.com/v1/models \
-H "Authorization: Bearer YOUR_KEY"
GET /v1/models non costa nulla, quindi è un modo sicuro per testare una chiave. Il flag -i stampa la riga di stato e le intestazioni.
- 200 e un elenco di modelli: la chiave è corretta. La tua app sta inviando qualcosa di diverso, quindi passa alle sezioni sulle variabili d'ambiente e sull'URL base.
- 401: la chiave o l'intestazione sono errate. Procedi con la sezione successiva.
- Errore di connessione o DNS: l'URL base è sbagliato, che è un problema diverso da 401.
Incolla la chiave manualmente in questo test, non tramite una variabile. Questo rimuove l'ambiente dall'elenco dei sospettati.
Causa 1: l'intestazione non è corretta
L'API si aspetta Authorization: Bearer <key>. Piccole deviazioni producono tutte un errore 401 dell'API LLM:
Authorization: YOUR_KEYcon la parola Bearer mancante.Authorization: Bearer: YOUR_KEYcon un due punti extra.Authorization: Bearer "YOUR_KEY"con virgolette all'interno del valore.Authorization: Bearer YOUR_KEYcon due spazi.- Un'intestazione chiamata
X-API-Keyoapi-keyinvece diAuthorization. Quelle sono convenzioni di altri servizi.
Se usi l'SDK OpenAI, non scrivi tu l'intestazione. L'SDK la costruisce dall'argomento api_key. Se vedi comunque un 401, il valore passato all'SDK è il problema, non il formato dell'intestazione.
Causa 2: la chiave stessa è danneggiata
Le chiavi sono stringhe casuali lunghe, quindi gli errori di copia sono comuni e difficili da individuare a occhio.
- Nuova riga o spazio finale. La copia da un terminale o da un file di testo spesso ne aggiunge uno. Molte librerie HTTP inviano quindi un'intestazione non valida o una chiave che non corrisponde.
- Chiave tronca. Il doppio clic seleziona solo parte della stringa se la chiave contiene caratteri che interrompono la selezione delle parole. Usa invece il pulsante di copia nella pagina delle chiavi API.
- Virgolette smart. Incollare tramite un elaboratore di testi o un'app di chat può sostituire le virgolette dritte con quelle curve.
- Chiave vecchia o ruotata. Se hai creato una nuova chiave, quella vecchia potrebbe non essere più quella che stai utilizzando.
Per verificare la presenza di caratteri invisibili in Python, stampa il repr del valore:
import os
key = os.environ.get("API_KEY", "")
print(repr(key), len(key))
print(repr(key.strip()) == repr(key))
Se la seconda riga stampa False, hai spazi bianchi intorno alla chiave. Usa .strip() quando la leggi.
Causa 3: l'URL base sbagliato
Questo è l'errore più comune quando si passa un'app esistente a un nuovo provider. La tua chiave è valida solo sull'host che l'ha emessa. L'URL base per questo sito è:
{"base_url": "https://api.unrestrictedaiapi.com/v1"}
Si presentano di nuovo e di nuovo due modelli di errore:
- Imposti la nuova chiave ma lasci l'URL base vecchio. La richiesta va al vecchio provider, che rifiuta una chiave che non ha mai visto e restituisce 401. Il testo dell'errore menziona poi il vecchio provider, che è un indizio utile.
- Imposti il nuovo URL base ma lasci una chiave vecchia nell'ambiente. La richiesta ci raggiunge e noi rifiutiamo la chiave dell'altro provider.
Controlla anche il percorso. L'URL base termina già con /v1, quindi gli SDK aggiungono /chat/completions ad esso. Se costruisci l'URL manualmente, il percorso completo è /v1/chat/completions, non /v1/v1/chat/completions.
Causa 4: variabili d'ambiente e file di configurazione
Se curl funziona ma la tua app fallisce, qualcosa sta alimentando l'app con una chiave diversa da quella che pensi.
- Variabile non esportata. In una shell,
API_KEY=abc python app.pyfunziona, maAPI_KEY=abcsulla sua riga da solo non raggiunge i processi figlio. Usaexport. - Mascherato da un altro valore. Le librerie possono leggere
OPENAI_API_KEYautomaticamente. Se è impostato un vecchio valore nel tuo profilo shell, potrebbe sovrascrivere ciò che avevi intenzione di impostare. - Virgolette in un file .env. Alcuni loader mantengono le virgolette come parte del valore. Se la tua chiave arriva racchiusa tra caratteri di virgoletta, rimuovile o testa con il controllo repr sopra.
- Non riavviato. Server e notebook leggono le variabili d'ambiente all'avvio. Riavvia dopo la modifica.
- Ambiente diverso in produzione. Container, CI e dashboard di hosting hanno ciascuno il proprio archivio variabili. Stampa la lunghezza della chiave, mai la chiave stessa, nei log.
Un controllo Python minimo che convalida la configurazione
Questo script usa l'SDK OpenAI e segnala chiaramente se l'autenticazione fallisce:
import os
from openai import OpenAI, AuthenticationError
client = OpenAI(
base_url="https://api.unrestrictedaiapi.com/v1",
api_key=os.environ["API_KEY"].strip(),
)
try:
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Reply with the word ok."}],
max_tokens=5,
)
print("auth ok:", r.choices[0].message.content)
except AuthenticationError as e:
print("401:", e.status_code, e.response.headers.get("X-Request-Id"))
Se questo stampa un X-Request-Id, includilo quando scrivi a support, poiché permette al team di trovare la tua richiesta. Lo stesso controllo in altri linguaggi è nella guida rapida per cinque linguaggi.
401 rispetto ad altri errori
Non perdere tempo con l'autenticazione se l'errore è un altro. Una breve mappa:
| Codice | Significato comune | Dove cercare |
|---|---|---|
| 401 | Chiave mancante o non valida | Header, chiave, base URL |
| 429 | Limite di richieste o sovraccarico temporaneo | Riduci la frequenza e riprova; consulta la documentazione per i limiti |
| 400 | Corpo della richiesta non valido | JSON, nome del modello, parametri |
| 404 | Percorso errato | Base URL ed endpoint |
Controlla anche il nome del modello. Usa uncensored esattamente; un ID modello errato è un errore di richiesta, non un 401. I dettagli della specifica, inclusi gli endpoint e le intestazioni che l'API accetta, sono nella pagina della specificazione API compatibile con OpenAI.
Proxy, browser e ultime risorse
Due configurazioni causano 401 che sembrano misteriosi.
Proxy e gateway
Un proxy inverso, un gateway API o un wrapper serverless tra la tua app e l'API potrebbe eliminare o riscrivere l'intestazione Authorization. Esegui un test dalla stessa macchina con curl e confronta. Alcuni framework inoltrano inoltre l'intestazione solo agli host della stessa origine, quindi un wrapper fetch personalizzato può perdere silenziosamente l'intestazione in una chiamata tra origini diverse.
Chiavi nel codice front-end
Chiamare l'API direttamente dal JavaScript del browser espone la chiave a chiunque apra gli strumenti di sviluppo, e i browser potrebbero anche bloccare la richiesta per motivi di origine diversa che sembrano errori di autenticazione. Tieni la chiave su un server e lascia che il tuo front-end chiami il tuo endpoint, che a sua volta chiama l'API con la chiave allegata. Se una chiave è stata incollata in codice pubblico o in uno screenshot, sostituiscila.
Ancora bloccato
Se una chiave appena copiata restituisce ancora 401 nel test curl, genera di nuovo la chiave dalla pagina delle chiavi API, incollala direttamente nel comando e riprova. Se fallisce, invia al supporto l'orario della richiesta, l'endpoint e l'header di risposta X-Request-Id. Non inviare mai la chiave completa in un messaggio; i primi e gli ultimi quattro caratteri sono sufficienti per identificarla.
