DE ▾
API-Schlüssel erhalten

OpenAI-kompatible API mit cURL und Bearer-Token

Um eine OpenAI-ähnliche API über die Kommandozeile aufzurufen, sendest du ein HTTP POST mit einem Authorization-Header, der dein Token enthält. Diese Seite enthält funktionierende cURL-Befehle für alle Funktionen dieser API und die Checks, die du bei Fehlern durchführen solltest.

Aktualisiert

Terminalfenster, das einen goldenen Schlüssel und Datenpakete über ein Lichtband an einen Server sendet

Wichtige Punkte

  • Der Token kommt in den Header Authorization: Bearer YOUR_KEY, und die Modell-ID ist uncensored.
  • Es gibt zwei Endpunkte: GET /v1/models und POST /v1/chat/completions.
  • Füge -N und stream true hinzu, um Token über Server-Sent Events einzusehen.
  • Lese X-Balance-USD und die Ratenlimit-Header mit curl -i; ein 429 bedeutet warten und erneut versuchen.

Die minimale Anfrage

Hier ist der kürzeste Weg, um open ai api curl mit Token gegen diesen Dienst zu nutzen. Lege den Schlüssel in einer Umgebungsvariable ab, damit er nicht in deiner Shell-Historie landet, und sende dann eine Chat-Nachricht:

export UF_KEY="paste-your-key-here"

curl https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "user", "content": "Explain what a bearer token is in two sentences."}
    ]
  }'

Die Antwort ist JSON im OpenAI-Chat-Vervollständigungsformat. Die Antwort steht unter choices[0].message.content, und ein usage-Objekt meldet Prompt- und Completion-Token. Jeder Teil des Befehls hat eine Aufgabe:

  • Authorization: Bearer ... enthält das Token. "Bearer" ist der Schemaname; wer das Token besitzt, wird als Inhaber behandelt, weshalb du es aus öffentlichen Repositories fernhältst.
  • Content-Type: application/json teilt dem Server mit, wie er den Body lesen soll. Ohne diesen Header schlägt die Anfrage oft mit einem Body-Parsing-Fehler fehl.
  • model muss uncensored sein, das einzige Modell, das diese API bereitstellt.
  • messages ist eine Liste von Objekten mit einer role (system, user, assistant oder tool) und content.

Um einen Schlüssel zu erhalten, registriere dich mit Google oder E-Mail und Passwort und nutze dann die API-Schlüssel-Seite. Neue Nutzer können dort mit einem Klick $0,50 Testguthaben beanspruchen: keine Karte erforderlich, 7 Tage gültig, eine pro Person.

Prüfe den Schlüssel mit GET /v1/models

Bevor du eine lange Anfrage debuggst, bestätige, dass das Token mit der günstigsten verfügbaren Anfrage funktioniert. Das Auflisten von Modellen kostet nichts und zeigt, ob URL, Header und Schlüssel korrekt sind.

curl -s https://api.unfilteredaimodels.com/v1/models \
  -H "Authorization: Bearer $UF_KEY"

Eine gute Antwort ist eine JSON-Liste, die uncensored enthält. Wenn jq installiert ist, leite die Ausgabe weiter, um nur die IDs zu extrahieren:

curl -s https://api.unfilteredaimodels.com/v1/models \
  -H "Authorization: Bearer $UF_KEY" | jq -r '.data[].id'

Wenn nichts Nützliches zurückkommt, gehe die Liste unten der Reihe nach durch, da die Ursachen nach Häufigkeit sortiert sind:

  1. Die Variable ist leer. Führe echo "${UF_KEY:0:6}" aus, um die ersten Zeichen zu sehen, ohne den gesamten Schlüssel auszugeben.
  2. Der Header ist falsch geschrieben oder "Bearer" fehlt vor dem Schlüssel.
  3. Geschweifte Anführungszeichen aus einem Dokument oder Chat-Client haben gerade Anführungszeichen in der Befehlszeile ersetzt.
  4. Die Base URL ist falsch. Sie lautet https://api.unfilteredaimodels.com/v1, mit api. davor und /v1 am Ende.
  5. Der Schlüssel wurde mit einem nachgestellten Leerzeichen oder Zeilenumbruch kopiert.

Lies die Antwort-Header

Füge -i hinzu, um Header in die Ausgabe einzubeziehen, oder -D -, um sie auszugeben, während der Körper sauber bleibt:

curl -s -D - -o /dev/null \
  https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","max_tokens":5,"messages":[{"role":"user","content":"ping"}]}'

Vier Antwort-Header sind es wert, bekannt zu sein:

