SillyTavern

SillyTavern może korzystać ze SpicyAPI na dwa sposoby. Pierwszy to zwykłe połączenie czatu: SillyTavern wysyła twoje wiadomości do modelu czatu SpicyAPI przez źródło Custom (OpenAI-compatible). Drugi to rozszerzenie SpicyAPI, które dodaje polecenia /spicy-img i /spicy-video oraz przycisk Animate, dzięki czemu tworzysz obrazy i krótkie wideo, nie wychodząc z czatu.

Możesz używać każdego z nich osobno. Oba korzystają z tego samego konta, salda i cen co reszta SpicyAPI, a płacisz tylko za to, co uruchomisz. Rozszerzenie jest bezpłatne i ma otwarty kod (MIT): github.com/spicyapi-ai/sillytavern-spicyapi.

Zanim zaczniesz

• SillyTavern 1.19.0 lub nowszy. Kroki na tej stronie sprawdzono w wersji 1.19.0 dnia 2026-10-06. W innych wersjach etykiety w menu mogą być w innych miejscach.
• git na komputerze, na którym działa SillyTavern, ale tylko jeśli chcesz używać rozszerzenia. SillyTavern pobiera nim rozszerzenia.
• Klucz API. Klucze zaczynają się od sk-spicy-. Ograniczenia, które możesz nałożyć na klucz, opisuje Uwierzytelnianie, a jeśli nie masz jeszcze konta, zobacz Przygotuj konto.
• Saldo. Każde żądanie jest opłacane z przedpłaconego salda w USD. Zobacz Rozliczenia.

Połącz czat SillyTavern ze SpicyAPI

Żądanie czatu wysyła serwer SillyTavern, a nie twoja przeglądarka, więc po twojej stronie nie trzeba niczego więcej konfigurować.

Wybierz model czatu

Modele czatu mają identyfikatory kończące się na /chat. Lista Available Models jest wypełniana z pełnej listy modeli SpicyAPI, więc pokazuje też modele obrazu, wideo i dźwięku, które nie potrafią prowadzić czatu. Modele czatu są na początku: wybierz jeden z góry listy albo wpisz lub wklej identyfikator z /chat w polu Enter a Model ID.

Aby zobaczyć wszystkie modele czatu i to, co każdy z nich przyjmuje, przejrzyj modele czatu w serwisie albo wywołaj GET https://api.spicyapi.ai/v1/models ze swoim kluczem (zobacz Katalog modeli i schematy). Każdy wpis czatu zawiera context_length, max_output_tokens i supported_parameters.

Do odgrywania ról ranking roleplay ocenia modele czatu pod kątem spójności postaci i swobody pisania. Część modeli czatu jest bez cenzury, a część filtruje treści; katalog oznacza poziom polityki treści każdego modelu.

Zalecane ustawienia

Ustawienia próbkowania, których wybrany model nie obsługuje, takie jak temperature, top P, frequency penalty i presence penalty, są ignorowane, a nie odrzucane. SpicyAPI wymienia pominięte w nagłówku odpowiedzi X-Spicy-Ignored-Params. Suwaki w SillyTavern możesz zostawić tam, gdzie są.

Wysiłek rozumowania

Lista Reasoning Effort w SillyTavern nie jest wysyłana do modeli SpicyAPI. Jeśli chcesz to ustawić, dodaj to sam, i to tylko dla modelu, którego supported_parameters zawiera reasoning_effort:

1. Kliknij Additional Parameters pod przyciskiem Connect.
2. W Include Body Parameters dodaj jedną linię, na przykład:

reasoning_effort: low

Dozwolone wartości różnią się zależnie od modelu. Poziom, którego model nie oferuje, jest zmieniany na najbliższy, jaki oferuje (wskazuje go nagłówek odpowiedzi X-Spicy-Adjusted-Params), a w modelu bez poziomów rozumowania ta linia jest ignorowana. Najpierw sprawdź wpis modelu na liście modeli. Jeśli odpowiedź wraca pusta albo ucięta, zwiększ Response (tokens) albo obniż wysiłek.

