DE ▾
API-Schlüssel erhalten

uncensoredqwen.comAnleitung

Qwen-API-SDK: Verwende stattdessen das OpenAI Python SDK

Ein dediziertes Qwen-API-SDK ist für diese API nicht erforderlich. Sie verwendet das OpenAI-Protokoll, daher funktionieren die offiziellen OpenAI-SDKs, sobald du die Basis-URL und den Schlüssel änderst. Diese Seite zeigt Installation, erste Anfrage, Streaming, Tools und Fehlerbehandlung.

Aktualisiert

Isometrischer Adapter, der eine Standard-SDK-Socket mit einem kleinen Server verbindet und die Wiederverwendung des OpenAI-SDKs zeigt

Warum das OpenAI-SDK alles abdeckt, was du brauchst

Wenn nach einem Qwen-API-SDK gesucht wird, wollen Nutzer meist eine Client-Bibliothek, die Authentifizierung, Wiederholungen, Streaming und typisierte Antworten verarbeitet. Die OpenAI-SDKs leisten das bereits, und dieser Dienst implementiert dieselbe HTTP-Schnittstelle: POST /v1/chat/completions, POST /v1/responses und GET /v1/models. Jeder Client, der das Überschreiben der Basis-URL erlaubt, kann damit kommunizieren.

Eine Klarstellung vor dem Start: Dies ist nicht die offizielle API von Alibaba oder eines anderen Modellanbieters und kein Router, der Anfragen weiterleitet. Es ist ein Open-Weight-Modell, betrieben von einem unabhängigen Anbieter und optimiert für Antworten ohne Inhaltsfilter für die legale Nutzung durch Erwachsene. Die einzige Modell-ID, die du übergibst, ist uncensored.

Das macht die Migration einfach. Wenn dein Projekt bereits ein gehostetes Chat-Modell über das OpenAI-SDK aufruft, änderst du drei Werte: die Basis-URL, den API-Schlüssel und den Modellnamen. Nichts anderes in deinem Code muss verschoben werden.

Installation und erster Aufruf

Installiere das offizielle Paket für Python oder Node. Es gibt keine dienstspezifischen Ergänzungen.

pip install openai
# Node: npm install openai

Erstelle einen Schlüssel auf der API-Schlüssel-Seite und exportiere ihn, damit er nicht in deinem Quellcode landet.

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

Jetzt das kleinste nützliche Python-Skript. Der Client liest den Schlüssel aus der Umgebung und sendet Anfragen an den Dienst statt an OpenAI.

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.uncensoredqwen.com/v1",
    api_key=os.environ["API_KEY"],
)

resp = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You are a concise technical assistant."},
        {"role": "user", "content": "Explain what a context window is in two sentences."},
    ],
    temperature=0.7,
)
print(resp.choices[0].message.content)
print(resp.usage)

Wenn du rohes HTTP bevorzugst, sieht dieselbe Anfrage in curl so aus:

curl https://api.uncensoredqwen.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Say hello."}]}'

Streaming-Antworten mit dem SDK

Setze stream=True und iteriere über die Chunks. Der Dienst sendet Server-Sent Events und meldet die Token-Nutzung am Ende des Streams, sodass du die Kosten ohne zweiten Aufruf protokollieren kannst.

import os
from openai import OpenAI

client = OpenAI(base_url="https://api.uncensoredqwen.com/v1",
                api_key=os.environ["API_KEY"])

stream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Write a short product description for a desk lamp."}],
    stream=True,
    stream_options={"include_usage": True},
)

for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)
    if getattr(chunk, "usage", None):
        print("\nTokens:", chunk.usage.prompt_tokens, chunk.usage.completion_tokens)

Behalte eines im Kopf: Eine gestreamte Anfrage belegt ihren Parallelitäts-Slot, bis der Stream endet. Wenn ein Client langsam ist oder du den Stream nicht schließt, erreichst du das Parallelitätslimit schneller als erwartet.

Dasselbe Muster in Node:

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.uncensoredqwen.com/v1",
  apiKey: process.env.API_KEY,
});

const stream = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Name three uses of JSON mode." }],
  stream: true,
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

Tool Calling und JSON-Modus

Die SDK-Parameter, die du bereits für Tools verwendest, werden direkt durchgereicht: tools, tool_choice, gestreamte tool_calls und Ergebnisse, die als Nachrichten mit role: "tool" zurückgesendet werden. Eine minimale Anfragezyklus sieht so aus:

