Klucze OpenRouter ai: Przewodnik szybkiego startu

Bazowy URL & Autoryzacja

Twój klucz API uwierzytelnia każde żądanie do naszego endpointu. Użyj adresu bazowego https://api.openrouteraikeys.com/v1 i przekaż swój klucz w Authorization Nagłówek. To rozwiązanie działa z dowolną biblioteką kompatybilną z OpenAI SDK, ponieważ odzwierciedlamy ich standardowy wzorzec uwierzytelniania. Nie musisz modyfikować biblioteki klienta, tylko konfigurację adresu bazowego.

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

Pierwsze żądanie

Standardowe żądanie chat completion, aby przetestować łączność i format odpowiedzi. ID modelu to uncensored i akceptuje standardowe tablice wiadomości. Ten endpoint zwraca tylko tekst, więc nie oczekuj danych obrazowych ani audio w odpowiedzi.

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

Integracja SDK Python

Zainicjuj klienta, podając klucz oraz niestandardowy adres bazowy. Pozwala to na użycie znanego chat.completions.create metoda bez owijania dodatkową logiką. Biblioteka obsługuje serializację i logikę ponownych prób automatycznie dla Ciebie.

Copyfrom openai import OpenAI

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

Integracja SDK Node

Skonfiguruj OPENAI_API_KEY i OPENAI_BASE_URL zmiennych środowiskowych lub przekaż je bezpośrednio do konstruktora klienta. Zapewnia to, że wszystkie kolejne wywołania są kierowane przez nasz endpoint uncensored. Możesz kontynuować używanie tej samej wersji SDK, którą już masz zainstalowaną.

Copyimport OpenAI from "openai";

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

Włącz strumieniowanie, ustawiając stream: true w Twoim żądaniu. API zwraca cząstki zdarzeń wysyłanych przez serwer (SSE) w miarę generowania tekstu przez model. Statystyki użycia tokenów pojawiają się w ostatniej cząstce strumienia, umożliwiając śledzenie kosztów w czasie rzeczywistym bez czekania na pełną odpowiedź.

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)

Limity, Błędy & Kontekst

Okno kontekstowe obsługuje łącznie 100 000 tokenów dla promptu i uzupełnienia. Limit to 300 żądań na minutę na klucz. Błąd 401 oznacza nieprawidłowy lub brakujący klucz API. Błąd 402 wskazuje na niewystarczające środki na koncie. Błąd 429 oznacza przekroczenie limitu szybkości. Odrzucenia ze względu na politykę treści są darmowe, ale błędy obliczeniowe mogą zużyć tokeny.