Qwen-API: Erste Anfrage in fünf Minuten

Basis-URL und Authentifizierung

Unsere API folgt dem Standardformat von OpenAI, sodass du deine bestehende Client-Konfiguration problemlos wechseln kannst. Die Basis-URL für alle Anfragen ist https://api.qwenapis.com/v1. Du benötigst einen API-Schlüssel, um deine Anfragen zu authentifizieren. Falls du noch keinen erstellt hast, besuche die Seite API-Schlüssel erhalten, um einen Schlüssel nur mit deiner E-Mail-Adresse und deinem Passwort zu generieren. Für den Start mit dem Testguthaben wird keine Kreditkarte benötigt.

Jedes Konto ist auf einen aktiven Schlüssel beschränkt. Du kannst deinen Schlüssel jederzeit neu generieren, wodurch der vorherige sofort ungültig wird. So kannst du dein Konto sofort sichern, falls der Schlüssel bekannt wird, ohne auf einen Monatszyklus zu warten. Bewahre den Schlüssel sicher in deinen Umgebungsvariablen oder im Secret Manager auf.

Erste Anfrage senden

Überprüfe deine Einrichtung, indem du eine einfache Text-Vervollständigungsanfrage sendest. Das folgende Beispiel nutzt curl, um einen Prompt an das unzensierte Modell zu senden. Ersetze YOUR_API_KEY durch den im vorherigen Schritt generierten Schlüssel. Die Modell-ID ist auf uncensored gesetzt, das darauf ausgelegt ist, ohne Inhaltsfilter auf rechtliche erwachsene Nutzung zu antworten.

Copycurl https://api.qwenapis.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Bei Erfolg erhältst du eine JSON-Antwort mit dem generierten Text. Bei einem 401-Fehler prüfe, ob dein Schlüssel korrekt ist. Ein 402-Fehler bedeutet, dass dein Prepaid-Guthaben aufgebraucht ist.

Python-SDK-Integration

Für Python-Entwickler funktioniert das offizielle OpenAI SDK direkt mit unserem Endpunkt. Installiere die Bibliothek mit pip und konfiguriere den Client, um auf unsere Basis-URL zu zeigen. So kannst du bekannte Methoden wie chat.completions.create() nutzen, ohne deine Anwendungslogik wesentlich zu ändern. Das SDK übernimmt die JSON-Serialisierung und Retry-Logik für dich.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.qwenapis.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Vergiss nicht, api_key und base_url korrekt zu setzen. Der Modellname bleibt uncensored. Dieser Ansatz gewährleistet Kompatibilität mit Code für andere Anbieter, was das Wechseln oder Testen verschiedener Endpunkte einfach macht.

Node-SDK-Nutzung

Node.js-Entwickler können das @anthropic-ai/sdk oder das offizielle openai npm-Paket nutzen. Konfiguriere den Client mit unserer Basis-URL und deinem API-Schlüssel. Die Struktur der Anfrage ist identisch mit anderen OpenAI-kompatiblen Diensten. Dies ermöglicht es dir, unzensiertes Qwen in deine bestehenden Node.js-Anwendungen mit minimalen Codeänderungen zu integrieren.

Copyimport OpenAI from "openai";

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

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Stelle sicher, dass du die asynchrone Antwort angemessen behandelst. Das SDK gibt das vollständige Vervollständigungsobjekt zurück, einschließlich Token-Nutzungsstatistiken. So kannst du den Verbrauch deines Prepaid-Guthabens in Echtzeit überwachen.

Streaming aktivieren

Für geringere Latenz und bessere Benutzererfahrung aktiviere Streaming in deinen Anfragen. Streaming sendet die Antwort Token für Token, während sie generiert wird, sodass deine Anwendung die Ausgabe schrittweise anzeigen kann. Setze den Parameter stream auf true in deiner Anfrage. Das SDK stellt einen iterierbaren Stream von Chunks bereit.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Dies ist besonders nützlich für die Generierung langer Texte oder interaktive Anwendungen. Jeder Chunk enthält teilweise Text, den Sie an Ihren Anzeige-Puffer anhängen können. Der Stream endet, wenn das Modell die Antwort abschließt oder das Kontextlimit erreicht.

Limits, Fehler und Kontext

Unsere API hat spezifische Limits, um eine faire Nutzung zu gewährleisten. Du darfst 300 Anfragen pro Minute pro Schlüssel senden. Die maximale Größe des Anfragekörpers beträgt 8 MB. Das Kontextfenster umfasst 100.000 Token, sowohl den Prompt als auch die Vervollständigung. Wenn du das Ratenlimit überschreitest, erhältst du einen 429-Fehler. Wenn dein Guthaben nicht ausreicht, erhältst du einen 402-Fehler. Für ungültige Schlüssel erhältst du einen 401-Fehler. Diese Fehler helfen dir, den Ablauf deiner Anwendung und die Guthaben-Nutzung effektiv zu verwalten.