Dokumentacja API

Uwierzytelnianie i URL bazowy

API wymaga jednego klucza API do uwierzytelniania. Otrzymujesz ten klucz natychmiast po zarejestrowaniu się za pomocą Google lub adresu e-mail. Przekaż go w Authorization nagłówek jako token Bearer. Adres URL bazowy to https://api.topuncensored.com/v1. Ten URL działa z dowolnym SDK lub biblioteką kliencką kompatybilną z OpenAI.

• Użyj nagłówka: Authorization: Bearer YOUR_API_KEY
• Skonfiguruj base URL swojego klienta na podany punkt końcowy.

To rozwiązanie zapewnia, że możesz wymieniać biblioteki bez zmiany logiki głównej.

Copycurl https://api.topuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a list of ten distinct UI layout patterns."}]
  }'

Punkt końcowy Uzupełnień Czat

Wyślij prompty tekstowe do /v1/chat/completions endpoint. ID modelu to uncensored. Ten endpoint obsługuje standardowe formatowanie czatu z wiadomościami. Zwraca odpowiedzi tekstowe bezpośrednio. Nie ma dodatkowych warstw ani opakowań. Kontrolujesz okno kontekstu 100,000 tokenów. Żądania poniżej 8 MB działają niezawodnie. Użyj tego do bezpośredniego generowania tekstu.

Zstrukturuj swoje żądanie z promptem systemowym i wiadomością użytkownika. Model odpowiada bez filtrowania prawnych treści dla dorosłych. Błędy takie jak brakujące klucze zwracają 401. Brakuje kredytu? Otrzymujesz błąd 402. To są jasne sygnały.

Odpowiedzi strumieniowe

Włącz strumieniowanie, ustawiając stream: true. Otrzymujesz czaty tekstu w miarę ich generowania. Zmniejsza to postrzeganą latencję dla długich wyjść. Ostatni czat zawiera dane o użyciu tokenów. Użyj tego do wyświetleń w czasie rzeczywistym lub renderowania progresywnego. Jest to wydajne dla aplikacji o dużym ruchu.

Analizuj każdy fragment, aby zbudować ostateczną odpowiedź. Metoda ta gracefulnie obsługuje duże wyjścia. API obsługuje standardowe Server-Sent Events. Jest to zalecane podejście dla aplikacji interaktywnych.

Copyfrom openai import OpenAI

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

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Wywoływanie Narzędzi i Tryb JSON

Używaj wywoływania funkcji do interakcji ustrukturyzowanych. Zdefiniuj narzędzia w swoim żądaniu. Model zwraca ustrukturyzowane argumenty. Ustaw response_format do {"type": "json_object"} dla ścisłego wyjścia JSON. Zapewnia to przewidywalne formaty danych. Połącz te funkcje dla solidnych integracji. Otrzymujesz precyzyjną kontrolę nad strukturą wyjścia.

Wywoływanie narzędzi działa ze standardowym schematem OpenAI. Tryb JSON wymusza poprawny JSON. Użyj tych do integracji API lub ekstrakcji danych. Ta elastyczność wspiera złożone przepływy pracy.

Copyimport OpenAI from "openai";

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

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Parametry i limity

Dostosuj temperature, top_p, a także stop sekwencji. Ustaw max_tokens to 16,000. Default is 2,048 if omitted. Control repetition with presence_penalty i frequency_penalty. Użyj seed do deterministycznych wyników. Te parametry dostrajają jakość generowania. Masz pełną kontrolę nad stylem wyjściowym.

Limity szybkości to 300 żądań na minutę. Żądania współbieżne są ograniczone do 8. Limity te zapewniają stabilną wydajność. Monitoruj swoje zużycie przez panel. Dostosuj parametry, aby zoptymalizować rozwiązanie pod kątem Twojego przypadku użycia.

Błędy i okno kontekstowe

Obsługuj błędy w sposób elegancki. 401 oznacza nieprawidłowy klucz. 402 oznacza niewystarczający kredyt. 429 oznacza limity szybkości. Okno kontekstowe wynosi łącznie 100 000 tokenów. Maksymalna długość wyjścia to 16 000 tokenów. Zarządzaj swoimi tokenami mądrze. Błędy nie zużywają kredytu. Oszczędza to pieniądze podczas debugowania. Użyj ostatniego fragmentu do statystyk użycia.

Śledź zużycie tokenów. Unikaj przekraczania limitów szybkości. Ponów próbę z wykładniczym opóźnieniem. Zapewnia to niezawodną pracę. API jest zaprojektowane pod kątem odporności. Obsługuj błędy jako część normalnego przepływu.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)