Szybki start: zintegruj w kilka minut

1. Zainstaluj swój SDK

Zacznij od zainstalowania oficjalnej biblioteki dla Twojego języka. Większość programistów preferuje standardowy pakiet, ponieważ odpowiada interfejsowi, który już znają. Uruchom pip install openai dla Python lub npm install openai dla Node.js. Potrzebujesz tylko jednego SDK do obsługi wszystkich żądań.

2. Ustaw swój base URL

Skonfiguruj klienta, aby wskazywał na nasz konkretny endpoint. Musisz nadpisać domyślny bazowy adres URL, aby prawidłowo kierować ruchem. Użyj https://api.unsencoredai.com/v1 jako swój bazowy adres URL. Przekaż swój klucz API w Authorization Nagłówek. To rozwiązanie działa z dowolnym standardowym klientem kompatybilnym z OpenAI.

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

3. Wyślij swoje pierwsze żądanie

Standardowe żądanie chat completion, aby wygenerować tekst. ID modelu to uncensored. Możesz wysyłać prompty systemowe, aby kierować zachowaniem. API zwraca bezpośrednią odpowiedź tekstową. Użyj poniższego polecenia curl do natychmiastowego przetestowania łączności. Sprawdź swoją odpowiedź pod kątem choices tablicę.

Copycurl https://api.unsencoredai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "what is the version number"}]
  }'

4. Obsłuż odpowiedzi strumieniowe

Włącz strumieniowanie dla niższego opóźnienia i wyjścia w czasie rzeczywistym. Ustaw stream: true w Twoim żądaniu. API wysyła chunki za pomocą Server-Sent Events. Możesz przetwarzać każdy token w miarę jego przybywania. Jest to idealne dla interfejsów czatu lub scenariuszy roleplay. Ostatni chunk zawiera statystyki użycia.

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)

5. Konfiguracja parametrów

Dostosuj temperature, top_p, a także stop sekwencji. Kontrolki te wpływają na kreatywność i długość wyjścia. Możesz również użyć response_format dla trybu JSON. Okno kontekstu obsługuje łącznie 100,000 tokenów. Maksymalne wyjście to 16,000 tokenów na żądanie. Dostosuj te ustawienia do konkretnego przypadku użycia.

6. Limity, błędy i kontekst

Obsługuj błędy w sposób elegancki, używając standardowych kodów statusu HTTP. Błąd 401 oznacza, że Twój klucz API jest nieprawidłowy. Błąd 402 oznacza niewystarczający kredyt z góry opłacony. Błąd 429 oznacza, że przekroczyłeś limit 300 żądań na minutę. Twoje okno kontekstowe wynosi 100 000 tokenów. Żądania powyżej 8 MB mogą się nie powieść. Zwroty nie są wydawane za kredyt, ale błędy są darmowe.