import os, json
from openai import OpenAI

client = OpenAI(base_url="https://api.uncensoredqwen.com/v1",
                api_key=os.environ["API_KEY"])

tools = [{
    "type": "function",
    "function": {
        "name": "get_order_status",
        "description": "Look up an order by id",
        "parameters": {
            "type": "object",
            "properties": {"order_id": {"type": "string"}},
            "required": ["order_id"],
        },
    },
}]

messages = [{"role": "user", "content": "Where is order A-1042?"}]
first = client.chat.completions.create(model="uncensored", messages=messages, tools=tools)
call = first.choices[0].message.tool_calls[0]

messages.append(first.choices[0].message)
messages.append({
    "role": "tool",
    "tool_call_id": call.id,
    "content": json.dumps({"status": "shipped"}),
})
final = client.chat.completions.create(model="uncensored", messages=messages, tools=tools)
print(final.choices[0].message.content)

Für strukturierte Ausgaben gib response_format={"type": "json_object"} an und fordere im Prompt auch "antworte in JSON". Der JSON-Modus bittet das Modell um JSON-Ausgabe, aber dein Code sollte ihn weiterhin parsen und Feldnamen sowie Typen validieren, bevor er sie verwendet.

Sampling-Einstellungen wie temperature, top_p, stop, seed und die Strafen werden durchgereicht, sodass bestehende Optimierungen übernommen werden.

429-Fehler behandeln und Header lesen

Das SDK löst bei HTTP 429 eine Ratenlimit-Ausnahme aus, und der Antworttext sagt dir, welches Limit du getroffen hast. Ein vollständiger Schlüssel erlaubt 8 parallele Anfragen und 300 Anfragen pro Minute. Ein Test-Schlüssel erlaubt 2 parallele Anfragen und 60 pro Minute.

FehlercodeBedeutungWas tun
rate_limitedZu viele Anfragen pro MinuteVerteile die Aufrufe oder füge einen Client-seitigen Rate-Limiter hinzu
concurrencyZu viele Anfragen gleichzeitigBegrenze deinen Worker-Pool auf 8 (2 bei einem Test-Schlüssel)
429 mit Retry-After: 5Vorübergehende ÜberlastungWarte 5 Sekunden und versuche es erneut

Jede Antwort enthält X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests und X-RateLimit-Limit-Concurrency. Um sie mit dem Python-SDK zu lesen, verwende den Raw-Response-Wrapper:

import os
from openai import OpenAI

client = OpenAI(base_url="https://api.uncensoredqwen.com/v1",
                api_key=os.environ["API_KEY"])

raw = client.chat.completions.with_raw_response.create(
    model="uncensored",
    messages=[{"role": "user", "content": "ping"}],
    max_tokens=5,
)
print("Balance:", raw.headers.get("X-Balance-USD"))
print("Request id:", raw.headers.get("X-Request-Id"))
completion = raw.parse()

Fehlgeschlagene oder abgelehnte Anfragen werden nicht berechnet, daher kostet dich ein Retry nach einem 429 nicht doppelt. Der bestehende Artikel über häufige Qwen-API-Fehler behandelt weitere Konfigurationsfehler, auf die Nutzer stoßen.

Was ein Aufruf kostet

Die Preise liegen bei $0,15 pro 1M Input-Token und $0,50 pro 1M Output-Token, bezahlt aus Prepaid-Guthaben. Nimm eine Anfrage mit 2.000 Prompt-Token und 500 Completion-Token:

  • Input: 2.000 x $0,15 / 1.000.000 = $0,0003
  • Output: 500 x $0,50 / 1.000.000 = $0,00025
  • Gesamt: $0,00055

Das Testguthaben von $0,50 deckt etwa 900 Anfragen dieser Größe ab ($0,50 / $0,00055 sind etwa 909). Das Testguthaben ist nach der Anmeldung ein Klick auf der Schlüssel-Seite, benötigt keine Karte und dauert 7 Tage; der Artikel zur kostenlosen Stufe erklärt, wie es funktioniert. Bezahlte Aufladungen beginnen bei $20, und die Preisseite listet die Bonusstufen und akzeptierten Zahlungsmethoden auf.

Der Kontext umfasst 100.000 Token für Prompt und Completion zusammen, und max_tokens ist optional. Es ist dennoch eine gute Praxis, es zu setzen, wenn du eine vorhersagbare Obergrenze für die Kosten möchtest.

