Rollenspiel-Apps (RisuAI, Agnai, Chub, KoboldAI Lite, Janitor AI)

Mit Rollenspiel-Apps chatten Sie mit Figuren, und die meisten erlauben es, über eine OpenAI-kompatible Verbindung ein eigenes KI-Modell mitzubringen. SpicyAPI spricht dieses Protokoll. Sie können diese Apps also auf SpicyAPI richten, ein beliebiges SpicyAPI-Textmodell wählen und aus Ihrem SpicyAPI-Guthaben bezahlen.

Diese Seite behandelt fünf Web- und Desktop-Apps: RisuAI, Agnai, Chub, KoboldAI Lite und Janitor AI. Zu SillyTavern siehe SillyTavern. Die Apps stammen von anderen Entwicklern und ändern ihre Oberflächen. Die unten genannten Feldnamen stammen aus dem veröffentlichten Quellcode und den Hilfeseiten der jeweiligen App, und jeder Abschnitt sagt, was geprüft wurde und was nicht.

Was Sie brauchen

• Ein SpicyAPI-Konto mit Guthaben. Siehe Konto einrichten und Abrechnung.
• Einen API-Schlüssel, der mit sk-spicy- beginnt. Siehe Authentifizierung.
• Eine Modell-ID. Textmodelle heißen <maker>/<model>/chat, hier als MODEL_ID_FROM_CATALOG geschrieben. MODEL_ID_FROM_CATALOG steht für eine Chatmodell-ID, die Sie aus dem Live-Katalog (GET /api/v1/models) kopieren; tippen Sie den Platzhalter selbst nie ein. Die ID muss exakt eingegeben werden, einschließlich des /chat am Ende. Die vollständige Liste finden Sie unter spicyapi.ai/models; mit Ihrem Schlüssel liefert sie auch GET https://api.spicyapi.ai/v1/models, und Chat-IDs sind die mit der Endung /chat. Siehe Modelle.

Welche App welches Feld ausfüllt

Der Unterschied zwischen der kurzen und der vollständigen Adresse ist wichtig. Apps, die /chat/completions selbst anhängen, funktionieren nicht mehr, wenn Sie es mit angeben, und Janitor AI braucht es ausgeschrieben.

Ein Modell auswählen

Für Rollenspiele brauchen Sie ein Modell, das in der Rolle bleibt, lange Antworten schreibt und gewöhnliche Story-Wünsche nicht verweigert. Das Roleplay- und LLM-Leaderboard bewertet die Textmodelle von SpicyAPI danach und zeigt aktuelle Preise. Schauen Sie dort nach, statt sich auf eine hier geschriebene Liste zu verlassen, denn Modelle und Platzierungen ändern sich.

Jede Modellseite zeigt außerdem ein Inhaltsrichtlinien-Label (zum Beispiel unrestricted, borderline oder filtered). Es sagt, wie frei das Modell antwortet. Wählen Sie ein Modell, dessen Label zu den Geschichten passt, die Sie schreiben möchten.

DeepSeek V4.1 Flash ist ein gutes erstes Modell: Es liegt im Leaderboard weit oben und gehört zu den günstigsten. Kopieren Sie seine ID (sie endet auf /chat) aus dem Live-Katalog unter spicyapi.ai/models, statt sie aus dem Gedächtnis zu tippen.

Zwei Grenzen sollten Sie kennen:

• Manche Modelle akzeptieren höchstens 256 Nachrichten pro Anfrage. In einem sehr langen Chat kann eine App, die den gesamten Verlauf sendet, darüber hinausgehen. Suchen Sie in der App die Einstellung dafür, wie viel Verlauf gesendet wird, oder die Kontextgröße, und senken Sie sie. Die Limits eines Modells stehen auf seiner Seite.
• Bildeingabe funktioniert nur mit Modellen, die Bilder lesen. Für gewöhnliche Rollenspiel-Chats ist sie nicht nötig.

Sampling-Einstellungen

Rollenspiel-Apps senden mit jeder Nachricht einen ganzen Schwung Sampling-Einstellungen: Temperatur, Top-p, Top-k, Min-p, Top-a sowie Frequency-, Presence- und Repetition-Penalty. Modelle unterscheiden sich darin, welche davon sie akzeptieren.

SpicyAPI ignoriert die Einstellungen, die ein Modell nicht verwendet, statt die Nachricht abzulehnen. Ebenso ignoriert es n: 1, eine leere Stop-Liste und Stop-Strings bei einem Modell, das keine hat. Wenn etwas ignoriert wird, trägt die Antwort einen Header X-Spicy-Ignored-Params, der die verworfenen Einstellungen nennt, sodass Sie genau sehen, was keine Wirkung hatte.

