So verwendest du eine OpenAI-kompatible API in 5 Schritten
Die Nutzung einer OpenAI-kompatiblen API erfordert fünf Schritte: Schlüssel holen, SDK installieren, Base URL einrichten, Modell wählen und Nachrichten senden. Hier ist jeder Schritt mit Code, den du einfügen kannst.

Wichtige Punkte
- Jedes OpenAI SDK funktioniert hier, sobald du die Base URL auf https://api.uncensoredaiapis.com/v1 änderst und deinen eigenen Schlüssel verwendest.
- Die Modell-ID ist uncensored; die Haupt-Endpunkte sind POST /v1/chat/completions und GET /v1/models.
- Streaming, JSON-Modus und Function Calling verwenden dieselben Parameter wie die offizielle API.
- Die Preise liegen bei $0,15 pro 1M Input-Token und $0,50 pro 1M Output-Token, und du kannst mit $0,50 Testguthaben starten.
Die Kurzversion
Wenn du wissen möchtest, wie du API-Aufrufe im OpenAI-Stil mit einem Dienst nutzt, der nicht OpenAI ist, lautet die Antwort, dass das Anfrageformat eine gemeinsame Konvention ist. Ein Client, der diese Konvention spricht, benötigt drei Werte: den Ort für die Anfragen (die Base URL), deine Identität (den Schlüssel) und das auszuführende Modell. Ändere diese drei Werte, und derselbe Code funktioniert. Diese Website folgt dieser Konvention, daher funktionieren die Standard-Pakete für Python und Node.js von OpenAI sowie reines curl.
Sei dir klar, was das bedeutet und was nicht. Kompatibel bedeutet, dass die Schnittstelle übereinstimmt. Es bedeutet nicht, dass dies der offizielle OpenAI-Dienst ist oder dass er OpenAI-Modelle ausführt. Das Backend ist ein Open-Weight-Modell, betrieben von einem unabhängigen Anbieter und abgestimmt darauf, bei rechtmäßiger Nutzung durch Erwachsene ohne Inhaltsablehnungen zu antworten, und du wählst es mit der Modell-ID uncensored. Es verarbeitet nur Text: keine Bilder, Audio, Embeddings oder Fine-Tuning.
Die folgenden fünf Schritte dauern etwa zehn Minuten. Wenn du fertige Snippets in mehreren Sprachen lesen möchtest, sieh dir die Codebeispiel-Seite an.
Schritt 1: Schlüssel besorgen
Melde dich mit Google oder mit E-Mail und Passwort an und öffne die API-Schlüssel-Seite. Neue Nutzer können mit einem Klick $0,50 kostenloses Testguthaben beanspruchen. Es ist 7 Tage gültig, auf einen pro Person begrenzt und erfordert keine Karte. Kopiere den Schlüssel und speichere ihn als Umgebungsvariable, anstatt ihn in den Code einzufügen:
# base URL used below: https://api.uncensoredaiapis.com/v1 , model: uncensored
export API_KEY="paste-your-key-here"Der Test-Schlüssel ist auf 2 parallele Anfragen und 60 Anfragen pro Minute begrenzt. Ein finanzierter Schlüssel erlaubt 8 parallele und 300 pro Minute. Die Details dessen, was das Testguthaben umfasst, findest du in der FAQ zum kostenlosen Testguthaben.
Schritt 2: SDK installieren und die erste Anfrage senden
Installiere das offizielle Paket für deine Sprache. Beide sind dieselben Bibliotheken, die du für jeden OpenAI-ähnlichen Dienst verwenden würdest:
# base URL used below: https://api.uncensoredaiapis.com/v1 , model: uncensored
pip install openai
npm install openaiJetzt ein erster Aufruf in Python. Der einzige Unterschied zur Standardkonfiguration ist das Argument base_url:
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.uncensoredaiapis.com/v1",
api_key=os.environ["API_KEY"],
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a concise writing assistant."},
{"role": "user", "content": "Give me three titles for a noir short story."},
],
)
print(resp.choices[0].message.content)Und derselbe Aufruf in Node:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.uncensoredaiapis.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Give me three titles for a noir short story." }],
});
console.log(resp.choices[0].message.content);Schritt 3: Das Nachrichten-Array verstehen
Chat-Modelle erinnern sich nicht zwischen Aufrufen. Jede Anfrage enthält die gesamte Konversation als Liste von Nachrichten, und jede Nachricht hat eine Rolle.
systemlegt Verhalten und Stil fest. Platziere hier die Persona, Formatregeln und Einschränkungen.userenthält die Anfrage der Person.assistantenthält die früheren Antworten des Modells. Du fügst diese selbst hinzu, wenn du ein Gespräch fortsetzt.toolenthält das Ergebnis eines Funktionsaufrufs, weiter unten behandelt.
Um ein Chat fortzusetzen, hänge die Antwort des Assistenten und die nächste Nachricht des Benutzers an dieselbe Liste an und sende alles erneut. Deshalb kosten lange Gespräche mehr: Jede Anfrage bezahlt für die gesamte Historie als Input-Token. Das Fenster fasst insgesamt 100.000 Token zusammen, Prompt und Completion zusammen, daher ist das Kürzen alter Nachrichten ein normaler Teil beim Aufbau einer Chat-App.
Nützliche Sampling-Felder werden durchgereicht: temperature, top_p, stop, seed sowie die Häufigkeits- und Präsenzstrafen. max_tokens ist optional. Setze es, wenn du die Antwortlänge und die Kosten begrenzen möchtest.
Schritt 4: Streaming, JSON-Modus und Tools
Streaming
Füge stream: true hinzu, um Token als Server-Sent Events zu empfangen. Es lässt Interfaces schnell wirken, da Text erscheint, während das Modell noch schreibt, und die Nutzung wird am Ende des Streams gemeldet.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.uncensoredaiapis.com/v1", apiKey: process.env.API_KEY });
const stream = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Write a short toast for a retirement party." }],
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}JSON-Modus
Verwende response_format: {"type": "json_object"}, wenn dein Code die Antwort parst. Beschreibe die gewünschten Schlüssel ebenfalls im Prompt.
curl https://api.uncensoredaiapis.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"response_format": {"type": "json_object"},
"messages": [
{"role": "system", "content": "Reply with JSON: {\"mood\": string, \"score\": number}"},
{"role": "user", "content": "Rate this line: the rain finally stopped."}
]
}'Funktionsaufruf
Übergib eine tools-Liste mit Funktionsschemata und optional tool_choice. Wenn das Modell eine Funktion ausführen möchte, enthält die Antwort tool_calls. Du führst die Funktion in deinem eigenen Code aus und sendest die Ausgabe als Nachricht mit der Rolle tool zurück. Tool Calls streamen ebenfalls. Dies ist der Baustein für Agents; die Use Cases-Seite zeigt, wo sich das lohnt.
Schritt 5: Grenzen, Kosten und Fehler kennen
Überschreitet ein Limit, gibt die API HTTP 429 zurück. Der Fehlercode ist rate_limited für zu viele Anfragen pro Minute und concurrency für zu viele gleichzeitig. Eine temporäre Überlastung gibt ebenfalls eine 429 mit einem Retry-After: 5-Header zurück. Eine gestreamte Anfrage behält ihren Concurrency-Slot, bis der Stream endet, also schließe Streams, die du nicht mehr liest. Das Limit für den Request-Body beträgt 8 MB. Jede Antwort enthält die Header X-Request-Id und X-Balance-USD, und die erste ist das, was du beim Support zitierst.
Die Kosten sind einfach. Ein Chat-Aufruf mit 3.000 Input-Token und 700 Output-Token kostet 3.000 mal $0,15 pro Million, was $0,00045 entspricht, plus 700 mal $0,50 pro Million, was $0,00035 entspricht, also insgesamt $0,0008. Tausend solcher Aufrufe kosten $0,80. Fehlgeschlagene oder abgelehnte Anfragen werden nicht berechnet, und Guthaben verfällt nie. Die Preisseite listet Aufladungen von $20 bis $500 mit +5% ab $50, +10% ab $100 und +15% ab $200 auf. Du kannst mit Mit Krypto (USDT auf TRC20, USDC auf Base) bezahlen.
Wie dies sich von der offiziellen API unterscheidet
Drei Unterschiede sind es wert, berücksichtigt zu werden. Erstens, der Modellname: Verwende uncensored, nicht einen OpenAI-Modellnamen. Zweitens, Umfang: Du erhältst nur Chat-Vervollständigungen und die Modellliste, daher sind Funktionen wie Bildgenerierung, Speech, Embeddings und Fine-Tuning hier nicht vorhanden. Drittens, Verhalten: Das Modell ist darauf abgestimmt, keine gesetzeskonformen Erwachsenenanfragen abzulehnen, daher kann die Ausgabe von einem stark gefilterten Assistenten abweichen. Eine Regel ändert sich nie: Keine sexuellen Inhalte mit Minderjährigen.
Einige Gewohnheiten helfen am ersten Tag. Halte den Schlüssel in einer Umgebungsvariable, logge die X-Request-Id jeder Anfrage und setze max_tokens, während du experimentierst, damit eine durchgehende Antwort nicht mehr ausgibt, als du geplant hast. Wenn du eine Chat-Schnittstelle baust, stream die Antwort und kürze alte Nachrichten, sobald die Historie wächst. Wenn du eine Pipeline baust, die Ausgaben parst, verwende den JSON-Modus und schütze das Parsing dennoch, da eine bei der Token-Grenze abgeschnittene Antwort kein gültiges JSON ist. Und wenn zwei Teile deines Programms gleichzeitig die API aufrufen, zähle sie gegen die 8 parallelen Anfragen, die ein voller Schlüssel erlaubt.
Vergiss nicht die Kosten des Testens. Ein paar Dutzend Experimente mit kurzen Prompts kosten weit weniger als einen Cent insgesamt, daher reicht das $0,50 Testguthaben lange, während du das Anfrageformat lernst.
Wenn du eine bestehende App migrierst, führt die Migrationsanleitung durch die Änderungen in der Reihenfolge. Hier gesendete Prompts werden nicht zum Training verwendet. Für die meisten Apps ist die Migration die drei Werte vom Anfang dieser Seite und ein Modellname.
Weitere Anleitungen
Fragen und Antworten
Brauche ich das offizielle OpenAI SDK?
Du kannst es nutzen, es ist der einfachste Weg. Jeder OpenAI-kompatible Client oder plain HTTP funktioniert ebenfalls, solange er eine benutzerdefinierte Basis-URL unterstützt.
Welchen Modellnamen sende ich?
Sende uncensored. Die Basis-URL ist https://api.uncensoredaiapis.com/v1.
Ist dies die offizielle OpenAI-API?
Nein. Es folgt demselben Anfrageformat, aber das Modell ist ein Open-Weight-Modell, das von einem unabhängigen Anbieter betrieben wird, und der Dienst ist von OpenAI getrennt.
Wie viel kostet eine Anfrage?
Input-Token kosten $0,15 pro 1M und Output-Token $0,50 pro 1M. Eine Anfrage mit 3.000 Input- und 700 Output-Token kostet etwa $0,0008.
Kann ich es vor der Bezahlung testen?
Ja. Nach der Anmeldung kannst du mit einem Klick $0,50 Testguthaben beanspruchen. Es ist 7 Tage gültig und benötigt keine Karte.
Dein Schlüssel ist nur ein Formular entfernt
Erstelle ein Konto, kopiere den Schlüssel, ändere die Basis-URL. Das ist die gesamte Einrichtung.