PL ▾
Pobierz klucz API

Konfiguracja API SillyTavern: Jak połączyć się w trybie kompatybilnym z OpenAI

Wyjaśniamy, jak skonfigurować SillyTavern API: URL, klucz, nazwę modelu i okno kontekstu, wraz z poleceniami do weryfikacji.

Data aktualizacji

Kluczowe informacje

  • Wybierz tryb połączenia Chat Completion (kompatybilny z OpenAI)
  • URL to https://api.mukenetsuapi.com/v1, nazwa modelu to uncensored
  • Okno kontekstu do 100 000 tokenów, ale warto je zawęzić ze względu na koszty i prędkość
  • 401 oznacza klucz, 404 oznacza URL, a 429 sugeruje przekroczenie limitu równoległych zapytań lub liczby zapytań.
Ilustracja przedstawiająca połączenie API SillyTavern: maska teatralna połączona błyszczącym kablem z wtyczką serwera

Przygotuj 3 niezbędne elementy

Konfiguracja API SillyTavern jest krótka, a większość problemów wynika z błędnych wartości. Przygotuj najpierw te 3 elementy.

  • Klucz API: wygeneruj go na stronie pobierania klucza API. Po rejestracji otrzymasz jednorazowo $0,50 kredytu próbnego jednym kliknięciem.
  • Base URL: https://api.mukenetsuapi.com/v1
  • Nazwa modelu: uncensored

SillyTavern to interfejs, który pozwala dodać endpoint kompatybilny z OpenAI. Ponieważ to API jest kompatybilne z OpenAI, nie musisz wybierać oficjalnego OpenAI — możesz je zarejestrować jako endpoint niestandardowy.

Instrukcja połączenia

Tekst w menu może się różnić w zależności od wersji. Opisuję tutaj ogólny przebieg. Jeśli się różni, sprawdź również dokumentację SillyTavern.

  1. Otwórz sekcję „API Connections” (ikona wtyczki) w górnej części.
  2. Wybierz typ API „Chat Completion”.
  3. Na liście źródeł wybierz niestandardowe połączenie kompatybilne z OpenAI (Custom).
  4. Wpisz URL endpointu: https://api.mukenetsuapi.com/v1. Nie dodawaj /chat/completions na końcu.
  5. Wklej wydany klucz w polu API Key. Upewnij się, że nie ma spacji na początku ani na końcu.
  6. Ustaw nazwę modelu na uncensored. Jeśli możesz wybrać z listy, wybierz ją; jeśli wpisujesz ręcznie, wpisz dokładnie tak.
  7. Naciśnij przycisk połączenia i sprawdź, czy pojawi się komunikat o sukcesie.

Przed połączeniem warto sprawdzić klucz i URL w terminalu – ułatwi to wyeliminowanie przyczyn błędów.

curl https://api.mukenetsuapi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "uncensored", "messages": [{"role": "user", "content": "こんにちは"}], "max_tokens": 50}'

Jeśli odpowiedź nadejdzie, klucz, URL i nazwa modelu są poprawne. Jeśli SillyTavern nadal zgłasza błąd, podejrzewaj błędy konfiguracji po stronie aplikacji.

Ustal okno kontekstu i długość odpowiedzi

Okno kontekstu tego API obsługuje do 100 000 tokenów łącznie z promptem i odpowiedzią. Nie zalecamy jednak ustawiania maksymalnego rozmiaru kontekstu w SillyTavern. Za każdym razem wysyłasz ponownie konfigurację postaci, świat i historię, więc im większa wartość, tym większy jest rozmiar promptu na zapytanie.

Przykład obliczenia kosztów

Jeśli użyjesz do 16 000 tokenów kontekstu, a odpowiedź będzie miała 300 tokenów, koszt jednej wiadomości wynosi:

  • Wejście: 16 000 ÷ 1 000 000 × $0,15 = $0,0024
  • Wyjście: 300 ÷ 1 000 000 × $0,50 = $0,00015
  • Razem: $0,00255

Za 100 wiadomości koszt to $0,255. Jeśli skrócisz okno kontekstu do 8 000 tokenów, ilość danych wejściowych zmniejszy się około dwukrotnie. Szczegóły cen znajdziesz na stronie z cenami.

Wskazówki

Jeśli nie piszesz długiej opowieści ani scen z wieloma postaciami, realnie jest zacząć od 8 000–16 000 tokenów i zwiększyć tę wartość, gdy poczujesz, że postać zapomniała o wydarzeniach z przeszłości. Maksymalna długość odpowiedzi powinna odpowiadać długości tekstu, jaki chcesz przeczytać jako jedną odpowiedź. max_tokens jest opcjonalne, ale warto ustawić limit po stronie SillyTavern, aby uniknąć zbyt długich odpowiedzi.

