SillyTavern mit QCode verbinden

In SillyTavern mit den Claude-/GPT-Modellen von QCode.cc chatten; ein ehrlicher Hinweis dazu, ob sich die Bildgenerierung mit gpt-image-2 anbinden lässt, sowie Alternativen

Zuletzt überprüft: 2026-09-18 · 📄 Laut offizieller Dokumentation (SillyTavern 1.19.0 (veröffentlicht am 2026-09-14))

Auf einen Blick¶

SillyTavern ist ein beliebtes lokales LLM-Frontend, das auf Rollenspiel und mehrstufige Dialoge ausgerichtet ist. Es unterstützt die Anbindung verschiedenster Chat-Modelle und enthält Erweiterungen für Bildgenerierung, TTS und mehr. Dieses Tutorial zeigt, wie Sie die Modelle von QCode.cc in SillyTavern nutzen.

Vorab: Das Wichtigste¶

1. Mit QCodes Claude-Modellen chatten¶

Die Claude-Integration von SillyTavern enthält einen einklappbaren Abschnitt „Reverse Proxy“ – über diesen richten Sie die Verbindung auf QCode aus:

1. Öffnen Sie API Connections (das Stecker-Symbol) → Chat Completion.
2. Stellen Sie Chat Completion Source auf Claude.
3. Klappen Sie darunter den Bereich Reverse Proxy auf. Das ist keine Checkbox und kein Toggle – eine leere Proxy-URL bedeutet schlicht „SillyTaverns eingebaute offizielle Adresse verwenden“.

4. Tragen Sie zwei Felder ein:

5. Proxy Server URL: https://api.qcode.cc/api/v1 (in Festlandchina bevorzugen Sie https://asia.qcode.cc/api/v1)

6. Proxy Password: Ihr QCode-API-Key (beginnt mit cr_)
7. Wählen Sie claude-opus-5, claude-sonnet-5, claude-haiku-4-5 usw. im Dropdown Claude Model (4.x-Modelle wie claude-sonnet-4-6 sind weiterhin erhältlich).
8. Klicken Sie auf Connect. Da eine Proxy-URL gesetzt ist, erscheint beim ersten Klick ein Bestätigungsdialog „Mit dieser Proxy-URL verbinden?“ – das ist zu erwarten.

🔴 Die Proxy-URL muss /v1 enthalten: Tragen Sie https://api.qcode.cc/api/v1 ein und enden Sie dort. SillyTavern fügt danach nur /messages an und setzt Ihnen kein /v1 hinzu – https://api.qcode.cc/api würde /api/messages treffen und 404 zurückgeben. Auch kein abschließender Slash (ergäbe //messages). Quelle: SillyTavern 1.19.0 src/endpoints/backends/chat-completions.js, der Claude-Zweig führt fetch(apiUrl + '/messages') aus.

Zwei Dinge vorab:

• Das Dropdown „Claude Model“ ist eine feste Liste; Sie können keine Modell-ID eingeben. Die 1.19.0-Liste enthält bereits claude-opus-5, claude-sonnet-5, claude-haiku-4-5 und claude-sonnet-4-6, was sich mit den Claude-Modellen überschneidet, die wir anbieten. Wenn wir später ein Claude-Modell aufnehmen, das in SillyTaverns Liste fehlt, können Sie es hier nicht auswählen – warten Sie auf ein SillyTavern-Update, oder nutzen Sie stattdessen Claude Code.
• Was die offizielle Dokumentation über Proxies sagt: Die Nutzung eines Proxys, den Sie nicht selbst betreiben, stellt ein Datenschutzrisiko dar, und SillyTavern lehnt Support-Anfragen von Proxy-Nutzern ab. Hier verweist die URL auf Ihr eigenes QCode-Konto und Ihren eigenen Key – bedenken Sie das.

2. Mit QCode GPT-Modellen chatten¶

Verwenden Sie den OpenAI-kompatiblen Endpunkt:

1. API Connections → Chat Completion.
2. Setzen Sie Chat Completion Source auf Custom (OpenAI-compatible).

3. Tragen Sie Folgendes ein:

4. Custom Endpoint (Base URL): https://api.qcode.cc/openai/v1 (in Festlandchina bevorzugen Sie https://asia.qcode.cc/openai/v1)

