FAQ Uncensored API

Podstawy

Czym jest Uncensored API w jednym zdaniu?

To płatny endpoint ukończeń czatu tekstowego obsługujący jeden model o identyfikatorze uncensored, który nie odrzuca prawnej treści dla dorosłych, fikcji ani tematów kontrowersyjnych.

Jaki URL powinienem wywołać?

Użyj https://api.uncensoredapis.com/v1 jako bazowego URL. Zapytania czatowe kieruj na POST /v1/chat/completions, a listę modeli pobieraj na GET /v1/models. Każda inna ścieżka zwróci 404.

Czy muszę uczyć się nowego SDK?

Nie. Struktura zapytań i odpowiedzi odpowiada standardowi ukończeń czatu, więc oficjalne pakiety Python i Node.js działają po zmianie bazowego URL i klucza. Działa też zwykłe curl, jak pokazują dokumentacja.

Czy można przetestować przed płatnością?

Tak. Nowe konto otrzymuje kredyt próbny $0,50 ważny przez 7 dni bez podawania danych do płatności. Zarejestruj się e-mailem i hasłem na stronie kluczy, a klucz pojawi się natychmiast.

Czy mogę wybrać spośród kilku modeli?

Nie. Dostępny jest dokładnie jeden model o identyfikatorze uncensored. Wywołanie endpointu modeli zwraca tylko ten wpis, więc nie ma czego wybierać ani przełączać.

Dla kogo jest usługa?

Dla programistów budujących produkty dla dorosłych, w tym narzędzia do fikcji, aplikacje do odgrywania ról i asystentów badawczych. To Ty odpowiadasz za weryfikację wieku i zasady dotyczące treści w tym, co wdrażasz.

Klucze i dostęp

Ile kluczy otrzymuje konto?

Jeden. Jeśli potrzebujesz nowej wartości, wygeneruj go ponownie w ustawieniach konta; poprzedni klucz przestaje działać w tym samym momencie, więc wdroż replacement natychmiast.

Gdzie powinien znajdować się klucz?

Przechowuj go w zmiennej środowiskowej lub menedżerze sekretów na serwerze, którym kontrolujesz. JavaScript w przeglądarce i binaria mobilne mogą być zinspekcjonowane, więc kieruj ruch klienta przez własny backend, a nie wbudowuj klucza.

Jak przesyłany jest klucz?

W nagłówku Authorization: Bearer przy każdym zapytaniu. Brakująca lub błędna wartość zwróci 401 z obiektem błędu JSON.

Chcę klucz API bez cenzury dla zespołu. Czy możemy go udostępnić?

Możesz, ale każdy proces dzieli ten sam limit 300 zapytań na minutę i to samo saldo. Postaw małą bramkę przed kluczem i daj każdemu koledze dostęp do bramy, a nie do samego klucza.

Limity i ceny

Jak duży może być prompt?

Okno kontekstu wynosi 100 000 tokenów, dzielone przez prompt i completion. Ciało pojedynczego zapytania nie może przekraczać 8 MB. Zapytanie, którego prompt plus max_tokens przekracza okno, zostanie odrzucone kodem 400.

Jak długa może być odpowiedź?

Domyślnie 2048 tokenów. Możesz zwiększyć max_tokens do maksymalnie 32 000 na zapytanie. Gdy odpowiedź zakończy się z powodu limitu, finish_reason zwróci length.

Ile to kosztuje?

Tokeny wejściowe kosztują $0,25 za milion, wyjściowe $1,00 za milion. Saldo jest przedpłacone, nie ma subskrypcji, a saldo nigdy nie wygasa. Zobacz stronę z cenami, aby zobaczyć tabelę.

Czy można podać szybkie oszacowanie?

Załóżmy turę czatu z 1500 tokenami promptu i 300 tokenami completionu, wyłącznie jako ilustrację. To $0,000375 za dane wejściowe plus $0,0003 za wyjście, czyli około $0,000675 na turę, więc $1 wystarcza na około 1480 takich tur.

Co się stanie, gdy wyślę za dużo zapytań?

Każdy klucz może wysyłać 300 zapytań na minutę. Po przekroczeniu tego limitu otrzymasz 429, a właściwą reakcją jest zwolnienie tempa i ponowienie z opóźnieniem.