Nimmt ein Modell eine Einstellung an, aber nicht den gesendeten Wert, verwendet SpicyAPI den nächstliegenden Wert, den es akzeptiert: Eine Temperatur über dem Maximum des Modells wird zum Maximum, und eine Liste von Stop-Strings, die länger ist als vom Modell erlaubt, behält ihre ersten Einträge. Diese Änderungen stehen in einem Header X-Spicy-Adjusted-Params, zum Beispiel temperature=1, stop=kept 1 of 3. Sie können Ihre gewohnten Presets also unverändert lassen.

Anders sieht es bei Feldern aus, die keine Sampling-Einstellungen sind: Sendet eine App etwas, das das Modell überhaupt nicht kennt, antwortet SpicyAPI weiterhin mit einem 400-Fehler, der das Feld nennt.

Reasoning-Modelle und Max tokens

Manche Modelle denken nach, bevor sie antworten. Das Nachdenken verbraucht Tokens, und diese Tokens zählen zu Max tokens (je nach App auch Max output, Response length oder max_new_tokens genannt).

• Setzen Sie Max tokens großzügig. Ist der Wert sehr klein, etwa 20 oder 200, kann ein Reasoning-Modell das gesamte Budget für das Nachdenken verbrauchen und keinen Text zurückgeben. Sie erhalten dann den Fehler upstream_failed mit dem Hinweis, dass das Ausgabebudget für Reasoning verbraucht wurde. Beginnen Sie bei 1.000 oder mehr und erhöhen Sie, wenn Antworten abgeschnitten werden.
• Nachdenken kostet Geld und Zeit. Reasoning-Tokens bezahlen Sie wie jede andere Ausgabe, und das erste Wort kommt später. Manche Modelle lassen sich mit der Einstellung reasoning_effort anweisen, weniger nachzudenken. Die Stufen unterscheiden sich je Modell; eine Stufe, die das Modell nicht anbietet, wird auf die nächstliegende geändert, die es hat, und Reasoning-Einstellungen im OpenRouter-Stil (Agnai sendet sie) werden in reasoning_effort übersetzt. Apps mit einem Feld Additional Parameters oder einem Feld für eigene Parameter können sie weitergeben, zum Beispiel reasoning_effort mit einem niedrigeren Wert; die meisten der folgenden Apps senden sie nicht von selbst.
• Manche Apps geben das Nachdenken im Chat aus. Janitor AI umschließt es mit <think>-Tags. Chub zeigt es gar nicht an.

Ausgaben im Griff behalten

Rollenspiel-Chats sind lang, und Apps senden mit jeder Nachricht die gesamte Unterhaltung erneut. Die Kosten pro Nachricht wachsen also mit dem Chat.

Erstellen Sie für jede App einen eigenen Schlüssel in der Konsole. Öffnen Sie beim Erstellen Advanced und legen Sie ein Tageslimit fest (auf Wunsch auch ein Monatslimit). Wenn die App sich falsch verhält, in eine Schleife gerät oder der Schlüssel abfließt, endet der Schaden am Limit, und Sie können genau diesen Schlüssel widerrufen, ohne etwas anderes anzutasten. Ein Schlüssel lässt sich außerdem auf bestimmte Modelle beschränken. Siehe Authentifizierung.

Diese Apps speichern Ihren Schlüssel auf ihren eigenen Servern oder in Ihrem Browser. Die Website von RisuAI sowie Agnai und Janitor AI leiten Ihren Schlüssel und Ihren Chat über ihre Server; Chub und KoboldAI Lite senden Anfragen direkt aus Ihrem Browser. Ein eigener Schlüssel mit Limit ist in jedem Fall die richtige Vorsichtsmaßnahme.

RisuAI

RisuAI läuft auf risuai.xyz, als Desktop-App oder auf Ihrem eigenen Server. Geprüft anhand des RisuAI-Quellcodes (Version 2026.8.250).

Woher die Anfragen kommen. Auf risuai.xyz leitet RisuAI Anfragen normalerweise über seinen eigenen Server weiter, sodass Ihr Schlüssel und Ihr Chat dort durchlaufen. Die Desktop-App und ein selbst gehosteter Server senden Anfragen direkt von Ihrem Rechner. Nur die Option „Force Plain Fetch“ der Website, versteckt unter den nicht empfohlenen Einstellungen, sendet Anfragen aus dem Browser; SpicyAPI akzeptiert auch diese.

Sampling. Die Standardeinstellungen der Custom API von RisuAI senden Frequency-, Presence- und Repetition-Penalty, Min-p und Top-a. SpicyAPI ignoriert die, die das Modell nicht verwendet, daher funktionieren die Standardwerte.

Agnai

Agnai finden Sie unter agnai.chat. Geprüft anhand des Agnai-Quellcodes (dev-Branch, 2026-10-06). SpicyAPI steht nicht in der eingebauten Anbieterliste von Agnai, Sie fügen es daher als benutzerdefinierte OpenAI-kompatible Verbindung hinzu.

