DE ▾

GPT-API-Basis-URL: So richtest du sie für jeden OpenAI-Client ein

Die Basis-URL ist die Einstellung, die entscheidet, mit welchem Server dein OpenAI-ähnlicher Client kommuniziert. Ändere sie, ändere den Schlüssel und den Modellnamen, und der Rest deines Codes bleibt unverändert.

Aktualisiert

Pfeil, der Datenpakete von einem Server zu einem anderen umleitet, veranschaulicht eine Änderung der Basis-URL

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.py

Das 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 /v1 und nicht nur der Host. Ohne /v1 erstellt das SDK Pfade, die nicht existieren.
  • Doppelter Pfad. Wenn du .../v1/chat/completions als 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. Setze uncensored.
  • 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_limited bedeutet zu viele Anfragen pro Minute; Code concurrency bedeutet zu viele gleichzeitig. Ein 429 mit einem Retry-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.

Fragen und Antworten

Wie lautet die Basis-URL für deine API?

Es ist https://api.uncensoredgptapi.com/v1. Füge den /v1-Teil hinzu und lass den Endpunkt-Pfad weg.

Welchen Modellnamen verwende ich?

Verwende uncensored. Modellnamen anderer Anbieter, wie gpt-4o, sind hier nicht verfügbar.

Kann ich meinen bestehenden OpenAI SDK-Code verwenden?

Ja. Ändere die Basis-URL, den API-Schlüssel und den Modellnamen. Chat-Vervollständigungen, Streaming, Function Calling und JSON-Modus folgen demselben Anfrageformat.

Funktioniert die Variable OPENAI_BASE_URL?

Die offiziellen OpenAI-SDKs lesen sie, wenn keine Basis-URL im Code übergeben wird, daher ist das Setzen oft ausreichend. Prüfe das von dir genutzte Tool, da einige sie ignorieren.

Warum erhalte ich einen 429-Fehler?

Der Code rate_limited bedeutet zu viele Anfragen pro Minute, und der Code concurrency bedeutet zu viele gleichzeitig. Ein 429 mit einem Retry-After von 5 bedeutet eine temporäre Überlastung, also versuche es nach fünf Sekunden erneut.

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