Pytania integracyjne

Jakie parametry próbkowania mogę ustawić?

Standardowe, takie jak temperature, top_p i stop, są przekazywane do generowania. Ustaw je w ciele żądania dokładnie tak, jak robisz to w innych miejscach.

Czy API zapamiętuje wcześniejsze zwroty rozmowy?

Nie. Każde żądanie jest niezależne, więc za każdym razem wysyłasz całą rozmowę w messages. Odcinaj najstarsze zwroty, gdy całkowita liczba tokenów zbliża się do okna 100 000 tokenów.

Czy mogę przesyłać tokeny strumieniowo do przeglądarki?

Tak, wyślij stream: true i czytaj zdarzenia wysyłane przez serwer (SSE). Zrób to w swoim backendzie i przekaż tekst do strony, aby klucz nigdy nie trafił do klienta.

Czy obsługiwany jest komunikat systemowy?

Tak. Umieść wiadomość z rolą system na początku tablicy, aby ustawić ton, format i granice rozmowy.

Co powinienem sprawdzić jako pierwsze, gdy wyjście wygląda na ucięte?

Sprawdź finish_reason. Wartość length oznacza, że osiągnięto limit, więc zwiększ max_tokens lub skróć prompt. Lista wszystkich wartości znajduje się w referencjach.

Saldo i rozliczenia

Jak doładować środki?

Doładuj swoje saldo przedpłacone z konta. Nie ma subskrypcji, a niewykorzystane środki pozostają dostępne, ponieważ nie wygasają.

Co się stanie, gdy skończy się kredyt próbny?

Kredyt próbny jest ważny przez 7 dni. Po jego wyczerpaniu lub wygaśnięciu żądania zwrócą błąd 402 z kodem no_credit, aż do doładowania salda.

Czy mogę sprawdzić koszt żądania?

Każda odpowiedź zawiera blok usage z liczbą tokenów promptu, uzupełnienia i całkowitą. Pomnóż przez stawki za milion tokenów, aby uzyskać koszt, i prowadź własny rejestr, jeśli chcesz.

Czy nieudane żądania można ponawiać za darmo?

Ponawianie jest dozwolone, ale trzymaj je w ryzach. Użyj krótkiego opóźnienia dla 429 i 503, a nie zapętlaj się przy 400, 401, 402 czy 403, ponieważ te błędy nie naprawią się same. W poradniku błędów znajdziesz gotową politykę.

Treść i zachowanie

Czego model nie zrobi?

Prawnie dozwolona treść dla dorosłych nie jest odrzucana, podobnie jak fikcja czy tematy kontrowersyjne. Wyjątkiem jest każda treść seksualna z udziałem małoletnich, która jest blokowana kodem 403 za każdym razem, również w opowiadaniach i roleplay. Usługa przeznaczona jest dla osób pełnoletnich (18+).

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

Nie. Prompty nie są używane do trenowania.

Jak to się różni od routingu przez agregator?

Agregator przekierowuje Cię do wielu modeli, z których każdy ma własne zasady. Ta usługa to jeden model pod jedną polityką. Przewodnik po uncensored OpenRouter szczegółowo omawia to porównanie.

Czy widzi obrazy lub generuje embeddingi?

Nie. Obsługuje tylko tekst, bez embeddingów, obrazów, audio, wideo ani fine-tuningu.

Rozwiązywanie problemów

Otrzymuję błąd 402 z no_credit. Co teraz?

Twoje saldo jest wyczerpane lub kredyt próbny wygasł. Doładuj saldo przedpłacone i wyślij żądanie ponownie.

Żądanie zwraca błąd upstream_busy (503).

To jest tymczasowe. Poczekaj kilka sekund i spróbuj ponownie, zwiększając opóźnienie i dodając losowość, jeśli uruchamiasz wiele wątków.

Mój strumień się kończy i nie mogę znaleźć liczby tokenów.

Po włączeniu strumieniowania automatycznie dodawany jest końcowy fragment zawierający usage, tuż przed data: [DONE]. Jego lista choices jest pusta, więc sprawdź to przed indeksowaniem.

Czy narzędzia i wywoływanie funkcji działają?

Tak, w standardowym formacie: przekaż tablicę tools i szukaj tool_calls w odpowiedzi.