OpenRouter api Dokümantasyonu

Hızlı Başlangıç: Python ile Bağlayın

Resmi SDK'yı yükleyin ve base URL'mizi işaretleyin.

API'miz, standart OpenAI arayüzü gibi davranır ancak tek bir uncensored modele yönlendirme yapar. Bu yaklaşım, kodun taşınabilirliğini korurken proxy karmaşıklığını ortadan kaldırır.

• Kütüphaneyi pip aracılığıyla yükleyin.
• API anahtarınızı ortamda ayarlayın.
• Uç noktamız için temel URL'yi tanımlayın.

Copyfrom openai import OpenAI

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

Yer tutucu anahtarı kendi kimlik bilgilerinizle değiştirin. Basit istemler veya karmaşık yapılandırılmış veriler gönderebilirsiniz.

Kimlik Doğrulama ve Anahtarlar

Kontrol panelinde bir anahtar oluşturun ve Authorization başlığında iletin.

Her hesap aynı anda tek bir aktif anahtarı destekler. Yeni bir anahtar oluşturduğunuzda, eski anahtar hemen çalışmayı bırakır. Bu, karmaşık döndürme mantığı gerektirmeden güvenlik yönetimini basitleştirir.

Copycurl https://api.apiopenrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top 5 dependencies for a Go web server"}]
  }'

Yukarıdaki istek Bearer şemasını kullanır. Anahtarınızın şununla başlamasını sağlayın: sk- ve ekstra boşluk içermez.

Sohbet Tamamlamaları Uç Noktası

Şuraya mesaj gönderin /v1/chat/completions standart JSON kullanan uç nokta.

Model user ve assistant roller. Çıktı stilini kontrol etmek için sıcaklık, top-p ve durma dizilerini yapılandırabilirsiniz. Akış etkinleştirildiğinde yanıtlar, son chunk'ta token kullanımını döndürür.

Copyimport OpenAI from "openai";

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

Ayarla max_tokens çıktı uzunluğunu kontrol etmek için. Belirtilmezse varsayılan değer 2.048 token'dir. Model her istek için 16.000 token'e kadar destekler.

Akış Yanıtları

Ayarlayarak akışı etkinleştirin stream: true istemci gövnenizde.

Token kullanım detayları yalnızca akışın son chunk'ında görünür. Bu, gerçek zamanlı UI güncellemelerine izin verirken doğru faturalandırma verisini korur. Akış sırasında oluşan hatalar ücretlendirilen tokenlar için kullanım bildirir.

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)

Kısmi yanıtları zarifçe yönetin. Akış, model oluşturmayı bitirdiğinde veya bağlam sınırına ulaştığında normal şekilde kapanır.

Fonksiyon Çağırma & JSON Modu

Kullan response_format: {type: "json_object"} katı JSON çıktılar için.

Araçları tools dizi ve ayarla tool_choice fonksiyon çağrılarını zorlamak için. Model, programatik işleme için uygun yapılandırılmış veriler döndürür. Bu, uncensored ağırlıklarımızla güvenilir şekilde çalışır.

Copycurl https://api.apiopenrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top 5 dependencies for a Go web server"}]
  }'

Etkileşimli deneyimler için fonksiyon çağırma ile akışı birleştirin. JSON çıktısını uygulama mantığınıza geçirmeden önce doğrulayın.

Limitler ve Kontenjanlar

Kesintılardan kaçınmak için anahtar başı limitlerle kullanımınızı izleyin.

Her anahtar dakikada 300 istek ve 8 eşzamanlı istek yapmanıza olanak tanır. İstek gövdesi boyutu limiti 8 MB'dır. Bu limitleri aşarsanız API 429 durum kodunu döndürür. Kimlik doğrulama hataları 401'i, yetersiz kredi ise 402'yi döndürür.

Copycurl https://api.apiopenrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top 5 dependencies for a Go web server"}]
  }'

Bağlam penceresi toplam 100.000 token'dır. Hatalar krediyi tüketmez. Küçük içerik ihlalleri için reddetmeler de ücretsiz kalır.