Szybki start dla użytkowników OpenRouter NSFW

Adres bazowy i uwierzytelnianie

Zamień Base URL obecnego dostawcy na https://api.openrouternsfw.com/v1. Autoryzacja używa standardowego nagłówka Authorization: Bearer <key>. Pobierasz swój klucz natychmiast po zalogowaniu się przez Google lub e-mail na stronie Pobierz klucz API. Nie jest wymagany numer telefonu, a klucz jest wyświetlany tylko raz, więc skopiuj go przed opuszczeniem strony.

Nasza usługa to niezależne API, a nie odsprzedaż modeli innych dostawców. Identyfikator modelu, który wysyłasz w zapytaniach, to uncensored, który działa na naszych własnych serwerach. Jest dostrojony do odpowiadania bez odmów treści dla legalnego użytku dorosłego, ale nie jest to GPT, Claude ani żaden inny nazwany model dostawcy.

Upewnij się, że Twoja biblioteka klienta jest skonfigurowana do używania tego nowego Base URL. Wszystkie zapytania muszą zawierać ważny klucz API w nagłówku. Jeśli klucz jest brakujący lub nieprawidłowy, serwer zwraca błąd 401. Jeśli nie masz przedpłaconego kredytu, otrzymasz błąd 402. Są to standardowe kody statusu HTTP wskazujące na problemy z uwierzytelnianiem lub płatnością, a nie błędy serwera.

Endpoint uzupełnień czatu

Podstawowa funkcjonalność jest dostarczana przez endpoint POST /v1/chat/completions. Ten endpoint przyjmuje ciało JSON zawierające nazwę modelu, tablicę wiadomości i opcjonalne parametry. Zwraca obiekt JSON z wygenerowanym tekstem, statystykami użycia tokenów i powodem zakończenia. Ta struktura jest kompatybilna z oficjalnymi SDK OpenAI i większością bibliotek klienckich kompatybilnych z OpenAI.

Nie musisz pisać własnych klientów HTTP, jeśli wolisz używać SDK. Musisz jednak zaktualizować konfigurację, aby wskazywała na nasz Base URL. Poniższy przykład pokazuje standardowe zapytanie completion za pomocą cURL. To zapytanie wysyła prompt do modelu bez cenzury i oczekuje odpowiedzi tekstowej.

Kopiujcurl https://api.openrouternsfw.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Pamiętaj, że to API obsługuje tylko tekst. Nie ma endpointów do generowania embeddingów, obrazów, audio ani wideo. Jeśli Twoja aplikacja wymaga multimodalnych wejść lub wyjść, będziesz musiał obsłużyć je osobno. Nasza usługa koncentruje się wyłącznie na wysokiej jakości generowaniu tekstu z modelem bez cenzury.

Integracja z Python SDK

Użycie SDK Python upraszcza proces integracji. Zainicjuj klienta poprawnym Base URL i swoim kluczem API. Biblioteka obsługuje za Ciebie żądania HTTP i parsowanie JSON. Możesz określić identyfikator modelu jako uncensored, aby upewnić się, że używasz naszego konkretnego modelu.

Kopiujfrom openai import OpenAI

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

Ten fragment kodu pokazuje, jak wysłać wiadomość i pobrać odpowiedź. Klient automatycznie obsługuje połączenie i raportowanie błędów. Jeśli serwer zwróci błąd, SDK zgłasza wyjątek. Powinieneś obsłużyć te wyjątki w logice swojej aplikacji, aby zapewnić lepsze doświadczenie użytkownika.

SDK Python to tylko jedna z opcji. Możesz użyć dowolnego języka, który obsługuje żądania HTTP. Struktura endpointu pozostaje taka sama niezależnie od wybranego klienta. Ta elastyczność pozwala na integrację modelu bez cenzury w dowolnym istniejącym przepływie pracy bez znaczących zmian w kodzie.

Użycie Node SDK

SDK Node działa podobnie jak wersja Python. Skonfiguruj klienta z Base URL i kluczem API, a następnie wywołaj metodę chat completions. To podejście jest idealne dla aplikacji serwerowych lub usług backendowych, które muszą generować tekst asynchronicznie.

Kopiujimport OpenAI from "openai";

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

Deweloperzy Node.js mogą łatwo zintegrować to API ze swoimi istniejącymi projektami. SDK obsługuje serializację i deserializację danych JSON. Możesz również określić dodatkowe parametry takie jak temperature lub top_p, aby kontrolować losowość wyniku.

Upewnij się, że prawidłowo obsługujesz asynchroniczny charakter zapytań. Użyj async/await lub łańcuchów Promise do zarządzania danymi odpowiedzi. Zapewnia to, że Twoja aplikacja pozostaje responsywna podczas oczekiwania na wygenerowanie tekstu przez model. SDK Node jest niezawodnym wyborem do budowania skalowalnych usług generowania tekstu.

Odpowiedzi strumieniowe

Włącz strumieniowanie, ustawiając parametr stream na true w swoim zapytaniu. Serwer wyśle serię zdarzeń Server-Sent Events (SSE) zamiast pojedynczej odpowiedzi JSON. Każde zdarzenie zawiera częściowy fragment wygenerowanego tekstu.

Kopiujstream = 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)

Strumieniowanie jest przydatne w aplikacjach czasu rzeczywistego, gdzie chcesz wyświetlać wynik w miarę jego generowania. Ostatni fragment strumienia zawiera całkowite użycie tokenów dla zapytania. Pozwala to na dokładne śledzenie kosztów bez oczekiwania na zakończenie całej odpowiedzi.

Obsługuj zdarzenia strumienia ostrożnie, aby zapewnić poprawne złożenie tekstu. Połącz fragmenty w kolejności ich otrzymywania. Serwer gwarantuje, że fragmenty są wysyłane sekwencyjnie. Jeśli połączenie zostanie przerwane, może być konieczne ponowne wysłanie zapytania. Strumieniowanie to potężna funkcja, która poprawia doświadczenie użytkownika w zadaniach generowania tekstu.

Limity zapytań i okno kontekstu

Każdy klucz API jest ograniczony do 300 zapytań na minutę i 8 równoległych zapytań. Rozmiar ciała zapytania jest ograniczony do 8 MB. Jeśli przekroczysz te limity, serwer zwróci kod statusu 429. Jest to standardowy kod statusu HTTP wskazujący, że wysłano zbyt wiele zapytań w danym oknie czasowym. Powinieneś zaimplementować backoff wykładniczy w swoim kliencie, aby obsłużyć te błędy w sposób elegancki.

Okno kontekstu obsługuje do 100,000 tokenów dla połączonego promptu i completion. Nie ma osobnego limitu wyjścia. Jeśli nie określisz parametru max_tokens, odpowiedź może sięgać do końca okna. Możesz ograniczyć długość wyjścia, ustawiając max_tokens na niższą wartość.

Monitoruj swoje użycie tokenów, aby efektywnie zarządzać przedpłaconym kredytem. Błędy i odmowy nie zużywają tokenów, więc nie płacisz za nieudane zapytania. Zapewnia to, że płacisz tylko za udane generowanie tekstu. Śledź swoje limity zapytań, aby uniknąć przerw w usłudze.