5. API Key: Ihr QCode API-Key
6. Geben Sie gpt-6-sol, gpt-6-luna, gpt-5.6-terra usw. unter Enter a Model ID ein.
7. Klicken Sie auf Connect.

Hier gilt dieselbe Regel: Nur /openai/v1 eintragen und nicht selbst /chat/completions ergänzen (SillyTavern fügt es hinzu). Ein API-Key funktioniert für alle Protokolle; der Pfad entscheidet, welches. Siehe Endpunkte und API-Formate.

3. Zur gpt-image-2-Generierung (ein ehrlicher Hinweis)¶

Viele Nutzer fragen: Kann ich QCode gpt-image-2 in SillyTavern für Charakterporträts / Illustrationen anbinden?

Aktuell nicht. Warum:

• Die Bildgenerierungs-Erweiterung von SillyTavern (ehemals Stable-Diffusion-Erweiterung) unterstützt nur eine feste Backend-Auswahl: 24 Einträge im Dropdown der Version 1.19.0, wörtlich einschließlich ComfyUI, Stable Diffusion Web UI (AUTOMATIC1111), SD.Next (vladmandic), stable-diffusion.cpp server, DrawThings HTTP API, NovelAI Diffusion, Stability AI, OpenAI, OpenRouter, TogetherAI, Pollinations, Z.AI. Nur die Backends, die Sie lokal auf Ihrem eigenen Rechner betreiben (SD Web UI / SD.Next / ComfyUI / stable-diffusion.cpp / DrawThings), besitzen ein URL-Feld.
• Es gibt keine Option „Custom OpenAI-compatible image endpoint“ – das heißt, Sie können der Bildgenerierung, anders als beim Chat, keinen eigenen base_url geben, der auf QCode /v1/images/generations zeigt.
• Es existiert bereits ein Community-Feature-Request #4851 (offizieller Titel wörtlich: [FEATURE_REQUEST] Custom openai compatible image generation enpoint (image generation extension) – die Schreibfehler stammen vom Autor), dieser ist noch OPEN und nicht umgesetzt Stand 2026-09-18.

Bitte genau beachten: Die eingebaute OpenAI-Bildquelle listet gpt-image-2 zwar im Modell-Dropdown, sodass es so aussieht, als würde es funktionieren. Aber das Request-Ziel ist im Quellcode hart auf api.openai.com/v1/images/generations verdrahtet, ohne Feld für eine Base URL – es kann daher QCode weiterhin nicht erreichen.

Alternativen¶

Wenn Sie QCode gpt-image-2 nutzen möchten, können Sie:

• Das offizielle OpenAI SDK / jedes Tool, das einen eigenen images-Endpunkt unterstützt, verwenden, um es direkt aufzurufen: Base https://api.qcode.cc/qcode-img/v1, Modell gpt-image-2, derselbe QCode-Key. Siehe gpt-image-2 Bildgenerierung.
• Den Fortschritt des SillyTavern-Issues #4851 verfolgen; sobald ein Custom OpenAI-kompatibler Bildendpunkt unterstützt wird, können Sie den QCode-Bildendpunkt so eintragen wie auf dieser Seite für den „Chat“-Bereich.

FAQ¶

Q: Die Verbindung liefert 401 / 403? A: Prüfen Sie, ob der API-Key korrekt und nicht abgelaufen ist. Claude verwendet das Feld „Proxy Password“, OpenAI-kompatible Endpunkte das Feld „API Key“ – tragen Sie den Key nicht am falschen Ort ein.

Q: Instabile Netzwerkverbindung in Festlandchina? A: Wechseln Sie die BASE_URL-Domain auf asia.qcode.cc (Asien-Knoten, in der Nähe von Korea / Taiwan / Hong Kong); falls dies ebenfalls instabil ist, wechseln Sie zurück auf api.qcode.cc (globales Routing).

Q: Kann ich meine Request-Verläufe einsehen? A: Ja. Requests über alle Domains werden an probe.qcode.cc gemeldet; geben Sie Ihren API-Key ein, um sie anzuzeigen.

Möchten Sie einen Plan, der Claude Code, Codex und Drittanbieter-Clients wie diesen auf einmal abdeckt? Schauen Sie sich die QCode.cc Preise an – ein API-Key funktioniert über alle drei Protokolle.