Podstawowy URL i uwierzytelnianie
Nasz API jest w pełni kompatybilny z OpenAI, co oznacza, że możesz używać dowolnego standardowego SDK po wprowadzeniu minimalnych zmian. Podstawowy URL dla wszystkich zapytań to https://api.openrouterapi.top/v1. Autoryzację zapewnia token Bearer przekazywany w nagłówku Authorization. Możesz wygenerować ten klucz natychmiast, logując się przez Google lub podając adres e-mail w naszym panelu. Chroń swój klucz, ponieważ zapewnia bezpośredni dostęp do przedpłaconego kredytu.
Pierwsze zapytanie
Przetestuj endpoint prostą komendą curl. Zastąp YOUR_API_KEY swoim prawdziwym kluczem. ID modelu ustawiono na uncensored, aby pominąć standardowe odrzucenia treści. Zapytanie wysyła prompt i czeka na pełną odpowiedź.
curl https://api.openrouterapi.top/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."}]
}'Jeśli klucz jest nieprawidłowy, otrzymasz błąd 401. Jeśli saldo przedpłaconego kredytu zostanie wyczerpane, otrzymasz błąd 402. Te błędy nie zużywają Twojego salda tokenów, ale zliczają się do limitu zapytań.
Integracja z Python SDK
Korzystanie z oficjalnego pakietu Pythona openai jest proste. Zainicjuj klienta, podając podstawowy URL i klucz. SDK automatycznie zajmuje się serializacją JSON. Ten przykład pokazuje podstawowe zapytanie o uzupełnienie czatu.
from openai import OpenAI
client = OpenAI(base_url="https://api.openrouterapi.top/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)Upewnij się, że zainstalowałeś najnowszą wersję SDK. Obiekt klienta zarządza pulą połączeń, więc możesz go ponownie używać dla wielu zapytań bez ponownej inicjalizacji.
Integracja z Node SDK
W środowiskach JavaScript Node SDK działa identycznie. Przekaż niestandardowy podstawowy URL podczas inicjalizacji. Pozwala to bezproblemowo zintegrować generowanie bez cenzury z istniejącymi aplikacjami webowymi lub usługami backendowymi.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.openrouterapi.top/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);Node SDK obsługuje zarówno wzorce oparte na promise, jak i async/await. Obsługa błędów jest spójna z innymi usługami kompatybilnymi z OpenAI.
Odpowiedzi strumieniowe
Włącz strumieniowanie, ustawiając stream: true w swoim zapytaniu. API zwraca zdarzenia wysyłane przez serwer (SSE). Każdy fragment zawiera częściowy tekst. Ostatni fragment zawiera statystyki użycia tokenów do rozliczeń.
stream = 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)Przedpłacony kredyt jest naliczany na podstawie rzeczywistej liczby tokenów wygenerowanych w ostatecznej odpowiedzi. Strumieniowanie nie zmienia modelu rozliczeń; płacisz za tokeny, które zostały pomyślnie dostarczone.
Limity zapytań i okno kontekstu
Każdy klucz API jest ograniczony do 300 zapytań na minutę i 8 równoległych zapytań. Maksymalny rozmiar ciała zapytania to 8 MB. Okno kontekstu obsługuje do 100 000 tokenów łącznie (wejście plus wyjście). Maksymalna liczba tokenów wyjściowych na zapytanie to 32 000 lub 2 048, jeśli max_tokens nie jest ustawione. Błędy takie jak 401 lub 402 nie pobierają kredytu, ale zliczają się do limitu zapytań. Odmowy dotyczące konkretnych typów treści są również darmowe.
