Wichtige Punkte
- Unsere Basis-URL ist https://api.uncensoredgptapi.com/v1 und die Modell-ID ist
uncensored. - Python- und Node-SDKs verwenden base_url oder baseURL; beide lesen auch Umgebungsvariablen.
- Die meisten Fehler entstehen durch ein fehlendes /v1, einen doppelten Pfad oder einen alten Modellnamen.
- GET /v1/models ist der schnellste Weg, um zu bestätigen, dass URL und Schlüssel korrekt sind.
Was die Basis-URL leistet
Die GPT-API-Basis-URL ist die Adresse, die ein OpenAI-SDK jedem Endpunkt-Pfad voranstellt. Standardmäßig senden die offiziellen SDKs Anfragen an die Server von OpenAI. Wenn du eine andere Basis-URL festlegst, sendet derselbe Client-Code dasselbe Anfrageformat an einen anderen Server, der dasselbe Protokoll spricht.
Das bedeutet OpenAI-kompatibel in der Praxis. Unsere API akzeptiert POST /v1/chat/completions und GET /v1/models mit denselben JSON-Strukturen, demselben Authorization: Bearer-Header und demselben Streaming-Format. Du änderst also drei Werte:
- Basis-URL:
https://api.uncensoredgptapi.com/v1 - API-Schlüssel: der Schlüssel aus deinem Dashboard
- Modell:
uncensored
Unser Dienst ist ein unabhängiger Dienst, der ein einzelnes Open-Weight-Modell ausführt. Er ist nicht die API von OpenAI und kein Router zu anderen Anbietern, daher existieren Modellnamen wie gpt-4o hier nicht. Verwende überall uncensored.
Python mit dem OpenAI SDK
Übergib im aktuellen Python-SDK base_url beim Erstellen des Clients.
from openai import OpenAI
client = OpenAI(
base_url="https://api.uncensoredgptapi.com/v1",
api_key="YOUR_API_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a concise assistant."},
{"role": "user", "content": "Explain what a base URL is in two sentences."},
],
)
print(resp.choices[0].message.content)Wenn dein Code älter ist und openai.api_base verwendet, nutzt du das Pre-1.0-SDK, wo die globale Einstellung einen anderen Namen hat. Das Paket zu aktualisieren ist meist einfacher als den Code anzupassen. Prüfe die Version mit pip show openai.
Es hilft zu verstehen, wie das SDK eine Anfrage erstellt. Es nimmt deine Basis-URL, hängt den Endpunkt-Pfad wie /chat/completions an und fügt den Authorization: Bearer-Header aus deinem Schlüssel hinzu. Das ist der gesamte Mechanismus. Wenn etwas fehlschlägt, gib die finale URL aus oder logge sie und vergleiche sie mit dem curl-Befehl im nächsten Abschnitt.
Derselbe Client akzeptiert die Einstellungen timeout und max_retries. Die Standardwerte wiederholen die Anfrage bei Verbindungsproblemen mehrmals, was für die meisten Skripte in Ordnung ist. Bei Ratenlimits fange die Ratenlimit-Ausnahme des SDKs ab und warte. Eine gestreamte Anfrage belegt ihren Concurrency-Slot bis zum Ende, daher kann ein Burst langer Streams das Concurrency-Limit erreichen, auch wenn deine Anzahl der Anfragen pro Minute niedrig ist.
import time
from openai import OpenAI, RateLimitError
client = OpenAI(base_url="https://api.uncensoredgptapi.com/v1", api_key="YOUR_API_KEY", max_retries=0)
def ask(text, tries=4):
for attempt in range(tries):
try:
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": text}],
)
return r.choices[0].message.content
except RateLimitError:
time.sleep(5 * (attempt + 1))
raise RuntimeError("still rate limited")Die Wartezeit von fünf Sekunden bei der ersten Wiederholung entspricht dem Wert Retry-After: 5, den die API bei temporärer Überlastung sendet. Ein längeres Warten bei späteren Versuchen verhindert, dass der Endpunkt überlastet wird.
Node und curl
Das Node-SDK verwendet baseURL mit großgeschriebenem URL.
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.uncensoredgptapi.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Name three uses for a base URL." }],
});
console.log(resp.choices[0].message.content);Ohne SDK zeigt curl genau, was das SDK tut. Die vollständige URL ist die Basis-URL plus /chat/completions.
curl https://api.uncensoredgptapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'Das Lesen dieses Befehls ist der klarste Weg, die Basis-URL zu verstehen: Alles bis einschließlich /v1 ist die Basis, und das SDK fügt den Rest hinzu.
Umgebungsvariablen
Wenn du den Code nicht bearbeiten kannst oder eine Einstellung für mehrere Skripte möchtest, lesen die OpenAI-SDKs OPENAI_BASE_URL und OPENAI_API_KEY aus der Umgebung, wenn kein expliziter Wert angegeben wird.
export OPENAI_BASE_URL="https://api.uncensoredgptapi.com/v1"
export OPENAI_API_KEY="YOUR_API_KEY"
python my_script.pyDas ist praktisch für Tools, die du nicht geschrieben hast. Alles, was auf dem OpenAI-SDK basiert, kann die Variablen übernehmen, ohne Änderungen, obwohl du den Modellnamen im Tool auf uncensored setzen musst. Wenn das Tool einen Modellnamen hart codiert, benötigst du eine eigene Einstellung oder eine Codeänderung.
Zwei Endpunkte getrennt halten
Viele Projekte testen gegen einen Endpunkt und stellen gegen einen anderen bereit, oder wechseln zwischen ihnen über die Umgebung. Halte die drei Werte aus deinem Code heraus und lies sie aus der Konfiguration, damit ein Wechsel eine Änderung an einer Datei ist und keine Codebearbeitung.
import os
from openai import OpenAI
client = OpenAI(
base_url=os.environ.get("LLM_BASE_URL", "https://api.uncensoredgptapi.com/v1"),
api_key=os.environ["LLM_API_KEY"],
)
MODEL = os.environ.get("LLM_MODEL", "uncensored")Die Verwendung eigener Variablennamen anstelle der SDK-Standardwerte vermeidet eine stille Falle: Ein Tool, das OPENAI_API_KEY aus der Shell liest, sendet den dort eingestellten Schlüssel an die daneben eingestellte Basis-URL. Wenn du einen alten OpenAI-Schlüssel in deinem Profil und eine neue Basis-URL in deinem Projekt hast, kannst du den Schlüssel eines Dienstes an den anderen senden. Getrennte Namen machen das unmöglich, und du siehst auf einen Blick, welchen Endpunkt ein Skript verwendet.
Behandle den Modellnamen ebenfalls als Konfiguration. Er ist der Wert, der beim Wechsel am häufigsten übrig bleibt, und verursacht die verwirrendsten Fehler, da alles andere korrekt aussieht.
Streaming und Tools verwenden dieselbe Basis-URL
Das Ändern der Basis-URL schränkt die Funktionen nicht ein. Streaming, Function Calling und JSON-Modus gehen denselben /chat/completions-Pfad, daher funktioniert Code, der gegen die ursprüngliche API arbeitete, weiterhin. Streaming gibt Server-Sent Events zurück, mit der Nutzungsmeldung am Ende des Streams.
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredgptapi.com/v1", api_key="YOUR_API_KEY")
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Count from one to five."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
print()Die Prüfung von chunk.choices ist wichtig. Der letzte Chunk, der die Nutzungsinformationen enthält, kann keine Choices haben, und Code, der in eine leere Liste indiziert, stürzt bei der letzten Nachricht ab. Function Calls streamen auf dieselbe Weise als partielle tool_calls-Deltas, die du zusammenbaust, bevor du die Funktion ausführst, und Ergebnisse gehen als Nachrichten mit role: "tool" zurück. Der JSON-Modus verwendet response_format={"type": "json_object"}.
Apps und Frameworks mit einem Basis-URL-Feld
Viele Apps bieten dieselbe Einstellung unter verschiedenen Namen an: API-Basis, Endpunkt, benutzerdefinierte OpenAI-URL oder Host. Die Regel ändert sich nicht. Füge die Basis-URL einschließlich /v1 ein, füge den Schlüssel ein und gib uncensored als Modellnamen ein.
SillyTavern ermöglicht zum Beispiel das Hinzufügen eines OpenAI-kompatiblen Endpunkts. Die Klasse ChatOpenAI von LangChain akzeptiert ein Argument base_url. Andere Frontends nennen das Feld Proxy-URL oder Reverse-Proxy. Die Feldnamen variieren je nach Version, daher suche nach dem, das eine URL mit Endung /v1 akzeptiert.
Einige Apps fragen ein Modell aus einem Dropdown ab, das sie durch Aufruf von GET /v1/models füllen. Dieser Endpunkt funktioniert hier und gibt die Modellliste zurück, daher sollte das Dropdown uncensored anzeigen, sobald URL und Schlüssel korrekt sind. Wenn es leer bleibt, sind URL oder Schlüssel falsch.
Wenn eine App sowohl ein Basis-URL-Feld als auch ein Feld für "Organisation" oder "Projekt" anbietet, lasse die zusätzlichen Felder leer. Diese existieren für den ursprünglichen Dienst und haben hier keine Bedeutung. Wenn eine App einen Schlüssel mit einem bestimmten Präfix erfordert, versuche einen anderen Verbindungstyp, wie eine generische oder benutzerdefinierte OpenAI-kompatible Option, anstatt der Voreinstellung für den ursprünglichen Dienst.
Einige Desktop-Tools testen die Verbindung, indem sie einen bestimmten Modellnamen vom ursprünglichen Anbieter anfordern, und melden einen Fehler, obwohl der Endpunkt in Ordnung ist. Überspringe in diesem Fall die Test-Schaltfläche und sende eine echte Nachricht. Wenn die Antwort ankommt, sind URL, Schlüssel und Modell korrekt, und das Tool ist bei seiner Prüfung nur streng.
Browserbasierte Tools können auch auf Cross-Origin-Regeln stoßen, da die Anfrage die Seite verlässt und zu einem anderen Host geht. Wenn ein Web-Tool im Browser fehlschlägt, die gleiche Anfrage aber in curl funktioniert, führe die Anfrage von einem eigenen kleinen Server aus, damit der Schlüssel außerhalb des Client-Side-Codes bleibt, was sowieso das sicherere Design ist.
Häufige Fehler und deren Behebung
Fast jeder fehlgeschlagene Einrichtungsvorgang kommt von einer kurzen Liste.
- Fehlendes /v1. Die Basis-URL ist
https://api.uncensoredgptapi.com/v1, die vollständige Adresse bis einschließlich/v1und nicht nur der Host. Ohne/v1erstellt das SDK Pfade, die nicht existieren. - Doppelter Pfad. Wenn du
.../v1/chat/completionsals Basis-URL einfügst, hängt das SDK den Pfad erneut an. Gib nur die Basis ein. - Schließender Slash. Die meisten SDKs behandeln ihn, aber einige Tools nicht. Versuche es ohne einen.
- Alter Modellname. Ein Modellname wie
gpt-4o, der aus dem ursprünglichen Code übrig geblieben ist, passt nicht. Setzeuncensored. - Falscher Schlüssel. Verwende den Schlüssel dieses Dienstes. Ein OpenAI-Schlüssel funktioniert hier nicht, und unser funktioniert nicht bei OpenAI.
- Ratenlimit-Fehler. HTTP 429 mit Code
rate_limitedbedeutet zu viele Anfragen pro Minute; Codeconcurrencybedeutet zu viele gleichzeitig. Ein 429 mit einemRetry-After: 5-Header kennzeichnet temporäre Überlastung, also warte fünf Sekunden und wiederhole die Anfrage.
Unsere Anleitung zur Fehlerbehebung geht Integrationsfehler im Detail durch.
Überprüfe die Einrichtung in einer einzigen Anfrage
Bevor du deine gesamte Anwendung startest, rufe den Modell-Endpunkt auf. Das ist günstig und bestätigt gleichzeitig die URL und den Schlüssel.
curl https://api.uncensoredgptapi.com/v1/models \
-H "Authorization: Bearer $API_KEY"Wenn dies eine Liste mit uncensored zurückgibt, sende eine echte Chat-Anfrage. Für einen vollständigen Schlüssel sind bis zu 8 parallele Anfragen und 300 Anfragen pro Minute möglich; ein Test-Schlüssel erlaubt 2 parallele und 60 pro Minute. Jede Antwort enthält X-Request-Id, X-Balance-USD und die Ratenlimit-Header, was bei der Fehlersuche hilfreich ist.
Um einen Schlüssel zu erhalten, registriere dich und nutze die API-Schlüssel-Seite, auf der neue Nutzer mit einem Klick ein $0,50 Testguthaben beanspruchen können. Die Dokumentation behandelt Streaming, Function Calling und JSON-Modus, sobald die Verbindung funktioniert.