Zasady konfiguracji próbkowania

temperature, top_p, stop, seed oraz różne kary są przekazywane do API bez zmian. Możesz je dostosować za pomocą presetów w SillyTavern.

  • Powtarzanie tych samych zwrotów: zwiększ nieco kary za częstotliwość (frequency) i obecność (presence).
  • Rozproszona odpowiedź: zmniejsz temperaturę.
  • Monotonna odpowiedź: zwiększ nieco temperaturę.
  • Chcesz porównać wyniki: ustaw stały seed i zmieniaj wartości po kolei.

Nazwy pól w presetach różnią się w zależności od wersji SillyTavern. Jeśli ustawienia nie są stosowane, sprawdź w dokumentacji SillyTavern, czy używany przez Ciebie sposób podłączenia obsługuje dane pole.

Najczęstsze błędy i sposoby ich rozwiązywania

ObjawyMożliwe przyczynyRozwiązanie
401Nieprawidłowy klucz lub spacje w środkuWklej klucz ponownie i przetestuj go za pomocą curl.
404Nieprawidłowy URLUpewnij się, że URL kończy się na /v1.
Model nie został znalezionyBłędna pisownia nazwy modeluWpisz uncensored małymi literami.
429 (concurrency)Zbyt wiele równoległych zapytańZmniejsz liczbę szybkich kolejnych żądań lub generowania w grupowych czatach.
429(limitowany_przez_limit)Przekroczenie limitu zapytań na minutęPoczekaj chwilę.
429 (z nagłówkiem Retry-After: 5)Tymczasowe przeciążenie serweraPoczekaj 5 sekund i spróbuj ponownie.

Limit pełnego klucza to 8 równoległych zapytań i 300 na minutę, a klucza próbnego to 2 równoległe zapytania i 60 na minutę. Odpowiedź strumieniowa zajmuje 1 slot równoległego połączenia do momentu zakończenia. Uruchomienie czatu grupowego kluczem próbnym szybko wyczerpie dostępne sloty.

Sprawdź, czy masz wystarczające saldo, wpisując poniższe polecenie.

curl https://api.mukenetsuapi.com/v1/balance \
  -H "Authorization: Bearer YOUR_API_KEY"

Saldo możesz odczytać również z nagłówka odpowiedzi X-Balance-USD. Listę modeli uzyskasz za pomocą GET /v1/models.

curl https://api.mukenetsuapi.com/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

Uwagi dotyczące użytkowania

To API obsługuje wyłącznie tekst. Jeśli chcesz korzystać z generowania obrazów lub funkcji audio w SillyTavern, potrzebujesz dodatkowych usług. API jest przeznaczone do tworzenia fikcji, takiej jak powieści, roleplay czy aplikacje towarzyskie, w zakresie legalnego użytku dla dorosłych. Treści seksualne z udziałem nieletnich nie będą generowane, niezależnie od ustawień. Twoja treść nie jest używana do trenowania modelu.

Więcej szczegółów na temat parametrów znajdziesz w dokumentacji. Płatności przyjmujemy w kwotach całkowitych od $20 do $500 za pomocą USDT (TRC20) lub USDC (Base).

Inne przewodniki

Najczęściej zadawane pytania

Jakiej nazwy modelu użyć w SillyTavern?

uncensored. Wpisz ją małymi literami dokładnie tak, jak jest.

Czy na końcu URL trzeba dodać /chat/completions?

Nie. Base URL to /v1, a pozostałą część ścieżki dodaje aplikacja.

Czy wystarczy klucz próbny?

Na sprawdzenie połączenia lub krótką rozmowę wystarczy. Pamiętaj jednak, że klucz próbny jest ograniczony do 2 równoległych zapytań i 60 na minutę oraz ważny tylko 7 dni. Jeśli planujesz używać grupowego czatu, doładuj zwykły klucz.

Czy można generować obrazy?

Nie. To API obsługuje wyłącznie tekst i nie wspiera generowania obrazów, audio ani wideo.

Jaki powinien być rozmiar okna kontekstu?

Maksymalnie 100 000 tokenów, ale realnie warto zacząć od 8 000–16 000. Im większe okno kontekstu, tym większy jest rozmiar promptu na każde zapytanie, co zwiększa koszty.

Klucz API uzyskasz jednym formularzem

Załóż konto, skopiuj klucz i zmień Base URL. To wszystko – konfiguracja jest gotowa.

Uzyskaj klucz API