spicyapiDokumentacja
Aplikacje i wtyczki
Treść główna

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

  1. Utwórz dla aplikacji osobny klucz API na spicyapi.ai/console/keys i nadaj mu dzienny limit wydatków.
  2. 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ższego https://api.spicyapi.ai/v1/chat/completions), wklej klucz i ustaw model na identyfikator czatu kończący się na /chat, skopiowany z aktualnego katalogu.
  3. 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 jako MODEL_ID_FROM_CATALOG. MODEL_ID_FROM_CATALOG oznacza 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 /chat na końcu. Pełna lista jest na spicyapi.ai/models; zwraca ją też GET https://api.spicyapi.ai/v1/models z 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

AplikacjaAdres do wpisaniaGdzie wpisać kluczModelKto wysyła żądanie
RisuAIhttps://api.spicyapi.ai/v1 (działa też pełny .../v1/chat/completions)Key/PasswordRequest Model, wpisywany ręcznieSerwer RisuAI w wersji webowej, twój komputer w aplikacji desktopowej
Agnaihttps://api.spicyapi.ai/v1 (nie pełna ścieżka)API KeyWybierany w presecie z listy pobranej ze SpicyAPISerwer Agnai
Chubhttps://api.spicyapi.ai/v1 (nie pełna ścieżka)Reverse Proxy KeyLista rozwijana pobrana ze SpicyAPITwoja przeglądarka
KoboldAI Litehttps://api.spicyapi.ai/v1Pole API key w połączeniu OpenAILista rozwijana pobrana ze SpicyAPITwoja przeglądarka
Janitor AIhttps://api.spicyapi.ai/v1/chat/completions (pełna ścieżka)API KeyModel Name, wpisywany ręcznieNiezweryfikowano, 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_failed z 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 na reasoning_effort. Aplikacje z polem Additional Parameters albo parametrów niestandardowych mogą to przekazać, na przykład reasoning_effort z 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łny https://api.spicyapi.ai/v1/chat/completions też 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 (albo https://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 wpisaniu https://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 widziszCo 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/completionsAplikacja 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 polaAplikacja 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ściHistoria 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ół zdaniaMax 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.
429Za 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.

Na tej stronie