Obrazy na czacie

Gdy Send inline media jest włączone, SillyTavern dołącza obrazy z czatu do każdego kolejnego żądania. Model, który nie czyta obrazów, odrzuca żądanie z błędem 400, a ponieważ obraz zostaje na czacie, każda następna wiadomość też się nie powiedzie. Wyłącz Send inline media dla modeli tylko tekstowych albo ukryj wiadomość z obrazem.

Wideo z czatu nie jest wysyłane do modelu.

Ustawienia, które model odrzuca

Kilka ustawień jest nadal odrzucanych, gdy model ich nie obsługuje, bo zmieniają odpowiedź, a nie tylko ją dostrajają: Multiple swipes per generation powyżej 1 (n), presety Logit Bias i Request token probabilities. Jeśli żądanie kończy się komunikatem wskazującym jedno z nich, wyłącz to ustawienie. Tekst błędu podaje nazwę pola.

Custom Stopping Strings działają w każdym modelu. Model bez sekwencji stop (na przykład modele Grok) je ignoruje, a model, który przyjmuje ich mniej, niż ustawiono, zachowuje pierwsze; nagłówki odpowiedzi X-Spicy-Ignored-Params i X-Spicy-Adjusted-Params mówią, które. Wartość suwaka poza zakresem modelu, na przykład temperature 1.5 w modelu, który kończy się na 1, jest w ten sam sposób obniżana do limitu.

Rozszerzenie SpicyAPI

Rozszerzenie tworzy obrazy i krótkie wideo z poziomu czatu. Zainstaluj je raz, dodaj klucz i wybierz modele.

Polecenia

Nazwane argumenty, które możesz dodać do poleceń:

• model=<id> używa modelu tylko dla tego uruchomienia. Naciśnij Tab po model=, aby zobaczyć listę.
• edit=true otwiera edytor promptu, nawet jeśli prompt wpisano w poleceniu.
• quiet=true zapisuje wynik i zwraca jego ścieżkę, nie wstawiając go na czat, na potrzeby Quick Replies i STscript.
• avatar=true albo avatar=false (tylko obrazy) zastępuje ustawienie „użyj awatara postaci”.

/spicy-img a lighthouse on a cliff at dusk, wide shot
/spicy-video waves rolling onto a beach at sunrise
/spicy-video image=last slow push-in, hair moving in the wind

Menu różdżki obok pola czatu zawiera SpicyAPI picture, SpicyAPI video i SpicyAPI: animate last picture.

Animate

Każdy obraz na czacie ma wśród przycisków ikonę klapsa filmowego, a wiadomości z obrazem mają taką samą ikonę w menu .... Zamienia ona obraz w klip wideo za pomocą twojego modelu wideo z obrazu i dodaje klip do tej samej wiadomości.

Prompty

Jeśli nie podasz promptu, napisze go z bieżącej sceny model czatu, z którym jesteś połączony. Przy włączonej opcji Let me read and edit the prompt before generating (domyślnie) otwiera się okno z modelem, dokładną ceną i promptem w takiej postaci, w jakiej został napisany. Możesz poczekać, wpisać własny albo ponownie nacisnąć Write from the scene. Rozszerzenie nie zawiera żadnych promptów, presetów ani stylów; słowa pochodzą od ciebie albo od twojego modelu czatu.

W modelach, które przyjmują obraz referencyjny, możesz użyć awatara postaci, aby obraz wyglądał jak ta postać.

Pozwól AI pokazywać obrazy

Domyślnie wyłączone. Włącz Let the AI show pictures w panelu SpicyAPI, a potem wybierz, jak model czatu prosi o obraz. Możesz użyć którejkolwiek metody albo obu naraz:

Automatyczne obrazy mają własne limity, oprócz opisanych niżej limitów na uruchomienie:

• najwyżej jeden obraz na kilka odpowiedzi w każdym czacie (domyślnie 3); odrzucone lub nieudane żądanie też uruchamia czas oczekiwania;
• dzienny limit automatycznych obrazów w tej przeglądarce (domyślnie $0.50);
• powyżej kwoty potwierdzenia obowiązuje albo Ask me first (domyślnie, pokazuje opis i cenę), albo Skip the picture.

Automatyczne uruchomienia tworzą wyłącznie obrazy, nigdy wideo, a obrazy są ukryte przed AI jak każdy inny wynik. Dopóki narzędzie jest włączone, jego definicja jest wysyłana z każdym żądaniem czatu, co kosztuje kilka tokenów na Twoim API czatu. Pełny opis działania znajdziesz w README rozszerzenia.

Ceny i limity

Przed każdym uruchomieniem rozszerzenie pobiera od SpicyAPI wycenę i pokazuje ją w dolarach amerykańskich. Wyceny są bezpłatne.

Panel pokazuje też, ile wydała bieżąca sesja przeglądarki. Twardy limit, który działa wszędzie, ustawisz jako dzienny limit wydatków na samym kluczu. Zobacz Uwierzytelnianie.

Uruchomienie trwa dalej w SpicyAPI, jeśli naciśniesz Stop waiting albo zamkniesz stronę, a jeśli się powiedzie, jest płatne. Odbierzesz je później poleceniem /spicy-task <task id>. Nieudane uruchomienia nie są płatne, z wyjątkiem kilku modeli, których strona wskazuje, że odrzucone żądania są rozliczane. Zobacz Rozliczenia.

Gdzie przechowywane są klucz i pliki

• Twój klucz jest przechowywany jawnym tekstem w pliku ustawień SillyTavern na komputerze, na którym działa SillyTavern (data/<user>/settings.json, w extension_settings.spicyapi). Mogą go odczytać inne rozszerzenia SillyTavern. Jeśli używasz Connect chat, klucz jest też zapisywany w pliku sekretów SillyTavern jako klucz endpointu Custom. Dlatego warto założyć osobny klucz z limitem wydatków.
• Wyniki są pobierane i zapisywane w folderze obrazów SillyTavern (data/<user>/user/images/<character>/spicyapi_<task id>.png albo .mp4), a potem dołączane do czatu. Nowe wyniki są domyślnie ukryte przed AI, więc następne żądanie czatu nie wyśle obrazu do modelu, który nie umie go czytać. Włącz Let the AI see generated pictures and videos, aby to zmienić.
• Co opuszcza twój komputer: prompt, ustawienia modelu i każdy obraz referencyjny trafiają do api.spicyapi.ai. Gdy prompt pisze twój model czatu, kontekst czatu trafia do tego API czatu, z którym połączono SillyTavern, tak jak przy każdej innej wiadomości.
• SpicyAPI przechowuje wygenerowane pliki przez ograniczony czas. Zobacz Przechowywanie i usuwanie danych.

Jeśli przełączysz czat, gdy coś się generuje, wynik zostanie zapisany, ale nie dodany do czatu, a rozszerzenie powie ci, gdzie jest.

Trasa połączenia

Domyślnie rozszerzenie łączy się z https://api.spicyapi.ai bezpośrednio z twojej przeglądarki. Jeśli twoja sieć lub przeglądarka to blokuje, otwórz Connection w panelu i wybierz Auto (próbuje bezpośrednio, a potem przechodzi na proxy CORS SillyTavern) albo Through SillyTavern's CORS proxy.

Proxy jest domyślnie wyłączone. Włączysz je, ustawiając enableCorsProxy: true w config.yaml SillyTavern (albo uruchamiając SillyTavern z --corsProxy) i restartując. Nie można go łączyć z podstawowym uwierzytelnianiem SillyTavern (basicAuthMode), które odrzuca żądania niosące klucz API. W takim przypadku użyj trasy bezpośredniej.

Rozwiązywanie problemów

Błędy ze SpicyAPI kończą się request_id albo identyfikatorem zadania. Podaj go wsparciu, a żądanie da się dokładnie odnaleźć. Kody błędów wyjaśnia strona Błędy.