Ein bestehendes Projekt umziehen

Die meisten Leser kommen mit Code, der bereits ein Chat-Modell aufruft. Eine kurze Checkliste hält den Wechsel ereignislos:

  1. Ändere base_url (oder baseURL in Node) zu https://api.uncensoredqwen.com/v1. Behalte das /v1-Suffix bei und füge /chat/completions nicht manuell hinzu, da das SDK den Pfad anhängt.
  2. Ersetze den Schlüssel durch den aus deinem Konto. Die Authentifizierung erfolgt über einen Standard-Authorization: Bearer-Header, den das SDK für dich erstellt.
  3. Ersetze den Modellnamen durch uncensored. Anfragen mit einem unbekannten Modellnamen schlagen fehl, also durchsuche deine Codebasis nach fest codierten Namen.
  4. Entferne alle Anfragefelder für Funktionen, die der Dienst nicht anbietet, wie Bild-Eingaben oder Embedding-Aufrufe.
  5. Führe einen Aufruf zu GET /v1/models als Rauchtest durch. Wenn das Modell aufgelistet wird, sind deine URL und dein Schlüssel korrekt.

Frameworks, die den OpenAI-Client umhüllen, bieten meist dieselben zwei Einstellungen unter Namen wie openai_api_base oder OPENAI_BASE_URL. Wenn dein Tool eine Umgebungsvariable für die Basis-URL anbietet, kannst du eine gesamte Anwendung umschalten, ohne den Quellcode zu berühren. Teste zuerst mit einem Test-Schlüssel, da die niedrigeren Limits von 2 parallelen Anfragen und 60 pro Minute schnell zeigen, ob deine App mehr parallele Verbindungen öffnet als geplant.

Die Kontextbehandlung verdient ebenfalls einen zweiten Blick. Das Fenster umfasst hier 100.000 Token, die sich Prompt und Completion teilen. Wenn dein altes Setup die Historie auf eine andere Größe beschnitten hat, kannst du das Beschneiden lockern oder verschärfen, um es anzupassen, behalte aber die Kosten im Auge, die durch das erneute Senden einer langen Historie bei jedem Schritt entstehen.

Praktische Tipps für Produktionscode

  • Behalte den Schlüssel außerhalb des Repositories. Lies ihn aus einer Umgebungsvariable oder einem Secret-Store, wie in den obigen Beispielen.
  • Setze einen Timeout. Das SDK akzeptiert ein timeout-Argument auf dem Client. Lange Generierungen mit Streaming benötigen einen großzügigen Read-Timeout.
  • Begrenze deine Worker. Ein Thread-Pool oder Semaphor, das auf dein Concurrency-Limit abgestimmt ist, vermeidet die meisten 429-Fehler, bevor sie auftreten.
  • Protokolliere die Request-ID. Wenn du den Support kontaktierst, identifiziert der Wert aus X-Request-Id den Aufruf.
  • Behalte das Guthaben im Auge. Lies X-Balance-USD aus Antworten aus oder rufe GET /v1/balance auf, damit ein Batch-Job stoppt, bevor das Guthaben aufgebraucht ist.

Das Modell ist nur Text. Es gibt keine Bild-, Audio- oder Video-Generierung, keine Embeddings und kein Fine-Tuning, plane also nicht um diese SDK-Methoden herum. Vollständige Parameterdetails findest du in der Dokumentation. Prompts werden nicht zum Training verwendet.

Fragen und Antworten

Gibt es ein offizielles Qwen-API-SDK für diesen Dienst?

Kein separates SDK erforderlich. Nutze das offizielle OpenAI Python- oder Node.js-Paket und setze base_url auf https://api.uncensoredqwen.com/v1 mit Modell uncensored.

Welche SDK-Sprachen werden unterstützt?

Jeder OpenAI-kompatible Client funktioniert, einschließlich der offiziellen Python- und Node.js-Pakete, reinem curl und Community-Bibliotheken, die das Überschreiben der Basis-URL erlauben.

Wie prüfe ich mein Guthaben im Code?

Lese den X-Balance-USD-Header in jeder Antwort aus oder rufe GET /v1/balance auf. Der OpenAI-kompatible credit_grants-Endpunkt ist ebenfalls verfügbar.

Unterstützt das SDK Streaming und Tools?

Ja. Setze stream auf true für Server-Sent Events mit der Nutzung am Ende, und verwende tools und tool_choice, wie du es von OpenAI kennst.

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