Führe diesen curl-Test zuerst aus
Nimm deine App vor der Code-Änderung aus dem Bild. Dieser eine Befehl sendet die minimal gültige Anfrage an die API:
curl -i https://api.unrestrictedaiapi.com/v1/models \
-H "Authorization: Bearer YOUR_KEY"
GET /v1/models kostet nichts, also ist es eine sichere Möglichkeit, einen Schlüssel zu testen. Das Flag -i gibt die Statuszeile und Header aus.
- 200 und eine Modellliste: Der Schlüssel ist in Ordnung. Deine App sendet etwas anderes, also gehe zu den Abschnitten über Umgebungsvariablen und Base URL.
- 401: Der Schlüssel oder der Header ist falsch. Fahre mit dem nächsten Abschnitt fort.
- Verbindungs- oder DNS-Fehler: Die Base URL ist falsch, was ein anderes Problem als 401 ist.
Füge den Schlüssel manuell in diesen Test ein, nicht über eine Variable. Das entfernt die Umgebung aus der Liste der Verdächtigen.
Ursache 1: Der Header ist nicht ganz richtig
Die API erwartet Authorization: Bearer <key>. Kleine Abweichungen erzeugen alle einen LLM-API-Fehler 401:
Authorization: YOUR_KEYmit fehlendem Wort Bearer.Authorization: Bearer: YOUR_KEYmit einem zusätzlichen Doppelpunkt.Authorization: Bearer "YOUR_KEY"mit Anführungszeichen im Wert.Authorization: Bearer YOUR_KEYmit zwei Leerzeichen.- Ein Header namens
X-API-Keyoderapi-keystattAuthorization. Das sind Konventionen anderer Dienste.
Wenn du ein OpenAI SDK verwendest, schreibst du den Header nicht selbst. Das SDK erstellt ihn aus dem Argument api_key. Wenn du trotzdem einen 401 siehst, ist der an das SDK übergebene Wert das Problem, nicht das Header-Format.
Ursache 2: Der Schlüssel selbst ist beschädigt
Schlüssel sind lange zufällige Zeichenfolgen, daher sind Kopierfehler häufig und mit bloßem Auge schwer zu erkennen.
- Nachgestelltes Leerzeichen oder Zeilenumbruch. Das Kopieren aus einem Terminal oder einer Textdatei fügt oft eines hinzu. Viele HTTP-Bibliotheken senden dann einen ungültigen Header oder einen Schlüssel, der nicht übereinstimmt.
- Abgeschnittener Schlüssel. Ein Doppelklick wählt nur einen Teil der Zeichenfolge aus, wenn der Schlüssel Zeichen enthält, die die Wortauswahl stören. Verwende stattdessen die Kopier-Schaltfläche auf der API-Schlüssel-Seite.
- Geschweifte Anführungszeichen. Beim Einfügen über eine Textverarbeitung oder Chat-App können gerade Anführungszeichen durch geschweifte ersetzt werden.
- Alter oder rotierter Schlüssel. Wenn du einen neuen Schlüssel erstellt hast, ist der alte möglicherweise nicht mehr der, den du verwendest.
Um nach unsichtbaren Zeichen in Python zu suchen, gib die repr des Werts aus:
import os
key = os.environ.get("API_KEY", "")
print(repr(key), len(key))
print(repr(key.strip()) == repr(key))
Wenn die zweite Zeile False ausgibt, hast du Leerzeichen um den Schlüssel. Rufe .strip() beim Lesen auf.
Ursache 3: Die falsche Base URL
Dies ist der häufigste Fehler beim Wechsel einer bestehenden App zu einem neuen Anbieter. Dein Schlüssel ist nur auf dem Host gültig, der ihn ausgestellt hat. Die Base URL für diese Website ist:
{"base_url": "https://api.unrestrictedaiapi.com/v1"}
Zwei Fehlermuster treten immer wieder auf:
- Du hast den neuen Schlüssel gesetzt, aber die alte Base URL beibehalten. Die Anfrage geht an den alten Anbieter, der einen Schlüssel, den er noch nie gesehen hat, ablehnt und 401 zurückgibt. Der Fehlertext erwähnt dann den alten Anbieter, was ein nützlicher Hinweis ist.
- Du hast die neue Base URL gesetzt, aber einen alten Schlüssel in der Umgebung belassen. Die Anfrage erreicht uns, und wir lehnen den Schlüssel des anderen Anbieters ab.
Prüfe auch den Pfad. Die Base URL endet bereits in /v1, daher fügen SDKs /chat/completions hinzu. Wenn du die URL manuell erstellst, ist der vollständige Pfad /v1/chat/completions, nicht /v1/v1/chat/completions.
Ursache 4: Umgebungsvariablen und Konfigurationsdateien
Wenn curl funktioniert, deine App aber fehlschlägt, erhält deine App einen anderen Schlüssel, als du denkst.
- Variable nicht exportiert. In einer Shell funktioniert
API_KEY=abc python app.py, aberAPI_KEY=abcin einer eigenen Zeile erreicht keine Kindprozesse. Verwendeexport. - Durch einen anderen Wert überschrieben. Bibliotheken können
OPENAI_API_KEYautomatisch lesen. Wenn ein alter in deinem Shell-Profil gesetzt ist, kann er das überschreiben, was du beabsichtigt hast. - Anführungszeichen in einer .env-Datei. Einige Loader behalten die Anführungszeichen als Teil des Werts. Wenn dein Schlüssel in Anführungszeichen eingeschlossen ankommt, entferne sie oder teste mit der repr-Prüfung oben.
- Nicht neu gestartet. Server und Notebooks lesen Umgebungsvariablen beim Start. Starte nach der Bearbeitung neu.
- Unterschiedliche Umgebung in der Produktion. Container, CI und Hosting-Dashboards haben jeweils ihre eigene Variable-Speicherung. Gib die Schlüssellänge aus, niemals den Schlüssel selbst, in den Logs.
Eine minimale Python-Prüfung, die die Konfiguration beweist
Dieses Skript verwendet das OpenAI SDK und meldet klar, wenn die Authentifizierung fehlschlägt:
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"))
Wenn hier eine X-Request-Id ausgegeben wird, füge sie bei deiner Anfrage an Support bei, damit das Team deine Anfrage finden kann. Die gleiche Prüfung in anderen Sprachen findest du im Quickstart für fünf Sprachen.
401 im Vergleich zu anderen Fehlern
Verbringe keine Zeit mit der Authentifizierung, wenn der Fehler etwas anderes ist. Eine kurze Übersicht:
| Code | Übliche Bedeutung | Wo du nachsehen kannst |
|---|---|---|
| 401 | Fehlender oder ungültiger Schlüssel | Header, Schlüssel, Basis-URL |
| 429 | Ratenlimit oder temporäre Überlastung | Warte und versuche es erneut; sieh dir die Dokumentation für die Limits an |
| 400 | Fehlerhafter Anfragekörper | JSON, Modellname, Parameter |
| 404 | Falscher Pfad | Basis-URL und Endpunkt |
Prüfe auch den Modellnamen. Verwende uncensored exakt; eine falsche Modell-ID ist ein Anfragefehler, kein 401. Die Spezifikation, einschließlich der Endpunkte und Header, die die API akzeptiert, findest du auf der Seite OpenAI-kompatible API-Spezifikation.
Proxies, Browser und letzte Auswege
Zwei Konfigurationen verursachen 401-Fehler, die rätselhaft wirken.
Proxies und Gateways
Ein Reverse Proxy, API-Gateway oder serverless Wrapper zwischen deiner App und der API kann den Authorization-Header löschen oder umschreiben. Teste von derselben Maschine mit curl und vergleiche. Einige Frameworks leiten den Header nur an Hosts derselben Herkunft weiter, sodass ein benutzerdefinierter Fetch-Wrapper ihn bei einer Cross-Origin-Anfrage stillschweigend verlieren kann.
Schlüssel im Frontend-Code
Wenn du die API direkt aus Browser-JavaScript aufrufst, wird der Schlüssel für jeden sichtbar, der die Entwickler-Tools öffnet, und Browser können die Anfrage auch aus Cross-Origin-Gründen blockieren, die wie Authentifizierungsfehler aussehen. Halte den Schlüssel auf einem Server und lass dein Frontend deinen eigenen Endpunkt aufrufen, der wiederum die API mit angehängtem Schlüssel aufruft. Wenn ein Schlüssel jemals in öffentlichem Code oder einem Screenshot eingefügt wurde, ersetze ihn.
Immer noch festgefahren
Wenn ein frisch kopierter Schlüssel im curl-Test weiterhin 401 zurückgibt, generiere den Schlüssel auf der API-Schlüssel-Seite erneut, füge ihn direkt in den Befehl ein und versuche es erneut. Wenn das fehlschlägt, sende dem Support die Uhrzeit der Anfrage, den Endpunkt und den X-Request-Id-Response-Header. Sende den vollständigen Schlüssel niemals in einer Nachricht; die ersten und letzten vier Zeichen reichen zur Identifikation aus.
