FAQ API bez cenzury: rejestracja, rozliczenie, endpointy, kody błędów i granice treści

Rejestracja i darmowy kredyt próbny

Jak się zarejestrować? Czy trzeba podać kartę bankową?

Zarejestruj się na stronie /get-api-key/, podając adres e-mail i hasło. Nie musisz przypinać karty. Po pomyślnej rejestracji klucz API jest od razu widoczny na stronie — nie musisz czekać na weryfikację.

Ile kredytu próbnego otrzymuje nowe konto i jak długo jest on ważny?

Nowe konto ma darmowy kredyt próbny $0.50 ważny przez 7 dni. Przy cenie $1.00 za milion tokenów, środki te wystarczą na wygenerowanie około 500 000 tokenów odpowiedzi. To wystarczająco dużo do przetestowania integracji i przeprowadzenia małych walidacji.

Ile kluczy API można mieć na jednym koncie? Co zrobić, jeśli klucz zaginie?

Na jedno konto przypisany jest tylko jeden klucz. Jeśli ulegnie on wyciekowi lub zaginie, możesz go wygenerować ponownie w ustawieniach konta. Stary klucz traci ważność natychmiast, a wszystkie usługi używające starego klucza zaczną zwracać błąd 401, więc po zmianie musisz zaktualizować zmienne środowiskowe.

Co się stanie po wygaśnięciu kredytu próbnego?

Po wygaśnięciu kredytu próbnego żądania zwrócą kod 402 z błędem no_credit. Aby kontynuować pracę, wystarczy doładować konto saldo prepaidowe – kod nie wymaga zmian.

Rozliczenie i saldo

Jaka jest cena i jak naliczane są opłaty?

Rozliczenie jest na podstawie tokenów: wejście $0,25 / mln tokenów, wyjście $1,00 / mln tokenów. Bez subskrypcji ani opłat miesięcznych – płacisz tylko za zużycie. Pełne szczegóły znajdziesz na stronie z cenami.

Czy saldo wygasa?

Nie. Doładowane saldo prepaidowe nie ma terminu ważności. Limit 7 dni dotyczy tylko $0,50 kredytu próbnego dla nowych kont.

Jak sprawdzić koszt jednego żądania?

W każdej odpowiedzi pole usage podaje liczbę tokenów wejściowych i wyjściowych dla tej konkretnej operacji — mnożąc je przez cenę jednostkową, otrzymasz koszt. W ostatnim bloku danych żądania strumieniowego również znajduje się usage; podczas odczytu pamiętaj, że choices w tym bloku jest pustą tablicą.

Jak uniknąć nieoczekiwanie wysokich kosztów?

Kluczowe są dwie rzeczy: ogranicz pojedyncze wyjście za pomocą max_tokens (domyślnie 2048) oraz w wieloetapowych rozmowach obcinaj historię, aby nie rosła niekontrolowanie. Ponieważ korzystasz z prepaid, po wyczerpaniu salda żądania się zatrzymają i nie powstaną rachunki przekraczające Twoje środki.

Ile kosztuje typowe żądanie?

Przykładowo: 2000 tokenów wejściowych i 500 tokenów wyjściowych. Koszt wejścia to ok. $0,0005, wyjścia ok. $0,0005, razem ok. $0,001. Tysiąc takich żądań to około $1. Rzeczywiste kwoty wynikają z pola usage w odpowiedzi.

Co się stanie, gdy saldo się wyczerpie?

Endpoint zwraca kod 402 z kodem błędu no_credit. Po doładowaniu konta możesz kontynuować pracę bez konieczności ponownego wygenerowania klucza API.

Endpointy i parametry

Jaki jest adres endpointu i nazwa modelu?

Base URL to https://api.wuxianzhiapi.com/v1. Nazwa modelu jest stała i wynosi uncensored. Dostępne endpointy to POST /v1/chat/completions oraz GET /v1/models.

Czy jest kompatybilny z SDK OpenAI?

Kompatybilne. Oficjalny Python openai v1+, npm openai v4+. Zmień base_url i klucz. Zobacz kod lub przewodnik migracji.

Jakie jest okno kontekstu i jaki może być maksymalny limit max_tokens?

Okno kontekstu wynosi 100 000 tokenów. Łączna liczba tokenów w promptcie i wyjściu nie może przekroczyć tej wartości. Domyślna wartość max_tokens to 2048, a maksymalna wartość dla pojedynczego żądania to 32 000. Rozmiar ciała żądania nie może przekraczać 8 MB.

Czy obsługuje strumieniowanie i wywoływanie funkcji?

Wszystko jest obsługiwane. Strumieniowanie włącza się przez stream: true; serwer automatycznie dodaje na końcu blok danych z informacjami o użyciu tokenów. Wywoływanie funkcji wykorzystuje tools i tool_choice w formacie OpenAI, a wyniki działania narzędzia są zwracane jako wiadomość z role: "tool".

Dlaczego w ostatnim kawałku strumieniowania nie ma tekstu?

To automatycznie dołączony blok statystyk zużycia: choices to pusta tablica, a w usage są tokeny zużyte w tym zapytaniu. Sprawdź, czy choices nie jest puste przed odczytaniem treści, a unikniesz błędu indeksu spoza zakresu.

