OpenRouter ai anahtarları: Hızlı Başlangıç Kılavuzu

Temel URL & Kimlik Doğrulama

API anahtarınız uç noktamıza yapılan her isteği doğrular. Temel URL'yi https://api.openrouteraikeys.com/v1 ve anahtarınızı Authorization header. Bu yapılandırma, standart kimlik doğrulama kalıplarını yansıttığımız için herhangi bir OpenAI-uyumlu SDK ile çalışır. İstemci kütüphanenizi değiştirmenize gerek yoktur, yalnızca temel URL yapılandırmasını yapmanız yeterlidir.

• Başlık: Authorization: Bearer YOUR_API_KEY
• Temel URL: https://api.openrouteraikeys.com/v1

İlk İstek

Bağlantıyı ve yanıt formatını test etmek için standart bir chat completion isteği gönderin. Model kimliği uncensored ve standart mesaj dizilerini kabul eder. Bu uç nokta yalnızca metin döndürür, bu nedenle yanıt yükünde görsel veya ses verisi beklemeyin.

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

Python SDK Entegrasyonu

İstemciyi anahtarınız ve özel temel URL ile başlatın. Bu, size tanıdık chat.completions.create ek mantık sarmalamadan yöntem. Kütüphane otomatik olarak seri hale getirme ve yeniden deneme mantığını yönetir.

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)

Node SDK Entegrasyonu

Yapılandırın OPENAI_API_KEY ve OPENAI_BASE_URL ortam değişkenleri veya bunları istemci kurucusuna doğrudan geçirin. Bu, sonraki tüm çağrıların sansürsüz endpoint'imiz üzerinden yönlendirilmesini sağlar. Zaten yüklü olan aynı SDK sürümünü kullanmaya devam edebilirsiniz.

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

Akış Yanıtları

Ayarlayarak akışı etkinleştirin stream: true istekinizde. API, model metin oluştururken Sunucu Tarafından Gönderilen Etkinlikler (SSE) parçalarını döndürür. Token kullanım istatistikleri, tam yanıtı beklemeksizin maliyetleri gerçek zamanlı olarak izlemenizi sağlayan akışın son parçasında görünür.

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)

Limitler, Hatalar & Bağlam

Bağlam penceresi, istem ve tamamlama için toplamda 100.000 jetonu destekler. Anahtar başına dakikada 300 istekle sınırlısınız. 401 hatası, API anahtarınızın geçersiz veya eksik olduğunu gösterir. 402 hatası, yetersiz ön ödemeli kredi olduğunu belirtir. 429 hatası, hız sınırını aştığınızı işaret eder. İçerik politikası nedeniyle reddedilenler ücretsizdir, ancak hesaplamalı hatalar token tüketebilir.