Woher die Anfragen kommen. Bei einem so hinzugefügten Anbieter sendet der Server von Agnai die Anfrage, Ihr Schlüssel wird also bei Agnai gespeichert.

Sampling. Agnai sendet immer Temperatur und Top-p, die manche Modelle nicht annehmen. SpicyAPI ignoriert sie bei diesen Modellen, sodass Modelle wie DeepSeek V4 und Kimi K3 funktionieren.

Nicht empfohlen: Browser-direkte Modi. Agnai hat außerdem den Verbindungstyp Self-Host und bei älteren Presets den Schalter Use Local Requests, bei denen Ihr Browser die Adresse direkt aufruft. Laut Quellcode fügen diese Modi ein Feld think hinzu, das SpicyAPI nicht akzeptiert, und SpicyAPI antwortet mit 400 auf Felder, die es nicht kennt. Das wurde nicht gegen SpicyAPI getestet. Tritt dort ein 400 auf, wechseln Sie zurück zur oben beschriebenen Anbieter-Einrichtung.

Chub

Chub (chub.ai) sendet Anfragen direkt aus Ihrem Browser an die angegebene Adresse. Geprüft anhand des veröffentlichten Frontend-Codes von Chub (Build vom 2026-06-28); die Oberflächen von Chub können sich seitdem geändert haben. Die Browser-Verbindung funktioniert, weil SpicyAPI Anfragen von Webseiten zulässt.

Chub warnt auf der eigenen Einstellungsseite, dass Ihre IP und Ihr Chat-Protokoll protokolliert werden könnten, wenn Sie einen Reverse Proxy nutzen. Das ist ein Hinweis von Chub, nicht von SpicyAPI.

Dinge, die der Quellcode zeigt und die überraschen können:

• Chub liest eine gestreamte Antwort nach 120 Sekunden nicht mehr weiter. Ein Reasoning-Modell, das lange nachdenkt, kann dadurch abgeschnitten werden; senken Sie seinen Reasoning-Aufwand oder wählen Sie ein Modell, das schneller antwortet.
• Chub zeigt das Nachdenken eines Modells nicht an, nur die Antwort.

KoboldAI Lite

KoboldAI Lite ist eine einzelne Webseite unter lite.koboldai.net. Geprüft anhand der veröffentlichten index.html. Sie ruft die Adresse direkt aus Ihrem Browser auf, was funktioniert, weil SpicyAPI Anfragen von Webseiten zulässt.

Lassen Sie „CORS Proxy“ ausgeschaltet. KoboldAI Lite hat eine Option, Anfragen über einen vom Autor betriebenen Proxy zu leiten. Für SpicyAPI brauchen Sie sie nicht, und wenn Sie sie einschalten, läuft Ihr Schlüssel über den Server einer fremden Person.

Sampling. Die Wiederholungs-Einstellung wird als Presence Penalty an die API gesendet. SpicyAPI ignoriert sie bei Modellen, die sie nicht verwenden.

Janitor AI

Die „Proxy“-Funktion von Janitor AI sendet Ihren Chat an eine Adresse Ihrer Wahl. Laut Help Center von Janitor finden Sie die Felder über das Zahnradsymbol der Chat-Seite unter API Settings, dann Add Configuration.

Zeigt Janitor einen Netzwerk- oder Verbindungsfehler wie „A network error occurred“, blockiert die Seite von Janitor vermutlich Anfragen an andere Adressen als die von OpenAI. Die Webseite von Janitor hat eine Security Policy, die direkte Anfragen nur an eine einzige KI-Adresse eines Drittanbieters erlaubt, nämlich die von OpenAI. Sendet Janitor die Anfrage aus Ihrem Browser, lehnt der Browser sie ab, bevor SpicyAPI etwas davon sieht, und SpicyAPI kann daran nichts ändern. Zeigt Ihr Schlüssel in der Konsole keine Nutzung, während dieser Fehler auftritt, ist das die Ursache.

Wenn das passiert, nutzen Sie stattdessen SillyTavern oder RisuAI.

Weitere Fakten aus dem Help Center und dem Seitencode von Janitor:

• Bei manchen Janitor-Bots haben die Autoren Proxys abgeschaltet, sodass ein Bot das Chatten über einen Proxy verweigern kann, was auch immer Sie eintragen.
• Janitor zeigt das Nachdenken eines Modells in <think>-Tags an. Nutzen Sie ein größeres Max tokens oder einen niedrigeren Reasoning-Aufwand, um es kurz zu halten.
• Janitor begrenzt die Länge einer einzelnen Nachricht, die Sie eintippen.

Fehlerbehebung

Die Fehlercodes sind unter Fehler erklärt. Jeder Fehler endet mit einer request_id; nennen Sie sie dem Support, dann lässt sich die Anfrage genau finden. Ihre Anfragen erscheinen außerdem unter Logs in der Konsole. Das ist der schnellste Weg festzustellen, ob eine Anfrage SpicyAPI überhaupt erreicht hat.