Dokumentacja API dla programistów

Bazowy URL i autoryzacja

Połącz się z naszą infrastrukturą, wskazując klienta na wyznaczony bazowy URL i podając swój unikalny klucz API. Używamy standardowej autoryzacji nagłówkowej, więc możesz wstawić nasz endpoint do istniejących konfiguracji SDK OpenAI bez przepisywania podstawowej logiki. Otrzymujesz jeden aktywny klucz na konto, a wygenerowanie nowego klucza natychmiast unieważnia poprzedni. Ta konstrukcja utrzymuje integrację prostą, jednocześnie zapewniając jasną kontrolę dostępu. Zarejestruj się przez Google lub e-mail, aby natychmiast zobaczyć swój klucz. Nie wymagamy numeru telefonu ani metody płatności do rozpoczęcia.

• URL bazowy: https://api.uncensoreai.com/v1
• Nagłówek Auth: Authorization: Bearer YOUR_API_KEY

Pierwsze żądanie (POST /v1/chat/completions)

Wyślij swoje pierwsze uzupełnienie, wysyłając ładunek JSON do punktu końcowego uzupełnień czatu. ID modelu to uncensored i akceptuje standardowe struktury wiadomości z rolami systemową, użytkownika i asystenta. Otrzymujesz natychmiastowy wynik tekstowy bez skomplikowanego routingu ani logiki wyboru modelu. Błędy nie zużywają Twoich opłaconych kredytów, więc możesz testować swobodnie. Model obsługuje generowanie open-weight dostosowane do treści dla dorosłych bez odmów. Użyj tej struktury, aby rozpocząć integrację.

Integracja SDK Python

Korzystaj z oficjalnego klienta Pythona, aby bezproblemowo komunikować się z naszym API. Ustaw base URL i klucz API w obiekcie konfiguracji przed wykonaniem wywołań. Biblioteka obsługuje za Ciebie serializację JSON i parsowanie odpowiedzi. Możesz bezpośrednio uzyskać dane z użycia z obiektu odpowiedzi. To podejście działa w dowolnym standardowym środowisku Pythona obsługującym żądania asynchroniczne lub synchroniczne. Przechowuj swój klucz bezpiecznie w zmiennych środowiskowych. Przykładowy kod demonstruje podstawowe wywołanie synchroniczne.

Integracja SDK Node.js

Zintegruj się z projektami Node.js, korzystając ze standardnego menedżera pakietów. Zaimportuj klienta i skonfiguruj bazowy adres URL, aby wskazywał na nasze serwery. SDK zarządza żądaniami HTTP i zapewnia typowane odpowiedzi dla użytkowników TypeScript. Możesz łatwo dodać nagłówki lub zmodyfikować limity czasu, jeśli jest to konieczne. Ta metoda pasuje do nowoczesnych aplikacji internetowych i usług backendowych. Upewnij się, że Twoja wersja Node jest zgodna z wymaganiami SDK. Poniższy przykład pokazuje proste żądanie uzupełnienia.

Odpowiedzi strumieniowe i zużycie tokenów

Włącz output w czasie rzeczywistym ustawiając stream flagę na true w swoim żądaniu. API zwraca Server-Sent Events (SSE) w miarę generowania tokenów. Możesz wyświetlać tekst użytkownikom natychmiast, bez czekania na pełną odpowiedź. Szczegóły użycia tokenów pojawiają się w ostatnim kawałku strumienia. Ta funkcja zmniejsza postrzeganą latencję dla długich wyjść. Monitoruj saldo kredytu, gdy akumuluje się liczba tokenów. Strumieniowanie działa ze wszystkimi standardowymi parametrami takimi jak temperatura i sekwencje stop.

Limity, Błędy i Okno Kontekstu

Twoje konto ma okno kontekstowe o pojemności 100 000 tokenów dla promptu i uzupełnienia łącznie. Możesz wysłać do 16 000 tokenów w jednej odpowiedzi, jeśli określisz max_tokens. Domyślny limit wyjściowy to 2,048 tokenów, jeśli pominiesz ten parametr. Limity szybkości pozwalają na 300 żądań na minutę i 8 równoległych żądań na klucz. Status 401 oznacza, że Twój klucz jest nieprawidłowy. Status 402 wskazuje na niewystarczający kredyt z góry. Status 429 oznacza przekroczenie limitu szybkości. Treść żądań nie może przekraczać 8 MB.

cURL

Copycurl https://api.uncensoreai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch the current server status from the api endpoint"}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.uncensoreai.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)

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.uncensoreai.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);

Strumieniowanie

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)