Was bedeutet „Proxy“ in SillyTavern?
In der KI-Rollenspiel-Community ist mit einem Proxy schlicht eine API-Endpoint-URL gemeint, die zwischen deinem Chat-Frontend (wie SillyTavern oder JanitorAI) und einem KI-Modellanbieter wie Anthropic, Google oder DeepSeek sitzt. Sobald du auf Senden drückst, schickt dein Frontend den fertigen Prompt an diese URL, der Dienst leitet die Anfrage an das Modell weiter und die Antwort fließt zurück auf deinen Bildschirm.
Dass Spieler fast jede Drittanbieter-API-URL als „Proxy“ bezeichnen, liegt direkt an der Beschriftung in den Apps. In SillyTavern stehen Drittanbieter-URLs bei den nativen Einstellungen für Claude und Google AI Studio unter der Überschrift Reverse Proxy, und JanitorAI bündelt die Felder für eigene API-Zugänge unter einem Reiter namens Proxy.
Gleichzeitig wirst du in Foren oder auf Discord-Servern schon nach fünf Minuten lesen, wie erfahrene Spieler Einsteigern dringend von Proxys abraten. Diese Skepsis hat gute Gründe. In Rollenspiel-Kreisen steht das Wort „Proxy“ oft für kostenlose Community-Links, die auf anonymen Paste-Seiten herumgereicht werden – also Endpoints, die mit geleakten oder gestohlenen API-Keys laufen, heimlich private Chats mitprotokollieren, teure Modelle im Hintergrund gegen billige austauschen und von heute auf morgen verschwinden.
Um hier den Überblick zu behalten, muss man die Bezeichnung in der Benutzeroberfläche von der Arbeitsweise des Dienstes dahinter trennen:
- Ein kostenloser Proxy (oder Shared-Key-Proxy) gibt dir eine einzelne öffentliche URL (oder ein Gruppenpasswort aus dem Chat) ohne transparente Abrechnung oder greifbaren Betreiber – meist finanziert über missbrauchte Testkonten oder kompromittierte Keys.
- Ein bezahlter API-Proxy (oder API-Gateway) funktioniert wie ein normaler Cloud-API-Dienst: Du meldest dich in deinem eigenen Konto an, erstellst einen privaten API-Key und zahlst pro Token für den Zugriff auf klar benannte Upstream-Modelle.
Im weiteren Verlauf dieser Anleitung nutzen wir das Wort Proxy immer dort, wo deine App selbst diesen Begriff auf dem Bildschirm verwendet (Reverse Proxy, Proxy URL), und sprechen von einer API, wenn es um den Dienst geht, den du anbindest.
Welchen Proxy brauchst du überhaupt?
Bevor du irgendwelche Konfigurationsdateien anfasst, solltest du kurz prüfen, ob die Anleitung oder der Forenbeitrag vor dir überhaupt von derselben Art Proxy spricht. In der SillyTavern-Dokumentation und in Community-Threads wird das Wort „Proxy“ nämlich für vier völlig unterschiedliche Werkzeuge verwendet:
| Wie es genannt wird | Wo es dir begegnet | Was es tatsächlich tut | Brauchst du es zum Chatten mit KI-Modellen? |
|---|---|---|---|
| 1. Modell-API-Proxy (Custom Endpoint / Reverse Proxy) | SillyTavern im Menü API Connections; JanitorAI unter API Settings → Proxy | Leitet deinen Rollenspiel-Prompt per HTTPS und API-Key an einen KI-Modellanbieter (Claude, Gemini, DeepSeek) weiter. | Ja — außer du nutzt direkt einen API-Key des Modellherstellers oder lässt ein lokales Modell auf deiner eigenen Grafikkarte laufen. |
2. Ausgehender Netzwerk-Proxy (config.yaml) | In der Datei config.yaml im Hauptordner von SillyTavern (HTTP- / SOCKS-Proxy-Einstellungen) | Leitet den ausgehenden Internetverkehr von SillyTavern durch einen Netzwerktunnel oder einen VPN-ähnlichen Client auf deinem Gerät. | Nein — außer deine lokale Internetverbindung blockiert ausgehende Verbindungen und setzt zwingend einen System-Netzwerkproxy voraus. |
3. Selbst gehosteter Web-Reverse-Proxy (nginx, Caddy) | Anleitungen für Linux-VPS und Fernzugriff | Sitzt vor deinem eigenen SillyTavern-Server (localhost:8000), um HTTPS-Verschlüsselung und eine eigene Domain bereitzustellen, wenn du SillyTavern von unterwegs öffnest. | Nein — nur nötig, wenn du deinen SillyTavern-Server direkt ins Internet stellst (die meisten Spieler nutzen stattdessen Tailscale; siehe unsere Installationsanleitung). |
4. Veraltete lokale Middleware (simple-proxy-for-tavern) | Alte Einrichtungs-Tutorials aus den Jahren 2023–2024 | Ein separates lokales Skript auf dem PC, das früher API-Formate übersetzt hat, bevor SillyTavern diese direkt unterstützt hat. | Nein — in aktuellem SillyTavern überflüssig, da OpenAI-kompatible APIs sowie Claude und Gemini heute direkt angebunden werden. |
Tipp: Wenn du gerade erst SillyTavern installiert oder JanitorAI geöffnet hast und Claude, Gemini oder DeepSeek fürs Rollenspiel verbinden willst, brauchst du ausschließlich Nr. 1 (einen Modell-API-Endpoint). Lass die Netzwerk-Proxy-Einstellungen in der config.yaml von SillyTavern einfach unberührt und ignoriere alte Guides, die dir nginx oder lokale Proxy-Skripte empfehlen.
Wo wird die Proxy-URL eingetragen?
Jede Rollenspiel-App fragt nach denselben drei Dingen – einer Endpoint-URL, einem API-Key und einer Modell-ID –, aber je nach App wird ein anderer Teil des URL-Pfads erwartet. Hier siehst du genau, wo diese Felder in den jeweiligen Clients liegen, am Beispiel von TavernAPI und unseren fünf Modell-IDs (claude-opus-5-5, claude-sonnet-5-5, gemini-4-argon, gemini-3.8-flash und deepseek-v4-pro).
SillyTavern: Chat Completion → Custom (OpenAI-compatible)
Die Verbindung über Custom (OpenAI-compatible) ist in SillyTavern der sauberste Weg, weil du mit einem einzigen Endpoint und einem Key im selben Dropdown-Menü bequem zwischen Claude, Gemini und DeepSeek wechseln kannst:
- Klicke oben in der Leiste auf das Symbol API Connections (den Stromstecker).
- Stelle API auf
Chat Completion. - Stelle Chat Completion Source auf
Custom (OpenAI-compatible). - Fülle die Verbindungsfelder aus:
- Custom Endpoint (Base URL):
https://tavernapi.com/v1 - Custom API Key: Dein
sk-tav-...-Schlüssel (erstellt in der Nutzerkonsole; kopiere ihn sofort, da er nur einmal angezeigt wird).
- Custom Endpoint (Base URL):
- Klicke auf Connect, öffne das Dropdown-Menü Available Models und wähle
gemini-4-argon,claude-opus-5-5,gemini-3.8-flash,deepseek-v4-prooderclaude-sonnet-5-5.
Häng bei Custom Endpoint (Base URL) am Ende kein /chat/completions an – SillyTavern ergänzt diesen Pfad beim Senden einer Nachricht automatisch.
SillyTavern: Reverse-Proxy-Felder für Claude und Google AI Studio
Wenn du ein lokales Preset nutzt, das speziell für die native Claude- oder Google AI Studio-Quelle in SillyTavern gebaut wurde – oder wenn du quellenspezifische Regler für Claude oder Gemini verwenden möchtest –, kannst du statt Custom (OpenAI-compatible) auch den Bereich Reverse Proxy in SillyTavern nutzen.
- Öffne API Connections (das Stecker-Symbol) und lass API auf
Chat Completionstehen. - Stelle Chat Completion Source entweder auf
Claudeoder aufGoogle AI Studio. - Klicke auf Reverse Proxy, um die Proxy-Felder auszuklappen, und trage die passende URL ein:
- Für die Quelle Claude setzt du Proxy Server URL auf
https://tavernapi.com/v1 - Für die Quelle Google AI Studio setzt du Proxy Server URL auf
https://tavernapi.com(ohne/v1am Ende, da SillyTavern den versionsspezifischen Google-Pfad selbst anhängt)
- Für die Quelle Claude setzt du Proxy Server URL auf
- Füge im Feld Proxy Password deinen
sk-tav-...API-Key ein. (SillyTavern nennt das Feld Passwort, dort kommt aber dein API-Key hinein.) - Klicke auf Connect und wähle
claude-opus-5-5oderclaude-sonnet-5-5unter Claude bzw.gemini-4-argonodergemini-3.8-flashunter Google AI Studio.
Eine vollständige Schritt-für-Schritt-Erklärung zu beiden Verbindungswegen und zum Importieren von Presets findest du in unserer Anleitung zur SillyTavern-Einrichtung. Falls beim Senden einer Nachricht einmal ein 402-Fehler auftaucht, lies nach, wie du den Fehler 402 Insufficient Balance behebst.
JanitorAI: API Settings → Proxy
JanitorAI ist eine gehostete Charakter-Plattform mit eigenem integriertem Sprachmodell, erlaubt es dir aber auch, Chats über eine externe OpenAI-kompatible API laufen zu lassen:
- Öffne auf JanitorAI einen beliebigen Charakter-Chat, klicke oben auf API Settings und wähle den Reiter Proxy.
- Fülle die drei Pflichtfelder aus:
- Proxy URL:
https://tavernapi.com/v1/chat/completions - API Key: Dein
sk-tav-...-Schlüssel - Model: Tippe exakt die gewünschte Modell-ID ein, also zum Beispiel
gemini-4-argon,claude-opus-5-5,gemini-3.8-flash,deepseek-v4-prooderclaude-sonnet-5-5.
- Proxy URL:
- Speichere deine Einstellungen und starte den Chat.
Hinweis: Der häufigste Stolperstein beim Wechsel zwischen SillyTavern und JanitorAI ist das Ende der URL. Die Custom-Quelle in SillyTavern erwartet nur die Basis-URL (https://tavernapi.com/v1), während das Feld Proxy URL in JanitorAI den kompletten Pfad inklusive Chat-Completions verlangt (https://tavernapi.com/v1/chat/completions).
RisuAI, Agnaistic und andere OpenAI-kompatible Apps
Auch andere Rollenspiel-Frontends wie RisuAI und Agnaistic (Agnai) akzeptieren jeden beliebigen OpenAI-kompatiblen Endpoint (in unserem Vergleich der besten KI-Rollenspiel-Tools zeigen wir im Detail, wie die einzelnen Apps funktionieren).
Welches URL-Format ein Client erwartet, erkennst du meist sofort am ausgegrauten Beispieltext im URL-Eingabefeld:
- Endet der Platzhalter auf
/v1, trägst duhttps://tavernapi.com/v1ein. - Endet der Platzhalter auf
/v1/chat/completions, trägst duhttps://tavernapi.com/v1/chat/completionsein.
Anschließend fügst du deinen sk-tav-... API-Key ein und gibst eine der fünf Modell-IDs an (gemini-4-argon, claude-opus-5-5, gemini-3.8-flash, deepseek-v4-pro oder claude-sonnet-5-5).
Warum sind kostenlose Proxys riskant?
Große Sprachmodelle wie Claude und Gemini kosten bei jeder einzelnen Antwort echtes Geld – erst recht beim Rollenspiel, wo deine App mit jeder Nachricht tausende Tokens an Charakterbeschreibungen und bisherigem Chatverlauf neu mitschickt. Sowohl die offizielle Dokumentation von SillyTavern als auch die Dokumentation von Chub warnen Spieler ausdrücklich vor den Risiken nicht vertrauenswürdiger Drittanbieter-Proxys.
Wenn jemand einen kostenlosen oder verdächtig billigen Proxy-Link ohne erkennbares Geschäftsmodell verteilt, gehst du vier konkrete Risiken ein:
- Geleakte oder gestohlene Keys werden ohne Vorwarnung gesperrt: Kostenlose Proxys bezahlen ihre Upstream-Rechenleistung fast nie selbst. In der Praxis stammen ihre Key-Pools oft aus durchsuchten öffentlichen Code-Repositories, wurden mit gestohlenen Zahlungsdaten eröffnet oder rotieren über missbrauchte Cloud-Testkonten. Sobald der Upstream-Anbieter den unbefugten Datenverkehr bemerkt, werden die Keys widerrufen und dein Proxy stirbt mitten in der Szene.
- Der Betreiber kann deine privaten Chats speichern und mitlesen: Jede Nachricht, die du über einen Proxy schickst, läuft im Klartext über den Server des Betreibers, damit er sie an das Modell weiterleiten kann. Ein anonymer Betreiber ohne Datenschutzerklärung kann deine Prompts, Charakterkarten, Personas und deine IP-Adresse mitschneiden – und du hast keine Ahnung, wo diese Logs am Ende landen.
- Hinter dem Endpoint steckt oft nicht das beworbene Modell: Da der Proxy-Server die ausgehende Anfrage kontrolliert, kann ein unehrlicher Betreiber eine Anfrage für ein großes Claude- oder Gemini-Flaggschiff entgegennehmen und sie im Hintergrund stillschweigend an ein viel billigeres, kleineres Modell weiterleiten. Wenn ein angebliches Spitzenmodell plötzlich einfachste Szenenlogik vergisst oder flache, repetitive Sätze schreibt, tauscht der Endpoint möglicherweise im Hintergrund die Modelle aus.
- Kein Support, keine Verantwortlichkeit und kein Geld zurück: Informelle Proxys und Discord-Server auf „Spendenbasis“ können über Nacht verschwinden, sobald ihr Nachschub an Keys versiegt. Es gibt keine veröffentlichten Nutzungsbedingungen, keinen verlässlichen Support und keine Möglichkeit, dein Geld zurückzubekommen, falls du für einen geteilten Zugang bezahlt hast.
Wie prüfst du einen Proxy vor dem Bezahlen?
Du musst kein Netzwerktechniker sein, um einen seriösen API-Dienst von einem dubiosen Angebot zu unterscheiden. Geh vor dem Aufladen einfach diese Sieben-Punkte-Checkliste durch:
- Die Upstream-Anbieter werden pro Modell klar benannt: Ein vertrauenswürdiger Dienst gibt offen an, über welchen offiziellen Cloud- oder API-Kanal jedes Modell läuft (etwa AWS, Google Cloud, Google AI Studio oder die offizielle DeepSeek-API), statt sich hinter vagen Aussagen wie „private Routen“ zu verstecken.
- Du zahlst für deinen eigenen Verbrauch zu öffentlichen, datierten Preisen: Achte auf eine öffentlich einsehbare Preistabelle mit sichtbarem Aktualisierungsdatum, bei der über deinen persönlichen API-Key genau pro Token (oder über klar erklärte Guthabenpakete) abgerechnet wird.
- Eine veröffentlichte Datenschutzerklärung regelt klar, was gespeichert wird und was nicht: Prüfe, ob es eine echte Datenschutzerklärung gibt, die ausdrücklich zwischen Abrechnungs-Metadaten (Token-Zähler, Modellname, Zeitstempel und Kosten) und deinen privaten Prompt-Texten sowie Charakterkarten unterscheidet.
- Es gibt einen erreichbaren Betreiber und veröffentlichte Bedingungen: Vergewissere dich, dass die Seite Nutzungsbedingungen veröffentlicht und dir mehr als nur einen funktionierenden Kontaktweg bietet – etwa E-Mail, Telegram oder Discord –, um bei Fragen zu einer Aufladung einen echten Menschen zu erreichen.
- Das gelieferte Modell entspricht dem gewählten Modell: Teste den Endpoint mit einer Charakterkarte oder einer kniffligen Szene mit mehreren Figuren, die du bereits gut kennst, um sicherzugehen, dass Schreibstil, logisches Mitdenken und Antwortgeschwindigkeit zum echten Modell passen.
- Der Preis ist plausibel, kein „kostenloses unbegrenztes Claude“: Mengenrabatte für Großkunden und serverseitiges Prompt-Caching können die Token-Kosten auf seriöse Weise senken – wer dir dagegen zum Pauschalpreis „unbegrenzt kostenloses Claude“ verspricht, spart an Stellen, die du nicht in der Nähe deines Kontos haben willst.
- Du kannst mit einem kleinen Betrag starten und das Nutzungsprotokoll prüfen: Lade bei einem unbekannten Dienst am ersten Tag niemals direkt eine große Summe auf; starte mit einem kostenlosen Testguthaben oder dem kleinsten Aufladebetrag, schicke ein paar Testantworten und prüfe, ob das Nutzungsprotokoll in der Konsole mit den veröffentlichten Token-Preisen übereinstimmt.
Wo steht TavernAPI dabei?
Damit dieser Ratgeber fair bleibt, legen wir genau dieselbe Sieben-Punkte-Checkliste auch an TavernAPI an – inklusive der ehrlichen Einschränkungen unseres Dienstes:
- Klar benannte offizielle Upstreams: Wir bieten fünf 1M-Kontext-Modelle an, die gezielt fürs Rollenspiel ausgewählt wurden (lies unseren ausführlichen Praxistest der Modelle).
claude-opus-5-5undclaude-sonnet-5-5laufen über AWS und Google Cloud,gemini-4-argonundgemini-3.8-flashüber Google AI Studio unddeepseek-v4-proüber die offizielle DeepSeek-API. - Datierte Preise pro Token in USD: Alle Tarife für Input, Output und Cache sind in USD pro Million Tokens auf unserer Preisseite veröffentlicht. Zusätzlich aktivieren wir bei jeder Verbindung automatisch serverseitiges Prompt-Caching, um die Input-Kosten in langen Chats zu senken, und zeigen dir deine genaue Dollar-Ersparnis in der Nutzerkonsole.
- Keine Speicherung von Chat-Inhalten: Wie in unserer Datenschutzerklärung festgehalten, speichert TavernAPI weder deine Nachrichteninhalte noch Charakterkarten, Lorebooks oder KI-Antworten. Für die Abrechnung protokollieren wir lediglich Token-Zähler, Anfragezeitpunkt, Modell-ID und Kosten.
- Erreichbarer Betreiber und klare Bedingungen: Wir veröffentlichen vollständige Nutzungsbedingungen und bieten auf unserer Kontaktseite direkten Support per Telegram, Discord oder E-Mail.
- Erst testen, dann zahlen: Neue Konten erhalten ein kostenloses Startguthaben von $0.30 für
gemini-4-argonundgemini-3.8-flash, damit du die Modellqualität testen und die Token-Protokolle jeder einzelnen Anfrage in der Konsole prüfen kannst, bevor du einen Cent ausgibst. Für SillyTavern-Spieler stellen wir außerdem optionale Storytelling-Presets bereit, die lokale Schalter mit serverseitig entfalteten Kern-Anweisungen kombinieren.
Unsere ehrlichen Grenzen: Sobald dein Startguthaben von $0.30 aufgebraucht ist, ist TavernAPI nicht kostenlos. Da jede Anfrage über offizielle Upstream-Anbieter läuft, gelten weiterhin die Sicherheitsfilter der jeweiligen Anbieter (wir sperren dein Konto aber niemals, nur weil ein Upstream-Modell einen Prompt abgelehnt hat). Und schließlich führen wir bewusst nur die fünf oben genannten Modelle von Claude, Gemini und DeepSeek – wenn du GPT-Modelle von OpenAI oder Dutzende kleine Open-Weight-Finetunes suchst, passt ein anderes Gateway besser zu dir.