Aplikacje do roleplay (RisuAI, Agnai, Chub, KoboldAI Lite, Janitor AI)
Połącz modele tekstowe SpicyAPI z RisuAI, Agnai, Chub, KoboldAI Lite i Janitor AI. Dokładne pola w każdej aplikacji, modele odpowiednie do roleplay, obsługa modeli z rozumowaniem i limity wydatków.
Aplikacje do roleplay pozwalają rozmawiać z postaciami, a większość z nich pozwala podłączyć własny model AI przez połączenie zgodne z OpenAI. SpicyAPI mówi tym protokołem, więc możesz wskazać mu te aplikacje, wybrać dowolny model tekstowy SpicyAPI i płacić z salda SpicyAPI.
Ta strona obejmuje pięć aplikacji webowych i desktopowych: RisuAI, Agnai, Chub, KoboldAI Lite i Janitor AI. O SillyTavern przeczytasz w SillyTavern. Aplikacje tworzą inni ludzie i zmieniają swoje ekrany; nazwy pól poniżej pochodzą z opublikowanego kodu źródłowego i stron pomocy każdej aplikacji, a każda sekcja mówi, co sprawdzono, a czego nie.
W skrócie
- Utwórz dla aplikacji osobny klucz API na spicyapi.ai/console/keys i nadaj mu dzienny limit wydatków.
- W aplikacji wybierz jej połączenie zgodne z OpenAI albo „reverse proxy”. Jako adres wpisz
https://api.spicyapi.ai/v1(Janitor AI wymaga dłuższegohttps://api.spicyapi.ai/v1/chat/completions), wklej klucz i ustaw model na identyfikator czatu kończący się na/chat, skopiowany z aktualnego katalogu. - Dla modeli z rozumowaniem ustaw Max tokens na co najmniej 1000, a potem wyślij wiadomość.
Czego potrzebujesz
- Konto SpicyAPI z saldem. Zobacz Przygotuj konto i Rozliczenia.
- Klucz API zaczynający się od
sk-spicy-. Zobacz Uwierzytelnianie. - Identyfikator modelu. Modele tekstowe nazywają się
<maker>/<model>/chat, a tutaj zapisujemy to jakoMODEL_ID_FROM_CATALOG.MODEL_ID_FROM_CATALOGoznacza identyfikator modelu czatu, który kopiujesz z aktualnego katalogu (GET /api/v1/models); nigdy nie wpisuj samego symbolu zastępczego. Identyfikator trzeba wpisać dokładnie, razem z/chatna końcu. Pełna lista jest na spicyapi.ai/models; zwraca ją teżGET https://api.spicyapi.ai/v1/modelsz twoim kluczem, a identyfikatory czatu to te kończące się na/chat. Zobacz Katalog modeli i schematy.
Która aplikacja ma które pole
| Aplikacja | Adres do wpisania | Gdzie wpisać klucz | Model | Kto wysyła żądanie |
|---|---|---|---|---|
| RisuAI | https://api.spicyapi.ai/v1 (działa też pełny .../v1/chat/completions) | Key/Password | Request Model, wpisywany ręcznie | Serwer RisuAI w wersji webowej, twój komputer w aplikacji desktopowej |
| Agnai | https://api.spicyapi.ai/v1 (nie pełna ścieżka) | API Key | Wybierany w presecie z listy pobranej ze SpicyAPI | Serwer Agnai |
| Chub | https://api.spicyapi.ai/v1 (nie pełna ścieżka) | Reverse Proxy Key | Lista rozwijana pobrana ze SpicyAPI | Twoja przeglądarka |
| KoboldAI Lite | https://api.spicyapi.ai/v1 | Pole API key w połączeniu OpenAI | Lista rozwijana pobrana ze SpicyAPI | Twoja przeglądarka |
| Janitor AI | https://api.spicyapi.ai/v1/chat/completions (pełna ścieżka) | API Key | Model Name, wpisywany ręcznie | Niezweryfikowano, zobacz sekcję o Janitor AI |
Różnica między krótkim a pełnym adresem ma znaczenie. Aplikacje, które same dopisują /chat/completions, przestają działać, jeśli je podasz, a Janitor AI wymaga pełnego zapisu.
Wybierz model
Do roleplay potrzebny jest model, który trzyma się roli, pisze długie odpowiedzi i nie odmawia zwykłych próśb o historie. Ranking roleplay i LLM ocenia modele tekstowe SpicyAPI pod tym kątem i pokazuje aktualne ceny. Zaglądaj do niego zamiast polegać na liście spisanej tutaj, bo modele i rankingi się zmieniają.
Strona każdego modelu pokazuje też etykietę polityki treści (na przykład bez ograniczeń, graniczna albo filtrowana). Ta etykieta mówi, jak swobodnie model odpowiada; wybierz model, którego etykieta pasuje do historii, które chcesz pisać.
DeepSeek V4.1 Flash to dobry pierwszy model do wypróbowania: jest blisko szczytu rankingu i należy do najtańszych. Skopiuj jego identyfikator (kończy się na /chat) z aktualnego katalogu na spicyapi.ai/models, zamiast wpisywać go z pamięci.
Dwa ograniczenia, o których warto wiedzieć:
- Niektóre modele przyjmują najwyżej 256 wiadomości na żądanie. W bardzo długim czacie aplikacja wysyłająca całą historię może to przekroczyć. Poszukaj w aplikacji ustawienia, ile historii wysyłać, albo rozmiaru kontekstu, i zmniejsz je. Limity modelu są na jego stronie.
- Obraz na wejściu działa tylko z modelami, które czytają obrazy. Zwykły czat roleplay go nie potrzebuje.
Ustawienia próbkowania
Aplikacje do roleplay wysyłają z każdą wiadomością całą garść ustawień próbkowania: temperature, top-p, top-k, min-p, top-a, frequency, presence i repetition penalty. Modele różnią się tym, które z nich przyjmują.
SpicyAPI ignoruje te, których model nie używa, zamiast odrzucać wiadomość. Ignoruje też n: 1, pustą listę stop oraz ciągi stop w modelu, który ich nie ma. Gdy coś ignoruje, odpowiedź niesie nagłówek X-Spicy-Ignored-Params z nazwami pominiętych ustawień, więc widzisz dokładnie, co nie miało wpływu.
Gdy model przyjmuje dane ustawienie, ale nie wysłaną wartość, SpicyAPI używa najbliższej wartości, jaką model przyjmuje: temperature powyżej maksimum modelu staje się maksimum, a lista ciągów stop dłuższa, niż model dopuszcza, zachowuje pierwsze. Te zmiany są wymienione w nagłówku X-Spicy-Adjusted-Params, na przykład temperature=1, stop=kept 1 of 3. Dzięki temu możesz zostawić swoje zwykłe presety.
Pola, które nie są ustawieniami próbkowania, są traktowane inaczej: jeśli aplikacja wyśle coś, czego model w ogóle nie zna, SpicyAPI nadal odpowie błędem 400 ze wskazaniem pola.
Modele z rozumowaniem i Max tokens
Niektóre modele myślą, zanim odpowiedzą. Myślenie zużywa tokeny, a te tokeny wliczają się do Max tokens (w zależności od aplikacji także Max output, Response length albo max_new_tokens).
- Ustaw Max tokens szczodrze. Jeśli jest bardzo małe, na przykład 20 albo 200, model z rozumowaniem może zużyć cały budżet na myślenie i nie zwrócić tekstu. Dostaniesz wtedy błąd
upstream_failedz informacją, że budżet wyjścia poszedł na rozumowanie. Zacznij od 1000 lub więcej i zwiększ, jeśli odpowiedzi się urywają. - Myślenie kosztuje pieniądze i czas. Za tokeny rozumowania płacisz jak za każde inne wyjście, a pierwsze słowo pojawia się później. Niektórym modelom można kazać myśleć krócej ustawieniem
reasoning_effort. Poziomy różnią się zależnie od modelu; poziom, którego model nie oferuje, jest zmieniany na najbliższy, jaki oferuje, a ustawienia rozumowania w stylu OpenRouter (wysyła je Agnai) są tłumaczone nareasoning_effort. Aplikacje z polem Additional Parameters albo parametrów niestandardowych mogą to przekazać, na przykładreasoning_effortz niższą wartością; większość aplikacji poniżej nie wysyła tego sama z siebie. - Niektóre aplikacje wypisują myślenie na czacie. Janitor AI otacza je znacznikami
<think>. Chub w ogóle go nie pokazuje.
Pilnuj wydatków
Czaty roleplay są długie, a aplikacje przy każdej wiadomości wysyłają ponownie całą rozmowę, więc koszt wiadomości rośnie razem z czatem.
Dla każdej aplikacji utwórz osobny klucz w konsoli. Podczas tworzenia otwórz Advanced i ustaw dzienny limit wydatków (a jeśli chcesz, także miesięczny). Jeśli aplikacja zacznie działać źle, wpadnie w pętlę albo klucz wycieknie, szkoda zatrzyma się na limicie, a ten jeden klucz możesz unieważnić, nie ruszając niczego innego. Klucz można też ograniczyć do wybranych modeli. Zobacz Uwierzytelnianie.
Te aplikacje przechowują twój klucz na własnych serwerach albo w twojej przeglądarce. Strona RisuAI, Agnai i Janitor AI przesyłają twój klucz i czat przez swoje serwery; Chub i KoboldAI Lite wysyłają żądania prosto z twojej przeglądarki. Osobny klucz z limitem to właściwy środek ostrożności w każdym przypadku.
RisuAI
RisuAI działa na risuai.xyz, jako aplikacja desktopowa albo na twoim własnym serwerze. Sprawdzono z kodem źródłowym RisuAI (wersja 2026.8.250).
Wybierz model Custom API
W ustawieniach bota otwórz listę modeli i wybierz Custom API.
Wypełnij trzy pola
- URL (pokazywane jako „Reverse Proxy”):
https://api.spicyapi.ai/v1. RisuAI samo dopisuje/chat/completions, gdy adres kończy się na/v1, a pełnyhttps://api.spicyapi.ai/v1/chat/completionsteż działa. - Key/Password: twój klucz
sk-spicy-. Jest wysyłany jako token bearer. - Request Model: identyfikator modelu,
MODEL_ID_FROM_CATALOG. RisuAI nie ma listy modeli dla niestandardowych adresów, więc wpisz go ręcznie.
Ustaw listę Format na OpenAI Compatible.
Ustaw Max tokens i wyślij wiadomość
Jeśli wybrałeś model z rozumowaniem, zwiększ maksymalną długość odpowiedzi (patrz wyżej), a potem czatuj.
Skąd idą żądania. Na risuai.xyz RisuAI zwykle przekazuje żądania przez własny serwer, więc przechodzą przez niego twój klucz i czat. Aplikacja desktopowa i własny serwer wysyłają żądania bezpośrednio z twojego komputera. Tylko opcja „Force Plain Fetch” w wersji webowej, ukryta wśród niezalecanych ustawień, wysyła żądania z przeglądarki; SpicyAPI je także przyjmuje.
Próbkowanie. Domyślne ustawienia Custom API w RisuAI wysyłają frequency, presence i repetition penalty, min-p oraz top-a. SpicyAPI ignoruje te, których model nie używa, więc ustawienia domyślne działają.
Agnai
Agnai jest na agnai.chat. Sprawdzono z kodem źródłowym Agnai (gałąź dev, 2026-10-06). SpicyAPI nie ma na wbudowanej liście dostawców Agnai, więc dodajesz je jako niestandardowe połączenie zgodne z OpenAI.
Dodaj dostawcę
W Settings otwórz stronę zarządzania dostawcami i dodaj dostawcę typu OpenAI Compat (albo Remotely Hosted, a potem Other (Generic OpenAI)). Nadaj mu dowolną etykietę.
Wpisz adres i klucz
- URL:
https://api.spicyapi.ai/v1(albohttps://api.spicyapi.ai; Agnai dopisuje/v1, jeśli go brakuje). Nie wpisuj pełnej ścieżki.../chat/completions, bo Agnai ją podwoi. - API Key: twój klucz
sk-spicy-.
Wybierz model w presecie
W presecie, z którym czatujesz, wybierz model z listy. Agnai wypełnia listę z listy modeli SpicyAPI. Wybierz identyfikator kończący się na /chat.
Skąd idą żądania. Przy dostawcy dodanym w ten sposób żądanie wysyła serwer Agnai, więc twój klucz jest przechowywany u Agnai.
Próbkowanie. Agnai zawsze wysyła temperature i top-p, których niektóre modele nie przyjmują. SpicyAPI ignoruje je dla tych modeli, więc działają modele takie jak DeepSeek V4 i Kimi K3.
Niezalecane: tryby bezpośrednio z przeglądarki. Agnai ma też typ połączenia Self-Host oraz przełącznik Use Local Requests w starszych presetach, które każą przeglądarce wywoływać adres bezpośrednio. Z kodu źródłowego wynika, że te tryby dodają pole think, którego SpicyAPI nie przyjmuje, a SpicyAPI odpowiada 400 na pola, których nie zna. Nie testowano tego ze SpicyAPI. Jeśli natrafisz tam na 400, wróć do konfiguracji dostawcy opisanej wyżej.
Chub
Chub (chub.ai) wysyła żądania prosto z twojej przeglądarki pod podany adres. Sprawdzono z opublikowanym kodem front-endu Chub (kompilacja z 2026-06-28); ekrany Chub mogły się od tamtej pory zmienić. Połączenie z przeglądarki działa, bo SpicyAPI dopuszcza żądania ze stron WWW.
Dodaj reverse proxy w Secrets
Otwórz Secrets, znajdź blok OpenAI i wybierz Reverse Proxy zamiast My Own API Key.
Wpisz adres i klucz
- Open AI Reverse Proxy:
https://api.spicyapi.ai/v1. Chub sam dopisuje/chat/completions, więc go nie dodawaj. - Reverse Proxy Key: twój klucz
sk-spicy-.
Naciśnij Check Proxy. Udane sprawdzenie ładuje też listę modeli.
Wybierz OpenAI / Proxy i model
W Configuration > Prompt Structure ustaw API na OpenAI / Proxy i wybierz model z listy (identyfikator kończący się na /chat).
Chub ostrzega na własnej stronie ustawień, że przy użyciu reverse proxy twój adres IP i log czatu mogą być zapisywane. To uwaga Chub, a nie SpicyAPI.
Rzeczy, które widać w kodzie źródłowym i mogą zaskoczyć:
- Chub przestaje czytać odpowiedź strumieniową po 120 sekundach. Model z rozumowaniem, który myśli bardzo długo, może zostać ucięty; obniż jego wysiłek rozumowania albo wybierz model, który odpowiada szybciej.
- Chub nie wyświetla myślenia modelu, tylko jego odpowiedź.
KoboldAI Lite
KoboldAI Lite to pojedyncza strona WWW pod lite.koboldai.net. Sprawdzono z jej opublikowanym index.html. Wywołuje adres bezpośrednio z twojej przeglądarki, co działa, bo SpicyAPI dopuszcza żądania ze stron WWW.
Wybierz połączenie OpenAI
Otwórz Settings i wybierz połączenie OpenAI API (własny endpoint).
Wpisz adres i klucz
Jako adres wpisz https://api.spicyapi.ai/v1, a w polu klucza swój klucz sk-spicy-. Aplikacja obcina końcowe /chat/completions, jeśli je wkleisz.
Pobierz listę modeli
Użyj przycisku pobierania modeli w aplikacji, wybierz identyfikator kończący się na /chat i ustaw długość wyjścia w ustawieniach generowania.
Zostaw „CORS Proxy” wyłączone. KoboldAI Lite ma opcję kierowania żądań przez proxy prowadzone przez jego autora. Do SpicyAPI nie jest ci potrzebna, a jej włączenie wysyła twój klucz przez cudzy serwer.
Próbkowanie. Jego ustawienie powtórzeń jest wysyłane do API jako presence penalty. SpicyAPI ignoruje je dla modeli, które go nie używają.
Janitor AI
Niezweryfikowano
Nie udało się potwierdzić, że Janitor AI działa ze SpicyAPI. Janitor AI ma zamknięty kod, a do testów potrzebne jest konto, więc nikt nie próbował prawdziwego czatu. Poniżej opisano, jak ustawienia proxy przedstawia centrum pomocy Janitor i opublikowany kod strony. Traktuj to jako coś do wypróbowania, a nie jako obietnicę.
Funkcja „proxy” w Janitor AI wysyła twój czat pod wskazany przez ciebie adres. Według centrum pomocy Janitor pola znajdują się pod ikoną zębatki na stronie czatu, w API Settings, a potem Add Configuration.
Dodaj konfigurację
Wypełnij:
- Config Name: cokolwiek, na przykład
SpicyAPI. - Model Name: identyfikator modelu wpisany ręcznie:
MODEL_ID_FROM_CATALOG. - Proxy URL: pełny adres,
https://api.spicyapi.ai/v1/chat/completions. Janitor ma przycisk „Add /chat/completions”, który robi to za ciebie po wpisaniuhttps://api.spicyapi.ai/v1. - API Key: twój klucz
sk-spicy-.
Zapisz, a potem wyślij wiadomość
Przycisk Check Key/Model w Janitor centrum pomocy Janitor opisuje jako zawodny, więc przetestuj to prawdziwą wiadomością.
Jeśli Janitor pokazuje błąd sieci lub połączenia, taki jak „A network error occurred”, strona Janitor prawdopodobnie blokuje żądania do adresów innych niż OpenAI. Strona WWW Janitor ma politykę bezpieczeństwa, która dopuszcza bezpośrednie żądania tylko do jednego zewnętrznego adresu AI, czyli OpenAI. Gdy Janitor wysyła żądanie z twojej przeglądarki, przeglądarka odmawia, zanim SpicyAPI cokolwiek zobaczy, a SpicyAPI nie może tego zmienić. Jeśli twój klucz nie pokazuje w konsoli żadnego użycia, a ten błąd się pojawia, to jest właśnie przyczyna.
Jeśli na to natrafisz, użyj SillyTavern albo RisuAI.
Inne fakty z centrum pomocy Janitor i kodu strony:
- Niektóre boty w Janitor mają proxy wyłączone przez autorów, więc bot może odmówić czatu przez proxy niezależnie od tego, co wpiszesz.
- Janitor pokazuje myślenie modelu otoczone znacznikami
<think>. Użyj większego Max tokens albo niższego wysiłku rozumowania, aby było krótkie. - Janitor ogranicza długość pojedynczej wiadomości, którą wpisujesz.
Rozwiązywanie problemów
| Co widzisz | Co zrobić |
|---|---|
401 albo „invalid API key” | Skopiuj klucz ponownie z konsoli. Unieważniony klucz przestaje działać natychmiast, a klucz musi być tym sk-spicy-, a nie hasłem do konta. |
402 albo „insufficient balance” | Doładuj konto w konsoli albo sprawdź, czy nie osiągnięto dziennego limitu wydatków klucza. Zobacz Rozliczenia. |
404 albo „model not found” | Identyfikator modelu jest błędny. Musi kończyć się na /chat i być zapisany tak jak w https://api.spicyapi.ai/v1/models. |
404 dla samego adresu, z podwojoną ścieżką jak /chat/completions/chat/completions | Aplikacja sama dopisuje ścieżkę. Użyj https://api.spicyapi.ai/v1 (RisuAI, Agnai, Chub, KoboldAI Lite). Tylko Janitor AI wymaga pełnej ścieżki. |
400 ze wskazaniem pola | Aplikacja wysłała coś, czego model nie przyjmuje i co nie jest ustawieniem próbkowania. Usuń lub wyłącz wskazane pole. |
400 o liczbie wiadomości | Historia czatu jest dłuższa niż limit wiadomości modelu. Zmniejsz historię lub rozmiar kontekstu w aplikacji. |
upstream_failed, „the output budget was spent on reasoning” | Zwiększ Max tokens albo obniż wysiłek rozumowania modelu. Zobacz Modele z rozumowaniem i Max tokens. |
| Odpowiedź urywa się w pół zdania | Max tokens jest za niskie albo (w Chub) osiągnięto limit 120 sekund. |
| „Network error” albo „Failed to fetch” w aplikacji i brak żądania w logach konsoli | Żądanie nigdy nie dotarło do SpicyAPI. W Janitor AI to strona blokuje adres; gdzie indziej sprawdź adres pod kątem literówek i czy serwis jest osiągalny. |
429 | Za dużo żądań naraz. Poczekaj kilka sekund; współdzielone aplikacje mogą wysyłać żądania wielu użytkowników z jednego adresu. |
Kody błędów wyjaśnia strona Błędy. Każdy błąd kończy się request_id; podaj go wsparciu, a żądanie da się dokładnie odnaleźć. Twoje żądania widać też w sekcji Logs w konsoli, co jest najszybszym sposobem, by sprawdzić, czy żądanie w ogóle dotarło do SpicyAPI.
SillyTavern
Rozmawiaj z modelami SpicyAPI w SillyTavern przez źródło Custom (OpenAI-compatible), a potem dodaj bezpłatne rozszerzenie SpicyAPI do obrazów, wideo i przycisku Animate, z wyceną każdego uruchomienia.
Bot na Telegram i Discord
Uruchom własnego, prywatnego bota, który tworzy obrazy i wideo, animuje zdjęcia i rozmawia z postaciami, które zdefiniujesz, płatnego z salda SpicyAPI, z limitami wydatków sprawdzanymi przed każdą opłatą.