HeaderBedeutung
X-Request-IdKennung für diese Anfrage. Zitiere sie, wenn du den Support kontaktierst.
X-Balance-USDDein verbliebenes Prepaid-Guthaben.
X-RateLimit-Limit-RequestsAnfragen pro Minute, die für deinen Schlüssel erlaubt sind.
X-RateLimit-Limit-ConcurrencyGleichzeitige Anfragen, die für deinen Schlüssel erlaubt sind.

Die Limits liegen bei 300 Anfragen pro Minute und 8 parallelen Anfragen für einen vollständigen Schlüssel sowie 60 pro Minute und 2 parallelen für einen Testschlüssel. Die obige Anfrage setzt max_tokens auf 5, um den Test klein zu halten. Im normalen Betrieb ist max_tokens optional, und die Vervollständigung kann den Rest des 100.000-Token-Kontextfensters nach deinem Prompt nutzen.

Streaming von der Kommandozeile

Setze "stream": true und füge -N hinzu, damit curl die Ausgabe nicht puffert. Du siehst Zeilen, die mit data: beginnen, die jeweils ein kleines JSON-Delta enthalten, und eine letzte data: [DONE]. Das vorherige Chunk enthält die Token-Nutzung.

curl -N https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "stream": true,
    "messages": [{"role": "user", "content": "Write a four-line poem about a cron job."}]
  }'

Um nur den Text auszugeben, filtere den Stream mit einer kurzen Pipeline:

curl -sN https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","stream":true,"messages":[{"role":"user","content":"Count to five."}]}' \
  | sed -u 's/^data: //' | grep -v '^\[DONE\]' | grep -v '^$' \
  | jq -rj '.choices[0].delta.content // empty'
echo

Eine gestreamte Anfrage belegt ihren Concurrency-Slot, bis der Stream endet. Wenn du viele Streams parallel aus einem Skript startest und vergisst, sie beenden zu lassen, erreichst du das Concurrency-Limit, auch wenn die Anfragerate niedrig ist.

JSON-Modus und Tool-Aufrufe

Der JSON-Modus lässt das Modell ein einzelnes gültiges JSON-Objekt zurückgeben. Gib die gewünschte Struktur im Prompt an, sonst sind die Schlüssel willkürlich vom Modell gewählt.

curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "response_format": {"type": "json_object"},
    "messages": [
      {"role": "user", "content": "Return JSON with keys city and country for the capital of Portugal."}
    ]
  }' | jq -r '.choices[0].message.content'

Tool Calling nutzt die Standardfelder tools und tool_choice. Das Modell antwortet mit einem tool_calls-Array statt mit Text; du führst die Funktion selbst aus und sendest das Ergebnis als Nachricht mit role: "tool" und der passenden tool_call_id zurück.

curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "tool_choice": "auto",
    "tools": [{
      "type": "function",
      "function": {
        "name": "get_weather",
        "description": "Get current weather for a city",
        "parameters": {
          "type": "object",
          "properties": {"city": {"type": "string"}},
          "required": ["city"]
        }
      }
    }],
    "messages": [{"role": "user", "content": "What is the weather in Lisbon?"}]
  }'

Suche in der Antwort nach choices[0].message.tool_calls[0].function.arguments. Es ist ein JSON-String, den du parst, deine eigene Wetter-Funktion damit aufrufst und in der nächsten Anfrage zurückgibst. Parameter wie temperature, top_p, stop, seed und die Penalties werden durchgereicht. Die Dokumentation listet alle unterstützten Felder auf.

Halte das Token sicher und die Befehle aufgeräumt

Ein Bearer-Token ist ein Passwort mit einem anderen Namen. Jeder, der es hat, kann dein Guthaben ausgeben, also behandle es mit der gleichen Sorgfalt. Füge niemals einen echten Schlüssel in ein öffentliches Issue, einen Screenshot oder ein gemeinsam genutztes Terminal-Log ein. Wenn du vermutest, dass ein Schlüssel geleakt wurde, ersetze ihn auf der Schlüsselseite und aktualisiere deine Skripte.

Die Shell-Historie ist das häufigste Leck auf einem persönlichen Rechner. Das direkte Eingeben des Schlüssels in einen Befehl speichert ihn in der Historie-Datei. Das einmalige Setzen mit export speichert diese Zeile ebenfalls. Zwei sauberere Gewohnheiten helfen: Lies den Schlüssel aus einer Datei, die nur du öffnen kannst, oder füge dem Befehl ein Leerzeichen voran, wenn deine Shell so eingestellt ist, dass sie Zeilen mit führendem Leerzeichen ignoriert. Eine kleine Datei funktioniert gut:

mkdir -p ~/.config/uf
printf '%s' 'paste-your-key-here' > ~/.config/uf/key
chmod 600 ~/.config/uf/key

export UF_KEY="$(cat ~/.config/uf/key)"

