PL ▾
Pobierz klucz API

Uncensored Endpoint: Base URL, ID modelu i limity

Endpoint uncensored to hostowany, kompatybilny z OpenAI API tekstowy, który odpowiada bez odmów treści do użytku dorosłego. Na tej stronie znajdziesz dokładny base URL, ID modelu, metody, limity i kody błędów potrzebne przed napisaniem kodu.

Zaktualizowano

Kluczowe punkty

  1. Base URL to https://api.uncensoredendpoint.com/v1, a jedyny ID modelu to uncensored.
  2. Dostępne są dwie metody: POST /v1/chat/completions i GET /v1/models.
  3. Okno kontekstu wynosi 100 000 tokenów, łącznie z promptem i uzupełnieniem.
  4. Pełny klucz pozwala na 8 równoczesnych zapytań i 300 zapytań na minutę.
Izometryczna ilustracja potoku danych łączącego laptop z serwerem API

Ustawienia połączenia na pierwszy rzut oka

Jeśli potrzebujesz tylko wartości, oto one. Reszta tej strony wyjaśnia, jak zachowują się w praktyce.

UstawieniaWartość
Bazowy URLhttps://api.uncensoredendpoint.com/v1
ID modeluuncensored
Nagłówek AuthAuthorization: Bearer YOUR_KEY
EndpointyPOST /v1/chat/completions, GET /v1/models
Okno kontekstu100 000 tokenów, prompt plus completion
Maksymalna treść żądania8 MB
Pełne limity klucza8 równoległych zapytań, 300 zapytań na minutę
Limity klucza próbnego2 równoległe zapytania, 60 zapytań na minutę
Cena$0,15 za 1M tokenów wejściowych, $0,50 za 1M tokenów wyjściowych

Usługa używa tego samego formatu sieciowego co API chat completions OpenAI. Jeśli narzędzie pozwala wpisać własny base URL i klucz API, może z nim rozmawiać. Klucz uzyskasz na stronie klucza API, a dokumentacja zawiera tę samą referencję w krótszej formie.

Co robi każda metoda

Istnieją tylko dwie trasy, co utrzymuje powierzchnię API małą.

  • GET /v1/models zwraca listę modeli. Zobaczysz jeden wpis, uncensored. Wiele klientów wywołuje tę trasę, aby wypełnić listę wyboru modelu, więc jest to też szybki sposób na potwierdzenie poprawności klucza i URL.
  • POST /v1/chat/completions to silnik. Przyjmuje listę wiadomości i zwraca uzupełnienie, albo jako jedną odpowiedź JSON, albo jako strumień zdarzeń wysyłanych przez serwer.

Stara trasa uzupełnień tekstu, trasa odpowiedzi, embeddingi, trasy obrazu i audio nie są częścią produktu. Jeśli biblioteka spróbuje jednej z nich, spodziewaj się błędu i przełącz bibliotekę w tryb czatu.

Szybkie sprawdzenie z terminala:

curl https://api.uncensoredendpoint.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

Lista JSON zawierająca uncensored oznacza, że klucz działa. HTTP 401 oznacza, że klucz jest nieobecny, wpisany błędnie lub zawiera zbędną spację lub znak nowej linii, co jest najczęstszą przyczyną, gdy klucz pochodzi ze zmiennej powłoki.

Twoje pierwsze zapytanie w curlu, Pythonie i Node.js

Wszystkie trzy przykłady wysyłają to samo: jedną wiadomość systemową, jedną wiadomość użytkownika, niską temperaturę. Zastąp YOUR_KEY lub ustaw zmienną środowiskową API_KEY.

curl https://api.uncensoredendpoint.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You are a concise assistant."},
      {"role": "user", "content": "Explain what a context window is in two sentences."}
    ],
    "temperature": 0.7
  }'

Dzięki oficjalnemu SDK Python musisz przekazać tylko dwa dodatkowe argumenty do klienta:

from openai import OpenAI

client = OpenAI(
    base_url="https://api.uncensoredendpoint.com/v1",
    api_key="YOUR_KEY",
)

resp = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You are a concise assistant."},
        {"role": "user", "content": "Explain what a context window is in two sentences."},
    ],
    temperature=0.7,
)
print(resp.choices[0].message.content)
print(resp.usage)

A w Node z tym samym SDK:

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.uncensoredendpoint.com/v1",
  apiKey: process.env.API_KEY,
});

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [
    { role: "system", content: "You are a concise assistant." },
    { role: "user", content: "Explain what a context window is in two sentences." },
  ],
});
console.log(resp.choices[0].message.content);