Czy są limity zapytań?

Każdy klucz API obsługuje 300 zapytań na minutę. Po przekroczeniu limitu zwracany jest kod 429. Poczekaj i spróbuj ponownie — zalecamy stosowanie wykładniczego backoffu.

Czy obsługuje wektory, obrazy, audio lub fine-tuning?

Nie. Oferujemy wyłącznie konwersację tekstową. Dostępny jest tylko jeden model uncensored. Nie mamy embeddingów ani generowania obrazów, audio, wideo ani możliwości fine-tuningu.

Kody błędów

Wszystkie odpowiedzi z błędem mają format JSON: {"error":{"code":...,"message":...}}. Poniżej wyjaśniamy, jak reagować na każdy kod stanu.

Co oznacza błąd 400?

Błąd w żądaniu: prompt + max_tokens > 100 000 tokenów lub błędny JSON / typ pola. Popraw żądanie; ponowna próba nie pomoże.

Jak zdiagnozować błąd 401?

Klucz jest nieprawidłowy lub go brakuje. Sprawdź nagłówek Authorization: Bearer <klucz>, czy zmienna środowiskowa jest ustawiona i czy klucz nie został wygenerowany ponownie — po regeneracji stary klucz traci ważność natychmiast.

Co oznacza błąd 402 no_credit?

Stan konta jest pusty lub darmowy kredyt próbny wygasł. Po doładowaniu konta usługa zostanie przywrócona, nie musisz zmieniać klucza API.

Co oznacza błąd 403 content_blocked?

Żądanie spowodowało zablokowanie treści. Treści seksualne z udziałem niepełnoletnich są zawsze blokowane, dotyczy to zarówno utworów fikcyjnych, jak i scenariuszy; tego ograniczenia nie można zmienić. Zmień treść żądania i spróbuj ponownie — ponowne wysłanie tego samego żądania da ten sam wynik.

Co oznacza błąd 404?

Odwołano się do nieistniejącego endpointu. Najczęstszą przyczyną jest błędny URL, np. pominięcie ścieżki /v1, lub odwołanie się do nieznanego endpointu, np. embeddings lub generowania obrazów.

Jak obsłużyć błędy 429 i 503?

429 to limit 300 zapytań/min; 503 to upstream_busy (model zajęty). Czekaj kilka sekund. Oba błędy retryj z wykładniczym backoffem (zob. kod).

Granice treści

Czy model bez cenzury generuje absolutnie wszystko?

Nie. Legalne treści dla dorosłych, twórczość fikcyjna i dyskusje na tematy sporne nie są odrzucane. Jednak treści seksualne związane z niepełnoletnimi są zawsze blokowane (kod 403), niezależnie od tego, czy są fikcyjne, czy wynikają z gry w role. Zastosowanie musi być zgodne z prawem.

Dla kogo jest ten produkt?

Usługa jest przeznaczona wyłącznie dla użytkowników powyżej 18. roku życia. Jeśli wykorzystujesz API do tworzenia produktów dla użytkowników końcowych, musisz zaimplementować w swojej aplikacji mechanizm weryfikacji wieku oraz zachować mechanizmy zgłaszania naruszeń i zarządzania kontami.

Czy można używać do roleplay, powieści i gier?

Tak, to najczęstszy sposób użycia. Przykłady promptów dla różnych zastosowań oraz szacunkowy koszt znajdziesz w artykule Scenariusze użycia.

Kiedy w roleplay zwracany jest błąd 403?

Zwracane są tylko wtedy, gdy wystąpi blokada treści. Typowym przykładem są treści seksualne z udziałem niepełnoletnich, w tym scenariusze fabularne. Prawidłowe treści między osobami pełnoletnimi nie zostaną odrzucone tylko dlatego, że są częścią roli. Gdy otrzymasz kod 403, zmień ustawienia fabularne lub fabułę, a następnie wyślij żądanie ponownie.

Czy fakty w odpowiedziach modelu są zawsze wiarygodne?

Nie. Brak odrzucenia treści nie gwarantuje ich poprawności merytorycznej. W sprawach dotyczących faktów, danych, prawa lub medycyny zawsze zweryfikuj informacje samodzielnie przed użyciem.

Prywatność

Czy moje prompty są używane do trenowania modelu?

Nie. Wysyłane przez Ciebie prompty nie są wykorzystywane do trenowania modelu.

Jak bezpiecznie przechowywać klucz API?

Przechowuj klucz w zmiennych środowiskowych po stronie serwera. Nie umieszczaj go w kodzie frontendu, w pakietach aplikacji mobilnych ani w publicznych repozytoriach. Jeśli podejrzewasz wyciek, wygeneruj klucz ponownie w ustawieniach konta — stary klucz traci ważność natychmiast.

Jak postąpić z danymi użytkowników w aplikacji?

Zależy to od Twojego produktu. Zalecamy wysyłanie tylko danych niezbędnych do wykonania zadania. Nie przesyłaj w promptach wrażliwych danych, takich jak imiona, numery dowodów czy dane kontaktowe. Jasno opisz przepływ danych w swojej polityce prywatności.