Lange JSON-Körper sind in einfachen Anführungszeichen schwer lesbar, und das Quoting bricht sofort, wenn der Prompt selbst ein Apostroph enthält. Lege den Körper in eine Datei und lass curl ihn mit -d @file lesen:

cat > request.json <<'JSON'
{
  "model": "uncensored",
  "temperature": 0.3,
  "messages": [
    {"role": "system", "content": "You answer in plain language."},
    {"role": "user", "content": "What's the difference between a 401 and a 403 status code?"}
  ]
}
JSON

curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d @request.json | jq -r '.choices[0].message.content'

Der gleiche Ansatz hält große Prompts unter der 8-MB-Körpergrenze handhabbar, und eine Datei kann in Git versioniert werden, während der Schlüssel außerhalb des Repositories bleibt. Unter Windows PowerShell verhalten sich einfache Anführungszeichen um JSON anders, und die Backslash-Zeilenfortsetzung existiert nicht; die -d @request.json-Form vermeidet beide Probleme, und du kannst ein Backtick am Ende einer Zeile verwenden, um den Befehl fortzusetzen.

Wenn du mit dem Testen fertig bist, wechsle zu einem SDK. Die OpenAI Python- und Node-Bibliotheken akzeptieren die gleiche Base URL und den gleichen Schlüssel, behandeln Retries und Streaming für dich und lesen das gleiche Antwortformat, das du hier von Hand parst. Die cURL-Befehle bleiben der schnellste Weg, um zu prüfen, ob ein Fehler aus deinem Code oder der Anfrage selbst stammt, also behalte einen bekannten guten Befehl in deinen Notizen. Wenn du ein Problem beim Support meldest, füge die X-Request-Id der fehlgeschlagenen Anfrage und den exakten Statuscode bei; dieses Paar ermöglicht es jemandem, die Anfrage zu finden, ohne dass du den Test wiederholen musst, und spart Hin- und Her.

Fehler, Retries und Kosten pro Anfrage

Wenn du ein Limit überschreitest, antwortet die API mit HTTP 429. Der Fehlercode sagt dir, welches Limit: rate_limited bedeutet zu viele Anfragen pro Minute, concurrency bedeutet zu viele gleichzeitig. Eine temporäre Überlastung gibt ebenfalls 429 zurück und fügt Retry-After: 5 hinzu. Curl kann bei transienten Fehlern automatisch wiederholen:

curl --retry 3 --retry-delay 5 --retry-all-errors \
  https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Hello"}]}'

Halte den Body ebenfalls unter 8 MB, was wichtig ist, wenn du Dateien, die in den Prompt kodiert sind, postest.

Fehlgeschlagene oder abgelehnte Anfragen werden nicht berechnet. Erfolgreiche folgen einer einfachen Formel: 0,15 $ pro 1M Input-Token und 0,50 $ pro 1M Output-Token. Ein Testaufruf mit 40 Input-Token und 120 Output-Token kostet 40 / 1.000.000 x 0,15 $ = 0,000006 $ plus 120 / 1.000.000 x 0,50 $ = 0,00006 $, also insgesamt 0,000066 $. Tausend davon ergeben 0,066 $.

Guthaben ist Prepaid und verfällt nie. Aufladungen laufen von 20 $ bis 500 $ in ganzen Beträgen, mit einem Bonus von 5 % ab 50 $, 10 % ab 100 $ und 15 % ab 200 $, per Krypto (USDT auf TRC20, USDC auf Base). Die Preise-Seite zeigt die Details. Wenn eine Antwort falsch aussieht, erklärt die Mythen und Fakten-Seite, was das Modell kann und nicht kann.

Fragen und Antworten

Dein Schlüssel ist nur ein Formular entfernt

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

Wo kommt der Token in einem cURL-Befehl hin?
    In einen Header: -H "Authorization: Bearer YOUR_KEY". Der Request-Body benötigt auch den Content-Type: application/json Header.
Welchen Modellnamen soll ich verwenden?
    Nutze unzensiert. Du kannst das mit GET /v1/models bestätigen.
Warum erhalte ich 429?
    Du hast ein Limit erreicht. Der Code rate_limited bedeutet zu viele Anfragen pro Minute, concurrency bedeutet zu viele gleichzeitig. Warte ein paar Sekunden oder reduziere die Anzahl der parallelen Aufrufe.
Wie sehe ich mein verbleibendes Guthaben?
    Jede Antwort enthält einen X-Balance-USD-Header. Gib Header mit curl -i oder curl -D - aus.
Ist dies die offizielle OpenAI-API?
    Nein. Es ist ein unabhängiger OpenAI-kompatibler Dienst, der ein Open-Weight-Modell ausführt, daher funktionieren SDKs und cURL-Befehle, die für das OpenAI-Format erstellt wurden, nach Änderung der Basis-URL und des Schlüssels.