DE ▾
https://api.unrestrictedaiapi.com/v1uncensored2026-10-06
API-Schlüssel erhalten

LLM-API-Fehler 401: Authentifizierungsfehler beheben

Ein LLM-API-Fehler 401 bedeutet, dass der Server deine Anfrage nicht authentifizieren konnte. In fast allen Fällen liegt die Ursache auf Client-Seite: ein falsch getippter Header, ein Schlüssel mit einem Fremdzeichen oder eine Anfrage an den falschen Host. Dieser Leitfaden führt durch die Checks in der Reihenfolge, die das Problem am schnellsten findet.

Aktualisiert

Ein Schlüssel, der nicht zu einem glänzenden Schloss passt, veranschaulicht einen Authentifizierungsfehler beim Aufruf einer LLM-API

Wichtige Punkte

  1. 401 ist ein Authentifizierungsfehler, kein Ratenlimit oder ein Abrechnungsfehler.
  2. Der Header muss exakt lauten Authorization: Bearer YOUR_KEY, mit einem Leerzeichen und ohne Anführungszeichen.
  3. Ein Schlüssel, der an die falsche Base URL gesendet wird, schlägt genauso fehl wie ein falscher Schlüssel.
  4. Teste zuerst mit curl; wenn curl funktioniert, liegt der Fehler in der Konfiguration deiner App.

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_KEY mit fehlendem Wort Bearer.
  • Authorization: Bearer: YOUR_KEY mit einem zusätzlichen Doppelpunkt.
  • Authorization: Bearer "YOUR_KEY" mit Anführungszeichen im Wert.
  • Authorization: Bearer YOUR_KEY mit zwei Leerzeichen.
  • Ein Header namens X-API-Key oder api-key statt Authorization. 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, aber API_KEY=abc in einer eigenen Zeile erreicht keine Kindprozesse. Verwende export.
  • Durch einen anderen Wert überschrieben. Bibliotheken können OPENAI_API_KEY automatisch 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 BedeutungWo du nachsehen kannst
401Fehlender oder ungültiger SchlüsselHeader, Schlüssel, Basis-URL
429Ratenlimit oder temporäre ÜberlastungWarte und versuche es erneut; sieh dir die Dokumentation für die Limits an
400Fehlerhafter AnfragekörperJSON, Modellname, Parameter
404Falscher PfadBasis-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.

Fragen und Antworten

Bedeutet ein 401, dass mein Guthaben aufgebraucht ist?

Nein. Ein 401 betrifft die Authentifizierung: Der Schlüssel fehlt, ist fehlerhaft oder unbekannt. Das Aufbrauchen von Guthaben ist ein separater Zustand.

Warum funktioniert derselbe Schlüssel in curl, aber nicht in meiner App?

Deine App liest wahrscheinlich einen anderen Wert, etwa eine alte Umgebungsvariable, einen zitierten .env-Eintrag oder einen Schlüssel mit Leerzeichen am Ende. Gib die Länge und repr des Schlüssels aus, den dein Code tatsächlich verwendet.

Kann ich meinen OpenAI-Schlüssel mit dieser API verwenden?

Nein. Jeder Schlüssel funktioniert nur auf dem Host, der ihn ausgestellt hat. Verwende den Schlüssel von der API-Schlüssel-Seite zusammen mit der Basis-URL dieser Website.

Wird ein 401 berechnet?

Nein. Fehlgeschlagene oder abgelehnte Anfragen werden nicht berechnet.

Dein Schlüssel ist nur ein Formular entfernt

Erstelle ein Konto, kopiere den Schlüssel, ändere die Basis-URL. Das ist die gesamte Einrichtung.

API-Schlüssel erhalten