IT ▾
https://api.unrestrictedaiapi.com/v1uncensored2026-10-06
Ottieni la chiave API

Errore 401 API LLM: risoluzione dei problemi di autenticazione

Un errore 401 dell'API LLM indica che il server non ha potuto autenticare la tua richiesta. Nella quasi totalità dei casi la causa è lato client: un header digitato male, una chiave con un carattere estraneo o una richiesta inviata all'host sbagliato. Questa guida illustra i controlli nell'ordine che individua il problema più rapidamente.

Aggiornato

Una chiave che non corrisponde a un lucchetto luminoso, che illustra un errore di autenticazione durante la chiamata a un'API LLM

Punti chiave

  1. 401 è un errore di autenticazione, non un limite di richieste o un errore di fatturazione.
  2. L'intestazione deve essere esattamente Authorization: Bearer YOUR_KEY, con uno spazio e senza virgolette.
  3. Una chiave inviata all'URL base sbagliato fallisce proprio come una chiave errata.
  4. Fai prima un test con curl; se curl funziona, il bug è nella configurazione della tua app.

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_KEY con la parola Bearer mancante.
  • Authorization: Bearer: YOUR_KEY con un due punti extra.
  • Authorization: Bearer "YOUR_KEY" con virgolette all'interno del valore.
  • Authorization: Bearer YOUR_KEY con due spazi.
  • Un'intestazione chiamata X-API-Key o api-key invece di Authorization. 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.py funziona, ma API_KEY=abc sulla sua riga da solo non raggiunge i processi figlio. Usa export.
  • Mascherato da un altro valore. Le librerie possono leggere OPENAI_API_KEY automaticamente. 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:

CodiceSignificato comuneDove cercare
401Chiave mancante o non validaHeader, chiave, base URL
429Limite di richieste o sovraccarico temporaneoRiduci la frequenza e riprova; consulta la documentazione per i limiti
400Corpo della richiesta non validoJSON, nome del modello, parametri
404Percorso erratoBase 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.

Domande e risposte

Un 401 significa che ho esaurito il credito?

No. Un 401 riguarda l'autenticazione: la chiave manca, è malformata o sconosciuta. L'esaurimento del credito è una condizione separata.

Perché la stessa chiave funziona in curl ma non nella mia app?

La tua app sta probabilmente leggendo un valore diverso, come una vecchia variabile d'ambiente, una voce .env tra virgolette o una chiave con spazi bianchi finali. Stampa la lunghezza e la repr della chiave che il tuo codice utilizza effettivamente.

Posso usare la mia chiave OpenAI con questa API?

No. Ogni chiave funziona solo sull'host che l'ha emessa. Usa la chiave dalla pagina delle chiavi API insieme alla base URL di questo sito.

Un 401 viene addebitato?

No. Le richieste fallite o rifiutate non vengono addebitate.

La tua chiave è a un modulo di distanza

Crea un account, copia la chiave, modifica l'URL di base. È tutta la configurazione.

Ottieni la chiave API