Odpowiedź zawiera obiekt usage z liczbą tokenów prompt i completion. Zwracaj na to uwagę: te dwie liczby są podstawą do rozliczeń. Nagłówki odpowiedzi zawierają również X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests i X-RateLimit-Limit-Concurrency. Loguj ID zapytania przy każdym wywołaniu, ponieważ jest to pierwsza rzecz, o którą poprosi wsparcie, jeśli coś będzie nie tak.

Strumieniowanie, wywoływanie funkcji i tryb JSON

Trzy funkcje pokrywają większość rzeczywistych zastosowań, a wszystkie trzy podążają za strukturą API OpenAI, którą już znasz.

Strumieniowanie

Ustaw stream: true i czytaj zdarzenia wysłane przez serwer. Wykorzystanie jest raportowane na końcu strumienia, więc możesz nadal liczyć tokeny bez drugiego zapytania. Jedna rzecz ma znaczenie dla planowania pojemności: zapytanie strumieniowe zajmuje swój slot współbieżności do zakończenia strumienia. Wolny klient, który czyta długą odpowiedź kroplami, trzyma slot zajęty przez cały czas.

stream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Write a four-line poem about rain."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Wywoływanie funkcji

Przekazuj tools i opcjonalnie tool_choice. Gdy model zdecyduje się wywołać funkcję, otrzymasz tool_calls w odpowiedzi (również w strumieniu, jeśli strumieniujesz). Wywołujesz funkcję samodzielnie i wysyłasz wynik z powrotem jako wiadomość z role: "tool". Model to pojedynczy model o otwartych wagach, więc przetestuj schematy narzędzi z kilkoma realistycznymi promptami i trzymaj opisy parametrów krótkie i dosłowne.

Tryb JSON

Wyślij response_format: {"type":"json_object"}, aby poprosić o poprawny wynik JSON. Powiedz też w promptie, że chcesz JSON i opisz oczekiwane pola. Parsuj defensywnie i spróbuj ponownie raz przy błędzie parsowania, zamiast ślepo ufać wynikowi.

Kontrolki próbkowania są przekazywane: temperature, top_p, stop, seed oraz kary częstotliwości i obecności.

Okno 100 000 tokenów w praktyce

Okno kontekstu wynosi 100 000 tokenów, a ta liczba obejmuje razem prompt i completion. Completion może użyć tego, co pozostawi prompt, a max_tokens jest opcjonalne. Jeśli wyślesz 90 000 tokenów promptu, na odpowiedź pozostaje co najwyżej około 10 000 tokenów.

Gruba zasada dla tekstu angielskiego mówi, że jeden token to nieco mniej niż jedno słowo, więc 100 000 tokenów to około 70 000 słów. To wystarczy na długi rozdział rękopisu, dużą część bazy kodu lub kilka godzin historii czatu. Trzy nawyki utrzymują to przydatnym:

  • Celowo przycinaj historię. Klienci czatu wysyłają całą rozmowę przy każdej turze, więc koszt i opóźnienie rosną wraz z nią. Zatrzymaj prompt systemowy, podsumowanie starych tur i ostatnią garść wiadomości.
  • Ustaw max_tokens, gdy liczy się rozmiar wyjścia. Jest opcjonalne, ale limit chroni Cię przed niekontrolowaną odpowiedzią przy długim promptie.
  • Pamiętaj o limicie rozmiaru treści żądania (8 MB). Jest oddzielny od okna tokenów. Zwykły tekst rzadko osiąga 8 MB, ale bloby base64 wklejone do promptu mogą.

Ponieważ rozliczanie jest za token, pełne zapytanie okna kosztuje prawdziwe pieniądze w porównaniu do krótkiego. Na stronie cenowej znajdziesz stawki, a każde zapytanie możesz obliczyć jako tokeny wejściowe razy $0,15 plus tokeny wyjściowe razy $0,50, każde podzielone przez milion.

Limity zapytań i rodzina 429

Pełny klucz pozwala na 8 zapytań jednocześnie i 300 zapytań na minutę. Klucz próbny jest ściślejszy: 2 jednocześnie i 60 na minutę. Gdy przekroczysz linię, API odpowiada HTTP 429, a kod błędu mówi, którą linię:

Kod błęduZnaczenieCo zrobić
rate_limitedZbyt wiele zapytań na minutęZwolnij; rozłóż wywołania w ciągu minuty
concurrencyZbyt wiele zapytań wysłanych jednocześnieKolejka po Twojej stronie; ogranicz równoległe wątki do 8 (2 w wersji próbnej)
429 z Retry-After: 5Tymczasowe przeciążeniePoczekaj 5 sekund, a następnie ponów próbę

