Temel URL ve Kimlik Doğrulama
API'miz tamamen OpenAI ile uyumludur; bu da minimum değişiklikle herhangi bir standart SDK'yı kullanabileceğiniz anlamına gelir. Tüm istekler için temel URL https://api.openrouterapi.top/v1 şeklindedir. Kimlik doğrulama, Authorization üst bilgisi iletilen bir Bearer token'ı aracılığıyla sağlanır. Bu anahtarı, panomuzda Google veya e-posta adresiyle giriş yaparak anında oluşturabilirsiniz. Anahtarınızı güvende tutun, çünkü ön ödemeli kredilerinize doğrudan erişim sağlar.
İlk İstek
Uç noktayı basit bir curl komutuyla test edin. YOUR_API_KEY yerine gerçek anahtarınızı yazın. Model ID'si, standart içerik reddetmelerini atlamak için uncensored olarak ayarlanmıştır. Bu istek bir istem gönderir ve tam yanıtı bekler.
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."}]
}'Anahtar geçersizse 401 hatası alırsınız. Ön ödemeli bakiyeniz tükendiğinde 402 hatası alırsınız. Bu hatalar token bakiyenizi tüketmez ancak hız limiti kotalarınıza sayılır.
Python SDK Entegrasyonu
Resmi openai Python paketini kullanmak çok kolaydır. İstemciyi temel URL ve anahtarınızla başlatın. SDK JSON serileştirmesini otomatik olarak halleder. Bu örnek temel bir sohbet tamamlama isteğini gösterir.
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)SDK'nın en son sürümünü kurduğunuzdan emin olun. İstemci nesnesi bağlantı havuzunu yönetir, bu nedenle yeniden başlatmadan birden fazla istek için yeniden kullanabilirsiniz.
Node SDK Entegrasyonu
JavaScript ortamları için Node SDK aynı şekilde çalışır. Özel temel URL'yi başlatma sırasında iletin. Bu yaklaşım, sansürsüz metin üretimini mevcut web uygulamalarına veya arka uç hizmetlerine sorunsuz bir şekilde entegre etmenizi sağlar.
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 hem vaat tabanlı hem de async/await desenlerini destekler. Hata yönetimi diğer OpenAI uyumlu hizmetlerle tutarlıdır.
Akış Yanıtları
İsteğinizde stream: true ayarlayarak akışı etkinleştirin. API Server-Sent Events (SSE) döndürür. Her parça kısmi metin içerir. Son parça faturalandırma için token kullanım istatistiklerini içerir.
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)Ön ödemeli kredi, nihai çıktıda oluşturulan gerçek tokenlara göre ücretlendirilir. Akış, fiyatlandırma modelini değiştirmez; başarıyla iletilen tokenlar için ödeme yaparsınız.
Hız Limitleri ve Bağlam Penceresi
Her API anahtarı dakikada 300 istek ve 8 eşzamanlı istekle sınırlıdır. Maksimum istek gövdesi boyutu 8 MB'tır. Bağlam penceresi toplamda 100.000 tokena kadar destekler (girdi ve çıktı dahil). Her istek için maksimum çıktı 32.000 token veya max_tokens ayarlanmamışsa 2.048 token'dır. 401 veya 402 gibi hatalar krediyi tüketmez ancak hız limitinize sayılır. Belirli içerik türleri için yapılan reddetmeler de ücretsizdir.
