Klíče OpenRouter ai: Průvodce rychlým startem

Základní URL & Ověření

Váš klíč API autentizuje každý požadavek na náš endpoint. Použijte základní URL https://api.openrouteraikeys.com/v1 a předat klíč v Authorization hlavička. Toto nastavení funguje s jakýmkoli SDK kompatibilním s OpenAI, protože napodobujeme jejich standardní vzor ověřování. Nemusíte upravovat svou klientskou knihovnu, pouze konfiguraci základní URL.

• Hlavička: Authorization: Bearer YOUR_API_KEY
• Základní URL: https://api.openrouteraikeys.com/v1

První požadavek

Standardní požadavek na dokončení chatu pro otestování připojení a formátu odpovědi. ID modelu je uncensored a přijímá standardní pole zpráv. Tento endpoint vrací pouze text, takže neočekávejte v odpovědi data pro obrázky nebo audio.

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"}]
  }'

Integrace Python SDK

Inicializujte klienta pomocí klíče a vlastní základní URL. To vám umožní použít známé chat.completions.create metoda bez obalování další logiky. Knihovna automaticky řeší serializaci a logiku opakování za vás.

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)

Integrace SDK pro Node

Nastavte OPENAI_API_KEY a OPENAI_BASE_URL proměnné prostředí nebo je předáte přímo do konstruktoru klienta. To zajišťuje, že všechny následující volání jsou směrována přes náš endpoint bez omezení obsahu. Můžete pokračovat ve používání stejné verze SDK, kterou již máte nainstalovanou.

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);

Streamované odpovědi

Povolte streamování nastavením stream: true ve vaší žádosti. API vrací bloky Server-Sent Events (SSE), jak model generuje text. Statistiky využití tokenů se zobrazí v posledním bloku streamu, což vám umožňuje sledovat náklady v reálném čase bez čekání na kompletní odpověď.

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, chyby & kontext

Okno kontextu podporuje celkem 100 000 tokenů pro prompt i dokončení. Limitujete se na 300 požadavků za minutu na klíč. Chyba 401 znamená, že váš API klíč je neplatný nebo chybí. Chyba 402 indikuje nedostatek předplaceného kreditu. Chyba 429 signalizuje překročení limitu rychlosti. Zamítnutí kvůli politice obsahu jsou zdarma, ale chyby výpočtu mohou spotřebovat tokeny.