Konfiguracja API SillyTavern: base URL, klucz API i lista modeli
Updated 2026-07-15
W SillyTavern wybierz Chat Completion, ustaw źródło na Custom (OpenAI-compatible), wklej base URL kończący się na /v1 i dodaj swój klucz API. Lista modeli wypełni się wtedy automatycznie z endpointu /v1/models danego dostawcy.
Krótka odpowiedź: pięć ustawień, które mają znaczenie
Otwórz panel API Connections (ikona wtyczki) i ustaw dokładnie to: API = Chat Completion. Chat Completion Source = Custom (OpenAI-compatible). Custom Endpoint (Base URL) = https://api.apisrouter.com/v1. Custom API Key = Twój klucz sk-.... Kliknij Connect, poczekaj na zielone światło i wybierz model z listy rozwijanej, na przykład deepseek-v4-flash. Najczęstszym błędem jest wklejenie pełnej ścieżki. SillyTavern sam dokleja /chat/completions do tego, co wpiszesz, więc URL musi kończyć się na /v1. Jeśli wkleisz https://api.apisrouter.com/v1/chat/completions, SillyTavern odpyta /v1/chat/completions/chat/completions i połączenie padnie z błędem 404. To odwrotność JanitorAI, który w konfiguracji proxy oczekuje pełnego adresu completions. Ten sam dostawca, inne konwencje pól.
Dlaczego adres API SillyTavern kończy się na /v1
Każde API kompatybilne z OpenAI to base URL plus zestaw stałych tras. GET /v1/models zwraca listę identyfikatorów modeli dostępnych dla Twojego klucza. POST /v1/chat/completions wykonuje właściwe zapytanie czatu. SillyTavern zna te trasy i buduje je sam, dlatego pyta Cię tylko o bazowy adres. Po kliknięciu Connect wywołuje /v1/models z Twoim kluczem i na podstawie odpowiedzi wypełnia listę modeli. Pusta lista niemal zawsze oznacza, że to wywołanie się nie powiodło. Musisz też wybrać właściwy tryb API. Chat Completion wysyła ustrukturyzowane wiadomości z rolami system, user i assistant, czyli dokładnie to, czego oczekuje każdy hostowany dostawca kompatybilny z OpenAI. Text Completion wysyła jeden surowy ciąg promptu i istnieje głównie dla lokalnych backendów jak KoboldCpp czy text-generation-webui. Dla dowolnego hostowanego klucza API używaj Chat Completion. Jeśli wybierzesz Text Completion dla hostowanego endpointu czatu, dostaniesz błędy albo zepsute formatowanie, a część widocznych w tym trybie samplerów i tak nie ma zastosowania.
Konfiguracja krok po kroku
Jeśli lista pozostaje pusta po kliknięciu Connect, sprawdź po kolei trzy rzeczy: URL kończy się na /v1 bez dodatkowej ścieżki i bez spacji na końcu, klucz jest wklejony bez cudzysłowów i białych znaków, a źródło to Custom (OpenAI-compatible), a nie zwykłe OpenAI. Zwykłe źródło OpenAI w niektórych wersjach ignoruje Twój własny URL i łączy się z api.openai.com, gdzie Twój klucz jest nieprawidłowy.
- Zdobądź klucz. W APIsRouter nie ma formularza rejestracji: zapłać na /topup, a klucz przyjdzie e-mailem. Każdy klucz kompatybilny z OpenAI działa w tych krokach tak samo.
- W SillyTavern kliknij ikonę wtyczki, żeby otworzyć API Connections.
- Ustaw API na Chat Completion.
- Ustaw Chat Completion Source na Custom (OpenAI-compatible).
- W polu Custom Endpoint (Base URL) wpisz https://api.apisrouter.com/v1, bez niczego po /v1.
- Wklej swój klucz w pole Custom API Key.
- Kliknij Connect. Kropka statusu zmieni się na zieloną, a lista Available Models wypełni się z /v1/models.
- Wybierz model, otwórz kartę postaci i wyślij krótką testową wiadomość.
Sprawdź połączenie poza SillyTavern
Gdy coś nie działa, przetestuj endpoint bezpośrednio, zanim obwinisz SillyTavern. To wywołanie curl robi dokładnie to samo, co przycisk Connect. Jeśli w odpowiedzi dostaniesz tablicę JSON z identyfikatorami modeli, Twój klucz i URL są w porządku, a problem leży w polach SillyTavern. Jeśli lista modeli działa, ale czaty się nie udają, uruchom jedno prawdziwe zapytanie z Pythona z tym samym base URL. Udana odpowiedź dowodzi, że cały łańcuch działa, a każdy błąd, jaki dostaniesz, jest prawdziwym błędem dostawcy, a nie ogólnym komunikatem SillyTavern.
curl https://api.apisrouter.com/v1/models \
-H "Authorization: Bearer sk-your-key"Podstawy samplerów i presetów
Źródła Chat Completion udostępniają niewielki zestaw samplerów: temperature, top P, frequency penalty i presence penalty, plus długość odpowiedzi i rozmiar kontekstu. Bardziej wyrafinowane samplery, o których mogłeś czytać (min P, mirostat, dynamic temperature), należą do backendów Text Completion i po prostu nie są wysyłane do hostowanych API czatu, więc nie szukaj ich tutaj. Presety w SillyTavern łączą dwie rzeczy: wartości samplerów oraz strukturę promptu, którą Prompt Manager składa z karty postaci, persony i lorebooka. Wbudowany preset Default to rozsądny punkt startowy. Zmieniaj jedną wartość na raz i wygeneruj tę samą scenę ponownie, żeby zobaczyć, co faktycznie robi. Rozmiar kontekstu zasługuje na uwagę: SillyTavern wypełnia okno kontekstu historią czatu, więc większy kontekst oznacza więcej tokenów promptu wysyłanych przy każdej turze, co poprawia pamięć i jednocześnie podnosi koszt każdej wiadomości.
| Ustawienie | Punkt startowy | Co robi w roleplayu |
|---|---|---|
| Temperature | 0.8 | Wyższa (do 1.1) daje bardziej urozmaiconą prozę; niższa (0.6), jeśli postać odbiega od karty |
| Top P | 0.95 | Zostaw bez zmian, chyba że odpowiedzi robią się niespójne, wtedy obniż lekko |
| Frequency penalty | 0.1 | Przeciwdziała powtarzalnym rytmom zdań w długich czatach |
| Presence penalty | 0.05 | Małe wartości zniechęcają do zapętlania tematu |
| Max response tokens | 350 | 300 do 500 pasuje do odpowiedzi w formie akapitów bez rozwlekania |
| Context size | Limit modelu lub 16k | Więcej historii na turę; także więcej tokenów wejściowych rozliczanych na wiadomość |
Rekomendowane modele dla SillyTavern
Wybór modelu ma większe znaczenie niż strojenie samplerów. Konsensus społeczności, o ile można go wyczytać z przybliżonych relacji, stawia rodzinę DeepSeek V4 na pierwszym miejscu pod względem ceny: deepseek-v4-flash to domyślna rekomendacja do długich czatów, a deepseek-v4-pro lepiej trzyma razem złożone karty i czaty grupowe. GLM-5, Kimi K2.6 i MiMo to solidne opcje budżetowe z odrębnym głosem prozy, warte rotowania, gdy czat zaczyna brzmieć zbyt podobnie. Grok wyróżnia się tym, że opublikowana polityka xAI wprost dopuszcza dojrzałe motywy w fikcyjnych settingach, co ma znaczenie przy mroczniejszych fabułach. Claude pisze najlepszą prozę ze wszystkich modeli na tej liście, ale polityka Anthropic zabrania treści jednoznacznie erotycznych, więc traktuj Claude jako wybór do twórczego pisania SFW i scen w stylu literackim. Dwie praktyczne uwagi. Po pierwsze, SillyTavern to oprogramowanie skierowane do dorosłych, a każdy model tutaj egzekwuje politykę treści swojego dostawcy niezależnie od frontendu, więc trzymaj karty i sceny w granicach tych zasad. Po drugie, ponieważ lista rozwijana jest wypełniana na żywo z /v1/models, możesz przełączać modele w trakcie czatu i porównywać odpowiedzi na tę samą wiadomość, co jest najszybszym sposobem na znalezienie własnego faworyta.
| ID modelu | Mocna strona w SillyTavern | Uwagi o polityce treści |
|---|---|---|
| deepseek-v4-flash | Faworyt społeczności do długich czatów; najlepsza wartość na wiadomość | Elastyczna polityka wobec fikcji; dobrze trzyma się kart postaci |
| deepseek-v4-pro | Lepsze podążanie za instrukcjami przy złożonych kartach i czatach grupowych | Ta sama rodzina co Flash, z lepszą spójnością |
| glm-5 | Odrębny głos prozy; dobre tempo w powolnych scenach | Opcja budżetowa do czatów mocno narracyjnych |
| kimi-k2.6 | Pamięć długiego kontekstu do dużych lorebooków | Opcja budżetowa; obsługuje duże karty bez zapominania |
| grok-4.5 | Silna improwizacja i wymiany zdań | Polityka xAI dopuszcza dojrzałe motywy w fikcyjnych settingach |
| claude-sonnet-4-6 | Najwyższa jakość prozy w tej cenie | Tylko twórcze pisanie SFW; Anthropic zabrania treści jednoznacznie erotycznych |
| claude-opus-4-7 | Najlepsze długie pisanie literackie | Ta sama polityka tylko-SFW co Sonnet |
| gemini-3.5-flash | Szybkie odpowiedzi, długi kontekst | Standardowa polityka Google; dobra do RP w stylu przygodowym |
Ile faktycznie kosztują czaty w SillyTavern
Hostowane modele rozliczają za token, a roleplay jest wymagający po stronie wejścia: każda tura wysyła ponownie kartę postaci plus ostatnią historię. Tura, która wysyła 8000 tokenów promptu i dostaje odpowiedź na 350 tokenów, kosztuje na deepseek-v4-flash około jednej dziesiątej centa, więc kilka dolarów wystarcza na miesiące swobodnego czatowania. Ta sama tura na claude-opus-4-7 kosztuje mniej więcej 25 razy więcej, dlatego większość ludzi używa taniego modelu na co dzień, a modele premium zachowuje na sceny, na których naprawdę im zależy. Jeden klucz gateway pokrywa całą tę tabelę. APIsRouter to gateway kompatybilny z OpenAI z rozliczeniem pay-as-you-go i bez subskrypcji: płacisz na /topup bez zakładania konta, klucz przychodzi e-mailem, pierwsza wpłata dodaje dodatkowe +100% do salda, modele globalne są wycenione 20% poniżej cen oficjalnych, a modele chińskie mieszczą się poniżej swoich cen oficjalnych.
| Model | Wejście / 1M tokenów | Wyjście / 1M tokenów |
|---|---|---|
| deepseek-v4-flash | $0.126 | $0.252 |
| deepseek-v4-pro | $0.3915 | $0.783 |
| glm-5 | $0.514 | $2.314 |
| gemini-3.5-flash | $1.20 | $7.20 |
| claude-sonnet-4-6 | $2.40 | $12.00 |
| claude-opus-4-7 | $4.00 | $20.00 |
| gpt-5.5 | $4.00 | $24.00 |
| grok-4.5 | $1.60 | $4.80 |
Częste pytania
Jaki adres API wpisać w SillyTavern?
Tylko base URL, kończący się na /v1. Dla APIsRouter to https://api.apisrouter.com/v1. SillyTavern sam dokleja /chat/completions, więc wpisanie pełnej ścieżki completions psuje połączenie błędem 404.
Czy istnieje darmowe API do SillyTavern?
Samo SillyTavern to darmowe oprogramowanie open source. Dostęp do hostowanych modeli jest rozliczany za token, choć niektórzy dostawcy oferują darmowe warstwy z ciasnymi limitami zapytań i kolejkami. Uruchomienie lokalnego modelu przez KoboldCpp jest darmowe, jeśli Twój sprzęt sobie z tym poradzi. W praktyce budżetowe hostowane modele jak deepseek-v4-flash kosztują ułamek centa za wiadomość, co przy okazjonalnym użyciu jest wystarczająco blisko darmowego, bez bólu limitów zapytań.
Dlaczego lista modeli w SillyTavern jest pusta?
Wywołanie Connect do /v1/models się nie powiodło. Sprawdź, czy URL kończy się na /v1 bez dodatkowej ścieżki czy spacji, czy klucz jest wklejony czysto, i czy źródło to Custom (OpenAI-compatible), a nie zwykłe OpenAI. Przetestuj curlem /v1/models, żeby zobaczyć prawdziwy błąd dostawcy.
Chat Completion czy Text Completion w SillyTavern?
Chat Completion dla każdego hostowanego API kompatybilnego z OpenAI. Text Completion jest dla lokalnych backendów jak KoboldCpp i text-generation-webui, które przyjmują surowy ciąg promptu. Wybranie Text Completion dla hostowanego endpointu czatu powoduje błędy albo zepsute formatowanie.
Który model jest najlepszy do roleplayu w SillyTavern?
Zacznij od deepseek-v4-flash, powszechnego domyślnego wyboru społeczności do długich czatów przy niskim koszcie. Przejdź na deepseek-v4-pro przy złożonych kartach, wypróbuj GLM-5 albo Kimi K2.6 dla innego głosu prozy, a Claude użyj do najwyższej jakości twórczego pisania SFW. Grok pasuje do dojrzałych motywów fikcyjnych zgodnie z opublikowaną polityką xAI.
Czy mój klucz API jest bezpieczny w SillyTavern?
Klucze są przechowywane lokalnie w pliku secrets.json SillyTavern na Twoim komputerze i wysyłane tylko do skonfigurowanego przez Ciebie hosta API. Nie udostępniaj zrzutów ekranu panelu połączenia ani wyeksportowanych plików ustawień, i wymień klucz, jeśli podejrzewasz wyciek.