Richte deine Shell ein und prüfe den Endpunkt
Hole einen Schlüssel von der API-Schlüssel-Seite und exportiere ihn zusammen mit der Basis-URL, damit du keine Geheimnisse in jeden Befehl kopierst.
export API_KEY="paste-your-key-here"
export BASE="https://api.uncensoredllmapi.com/v1"
Jede Anfrage sendet den Schlüssel als Bearer-Token im Authorization-Header. Anfrage-Bodys sind JSON, also füge Content-Type: application/json hinzu, wenn du POSTest. Die maximale Body-Größe beträgt 8 MB, was nur relevant ist, wenn du sehr große Dokumente in den Prompt einfügst.
Die Beispiele verwenden die einfachen Anführungszeichen einer Unix-Shell. Unter Windows PowerShell lege das JSON in eine Datei und übergebe es mit --data @body.json, um Anführungszeichenprobleme zu vermeiden.
Die günstigste Integritätsprüfung ist ein GET, das die Modelle auflistet. Es bestätigt den Schlüssel und die URL und kostet nichts.
curl -s "$BASE/models" \
-H "Authorization: Bearer $API_KEY"
Das data-Array in der Antwort sollte die ID uncensored enthalten. Ein 401-Fehler bedeutet, dass der Schlüssel fehlt oder falsch eingegeben wurde. Wenn curl überhaupt keine Verbindung herstellen kann, prüfe den Host in $BASE und stelle sicher, dass er mit /v1 endet und keinen zusätzlichen Pfad hat.
1. Sende eine Chat-Vervollständigung
Dies ist die Anfrage, die jeder OpenAI-kompatible Client im Hintergrund sendet.
curl -s "https://api.uncensoredllmapi.com/v1/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "system", "content": "You are a concise assistant."},
{"role": "user", "content": "Give me three names for a fantasy tavern."}
],
"temperature": 0.8,
"max_tokens": 200
}'
Die Antwort ist JSON. Der Text steht unter choices[0].message.content, und die Token-Anzahlen stehen in usage. Leite die Ausgabe durch jq -r '.choices[0].message.content', wenn du jq installiert hast und nur den Text möchtest. Das max_tokens-Feld ist optional; lass es weg, und die Vervollständigung kann den Rest des 100.000-Token-Fensters nutzen.
Der neuere POST /v1/responses-Endpunkt ist ebenfalls verfügbar, falls dein Client dieses Format verwendet. Für die vollständige Liste der Parameter sieh dir die Dokumentation an.
2. Stream die Antwort
Füge "stream": true hinzu und sage curl, dass es nicht puffern soll, mit -N. Tokens werden ausgegeben, sobald sie generiert werden.
curl -N "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"stream": true,
"messages": [{"role": "user", "content": "Count from one to ten in words."}]
}'
Jede Zeile beginnt mit data: und enthält einen kleinen JSON-Chunk mit einem delta. Die letzten Ereignisse enthalten die Nutzung, und der Stream endet mit data: [DONE]. Ohne -N wartet curl auf einen vollständigen Puffer, und die Ausgabe sieht aus, als käme sie in einem Rutsch. Beachte, dass eine gestreamte Anfrage einen Concurrency-Slot bis zum Ende belegt.
3. Fordere JSON an
Für Ausgaben, die ein Skript parsen soll, aktiviere den JSON-Modus mit response_format. Erwähne das Wort JSON im Prompt, damit das Modell weiß, welche Form du erwartest.
curl -s "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"response_format": {"type": "json_object"},
"messages": [{"role": "user",
"content": "Return JSON with keys name and level for a fantasy character."}]
}' | jq -r '.choices[0].message.content | fromjson'
Der finale fromjson-Filter parst den String innerhalb von content, also schlägt jq lautstark fehl, wenn das Modell etwas zurückgibt, das kein gültiges JSON ist. Das macht es zu einem nützlichen Schnelltest. Weitere Muster findest du auf der JSON-Modus-Seite.
4. Probiere einen Tool-Aufruf aus
Function Calling ermöglicht es dem Modell, deinen Code aufzurufen, um eine Funktion auszuführen. Du beschreibst die Funktion in einem tools-Array, und wenn das Modell sich für die Nutzung entscheidet, enthält die Antwort einen tool_calls-Eintrag statt Text.
curl -s "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "What is the weather in Oslo?"}],
"tools": [{
"type": "function",
"function": {
"name": "get_weather",
"description": "Get current weather for a city",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}},
"required": ["city"]
}
}
}],
"tool_choice": "auto"
}' | jq '.choices[0].message.tool_calls'
Du solltest einen Funktionsnamen und einen JSON-String von Argumenten erhalten. Dein Code führt die Funktion aus und sendet dann eine zweite Anfrage, die die früheren Nachrichten wiederholt, die Assistent-Nachricht mit dem Tool-Aufruf hinzufügt und eine Nachricht mit role: "tool" hinzufügt, die das Ergebnis enthält. Das Modell schreibt dann die finale Antwort.
5. Prüfe Header und Kontostand
Füge -i hinzu, um Antwort-Header zusammen mit dem Body zu sehen. Du findest X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests und X-RateLimit-Limit-Concurrency.
curl -s -i "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}],"max_tokens":5}' \
| grep -i "^x-"
curl -s "$BASE/balance" -H "Authorization: Bearer $API_KEY"
Der zweite Aufruf gibt dein Guthaben direkt zurück. OpenAI-kompatible Tools können stattdessen GET /v1/dashboard/billing/credit_grants verwenden. Eine winzige Anfrage wie die oben genannte kostet einen Bruchteil eines Cents: bei 10 Input-Token und 5 Output-Token beträgt der Preis 10 x 0,15 / 1.000.000 + 5 x 0,50 / 1.000.000 = $0,000004. Sieh dir die Preisseite für die Tarife an.
Ein wiederverwendbares Smoke-Test-Skript
Sobald du den einzelnen Aufrufen vertraust, packe sie in ein kurzes Skript, das du nach jedem Deploy, Schlüsselwechsel oder Netzwerkänderung ausführen kannst. Es schlägt beim ersten Problem fehl, sodass du genau siehst, welcher Schritt kaputt ist.
set -euo pipefail
BASE="https://api.uncensoredllmapi.com/v1"
echo "models:"
curl -sf "$BASE/models" -H "Authorization: Bearer $API_KEY" | jq -r '.data[].id'
echo "chat:"
curl -sf "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Say ok."}],"max_tokens":5}' \
| jq -r '.choices[0].message.content'
echo "balance:"
curl -sf "$BASE/balance" -H "Authorization: Bearer $API_KEY"
Das Flag -f lässt curl bei HTTP-Fehlern mit einem Fehler exiten, und set -e stoppt das Skript dort. Lege es in einen Cron-Job oder einen CI-Schritt, wenn du einen Service auf Basis dieser API betreibst und eine Frühwarnung möchtest, wenn sich etwas ändert. Halte den Schlüssel in einem Secret-Store oder einer Umgebungsvariable, niemals in der Skriptdatei selbst.
Wenn du die Anfrage änderst, versuche eine Einstellung nach der anderen: temperature für Zufälligkeit, top_p für Nucleus-Sampling, stop für benutzerdefinierte Endsequenzen und seed für reproduzierbare Ausgaben. Alle werden an das Modell weitergegeben, sodass du ihre Wirkung aus derselben Terminal-Historie vergleichen kannst.
Fehler von curl lesen
| Code | Wahrscheinliche Ursache | Lösung |
|---|---|---|
| 401 | Fehlender oder falscher Schlüssel | Prüfe den Authorization-Header und dass $API_KEY exportiert ist |
| 400 | Falsch formatiertes JSON oder ungültiges Feld | Validiere den Body mit jq . vor dem Senden |
429, Code rate_limited | Mehr als 300 Anfragen pro Minute (60 bei einem Test-Schlüssel) | Verlangsame deine Schleife |
429, Code concurrency | Mehr als 8 parallele Anfragen (2 auf einem Test-Schlüssel) | Führe weniger parallele Jobs aus |
429 mit Retry-After: 5 | Vorübergehende Überlastung | Warte 5 Sekunden und versuche es erneut |
Füge -w "\n%{http_code}\n" hinzu, um den Statuscode nach dem Body zu drucken, was dir das Raten erspart. Fehler-Bodys sind JSON mit einer Nachricht und einem Code, also zeigt jq .error sie sauber an. Wenn du eine 429 in einer Schleife siehst, wiederhole nicht sofort; eine Pause von einigen Sekunden lässt das Minutenfenster und die Concurrency-Slots ablaufen, und eine enge Wiederholungsschleife hält dich nur über dem Limit. Ein Schlüssel für kostenloses Testguthaben hat strengere Limits als ein voller Schlüssel, daher kann ein Skript, das nach deiner ersten Aufladung funktioniert, bei kostenlosem Testguthaben fehlschlagen, wenn es Jobs parallel ausführt. Sobald die Anfragen funktionieren, wechsle zu einem SDK; dieselbe URL und Modellname bleiben unverändert. Neue Konten können mit einem Klick 0,50 $ kostenloses Testguthaben beanspruchen, genug für Hunderte kleiner Testaufrufe. Aufladungen danach beginnen bei 20 $ und werden in Krypto bezahlt (USDT auf TRC20 oder USDC auf Base).