Najprostszą obroną jest semafor w Twoim kodzie, rozmiarowany do Twojego klucza. W Pythonie z asyncio, asyncio.Semaphore(8) wokół każdego wywołania usuwa błąd concurrency całkowicie. Dodaj retry, który respektuje nagłówek Retry-After i przechodzi do krótkiego opóźnienia wykładniczego, gdy nagłówek jest nieobecny. Pamiętaj, że strumienie zajmują miejsce przez całą długość, więc partia ośmiu długich strumieni zablokuje dziewiąte zapytanie, nawet jeśli liczba na minutę jest niska.

Nieudane lub odrzucone zapytania nie są rozliczane, więc pętla retry nie kosztuje Cię za odrzucone próby.

Czym jest model, a czym nie jest

Usługa uruchamia jeden model o otwartych wagach, hostowany przez niezależnego dostawcę i dostrojony do odpowiadania bez odmów treści dla prawnego użytku przez osoby dorosłe. Nie jest to oficjalne API żadnego dużego dostawcy i nie jest routerem, który wybiera między dostawcami. Istnieje jeden model, uncensored, więc nie ma czego wybierać ani porównywać cen.

Limity są jasne. Tekst wchodzi i tekst wychodzi. Nie ma generowania obrazów, dźwięku ani wideo, nie ma embeddingów ani dostrajania. Jedną stałą regułą dotyczącą treści jest to, że treści seksualne z udziałem nieletnich nigdy nie są dozwolone. Prompty nie są używane do trenowania.

To ramowanie pomaga, gdy planujesz projekt. Narzędzia fikcji i roleplay dla dorosłych, aplikacje towarzyskie, badania nad zachowaniem modelu i narzędzia obsługujące ostre lub wrażliwe teksty bez cofania się modelu to naturalne dopasowania. Jeśli potrzebujesz embeddingów do wyszukiwania, będziesz potrzebować oddzielnego dostawcy do tej części i nadal możesz używać tego endpointu do generowania.

Przejście do produkcji

Działająca demonstracja to pięć minut pracy. Niezawodna usługa zajmuje nieco więcej. Zacznij od wersji próbnej: nowi użytkownicy mogą odebrać $0.50 kredytu jednym kliknięciem na stronie klucza po rejestracji, raz na osobę, ważny przez 7 dni i bez konieczności płatności. Rejestracja działa z Google lub z e-mailem i hasłem. To wystarczy na setki krótkich wywołań testowych, aby sprawdzić swoją integrację.

Gdy przejdziesz do prawdziwego ruchu, doładuj dowolną kwotą całkowitą od $20 do $500. Płatność jest kryptowalutą (USDT na TRC20, USDC na Base). Kredyt nie wygasa i nie ma subskrypcji, więc saldo po prostu czeka, aż je wydasz. Bonus to 5% od $50, 10% od $100 i 15% od $200.

Następnie przejdź przez krótką listę: przechowuj klucz w zmiennej środowiskowej lub menedżerze sekretów, nigdy w kodzie po stronie klienta; loguj X-Request-Id; obserwuj X-Balance-USD, aby ostrzec przed wyczerpaniem się salda; ogranicz równoległych workerów; i obsługuj 429 z opóźnieniem, a nie ścisłą pętlą. checklista produkcyjna dla kluczy API przechodzi przez obsługę kluczy w większym detalu, a dokumentacja zawiera referencję parametrów.

Pytania i odpowiedzi

Czy potrzebuję specjalnego SDK?

Nie. Działa dowolny SDK lub klient OpenAI. Zmień base URL i klucz, ustaw model na uncensored, a reszta kodu pozostaje bez zmian.

Czy potrafi generować obrazy lub embeddingi?

Nie. API obsługuje tylko tekst. Nie ma generowania obrazów, audio ani wideo, nie ma embeddingów ani fine-tuningu.

Co się stanie, gdy osiągnę limit zapytań?

Otrzymasz HTTP 429. Kod błędu to rate_limited, gdy przekroczysz limit zapytań na minutę lub limit concurrency przy zbyt dużej liczbie równoległych zapytań. Poczekaj chwilę i spróbuj ponownie.

Czy istnieją sztywne ograniczenia treści?

Tak. Treści seksualne z udziałem nieletnich są zawsze zabronione. Wszystko inne model odpowiada bez odmów, do użytku prawnego przez osoby dorosłe.

Twój klucz jest o jeden formularz stąd

Utwórz konto, skopiuj klucz, zmień bazowy URL. To cała konfiguracja.

Pobierz klucz APIPrzeczytaj dokumentację