Przewodnik integracji

Szybki start: Twoje pierwsze żądanie

API to API kompatybilne z openai, które odzwierciedla strukturę Chat Completions. Wysyłasz tekst, otrzymujesz tekst. Żadne dodatkowe punkty końcowe do embeddingów lub audio nie zatrudniają Twojego przepływu pracy. Zacznij od wskazania klienta na nasz URL bazowy.

• Bazowy URL: HTTPS://api.filtrosemia.com/v1
• ID modelu: "uncensored"

Zamień istniejący bazowy adres URL w konfiguracji SDK. Punkt końcowy obsługuje wszystko, od roleplay po tłumaczenie, bez zwykłych filtrów.

Copycurl https://api.filtrosemia.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "check balance"}]
  }'

Uwierzytelnianie i nagłówki

Przekazuj swój klucz API w standardowym nagłówku Authorization. Używamy jednego aktywnego klucza na konto dla prostoty. Jeśli potrzebujesz nowego, wygeneruj go ze swojego panelu.

• Nagłówek: Authorization: Bearer YOUR_API_KEY
• Brak przepływów OAuth lub tokenów odświeżania do zarządzania.

Chroń swój klucz. Zapewnia bezpośredni dostęp do Twoich kredytów z góry. Błędy takie jak 401 Unauthorized oznacza, że klucz jest brakuje lub jest nieprawidłowy.

Copyfrom openai import OpenAI

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

Punkt końcowy Uzupełnień Czat

Wyślij wiadomości do POST /v1/chat/completions. Model obsługuje standardowe parametry takie jak temperature, top_p, a także stop sekwencji. Jest to model uncensored dostrojony do treści dla dorosłych i twórczych.

• Obsługuje json_object format odpowiedzi.
• Akceptuje definicje narzędzi do wywoływania funkcji.

Żądania są przetwarzane sekwencyjnie w ramach Twoich limitów szybkości. Upewnij się, że Twój ładunek mieści się w limicie 8 MB.

Copyimport OpenAI from "openai";

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

Odpowiedzi strumieniowe (SSE)

Użyj Wysyłanych Wydarzeń Serwerowych dla dostarczania tokenów w czasie rzeczywistym. To zmniejsza postrzegane opóźnienie dla długich wyjść. Ostatni fragment zawiera kompletne statystyki użycia tokenów.

• Ustaw stream: true w żądaniu.
• Przeanalizuj strumień SSE w swoim kliencie.

Strumieniowanie działa identycznie jak w standardowym SDK OpenAI. Obsługujesz fragmenty danych, gdy tylko się pojawią.

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)

Okno kontekstu i limity

Model obsługuje okno kontekstowe o rozmiarze 100 000 tokenów. Pozwala to na duże obciążenia z długą historią. Maksymalne wyjście to 16 000 tokenów w jednym żądaniu.

• Domyślny maksymalny output: 2 048 tokenów.
• Limit zapytań: 300 zapytań na minutę.

Przekroczenie limitów powoduje 429 Too Many Requests błąd. Dostosuj współbieżność, aby pozostać w granicach. Dozwolone jest 8 żądań równoległych na klucz.

Obsługa błędów i tokeny

Obsłuż standardowe błędy HTTP. 402 Payment Required oznacza, że Twój kredyt prepay został wyczerpany. 429 wskazuje na limitowanie szybkości. 401 sygnalizują problemy z uwierzytelnianiem.

• Błędy są darmowe. Płacisz tylko za pomyślne użycie tokenów.
• Odmowy ze względu na politykę treści są również darmowe.

Sprawdź ciało odpowiedzi pod kątem szczegółowych wiadomości o błędach. Wykorzystaj je do dostosowania logiki ponownych prób lub częstotliwości doładowywania kredytu.