OpenRouter kullanıcıları için hızlı başlangıç

Kurulum ve Ayarlar

API'miz standart OpenAI SDK'larıyla tamamen uyumludur. OpenRouter'dan geçiş yapmak için yalnızca base_url ve api_key olmak üzere iki yapılandırma değerini güncellemeniz yeterlidir. İstemcinizi https://api.openrouterapi.cc/v1 adresine yönlendirin ve gösterge panelimizde oluşturulan anahtarı kullanın. Özel başlıklara veya karmaşık yönlendirme mantığına gerek yoktur. İstek verilecek model kimliği uncensored'dir.

SDK sürümünüzün base_url parametresini desteklediğinden emin olun. Ham bir HTTP istemcisi kullanıyorsanız, hedef URL'yi basitçe güncelleyin. Bu kurulum, yalnızca metin tamamlama istekleri gönderiyorsanız mevcut istemci kodunuzun değişiklik yapmadan çalışmasını sağlar.

Kimlik Doğrulama

Kimlik doğrulama standart Authorization başlığı aracılığıyla yapılır. API anahtarınızı Bearer token olarak iletin. Anahtar geçersiz veya süresi dolmuşsa API 401 hatası döndürür. Bazı sağlayıcıların aksine, başarısız istekler için ücret almıyoruz; hatalar ve reddetmeler ücretsizdir, bu nedenle kredinizi tüketmeden kimlik doğrulamasını test edebilirsiniz.

Her hesap aynı anda yalnızca bir aktif anahtar destekler. Yeni bir anahtar oluşturmak öncekini hemen geçersiz kılar. Anahtarınızı güvende tutun ve sızma şüphesi varsa değiştirin. Anahtar kayıt sonrası hemen gösterilir, sayfadan ayrılmadan önce kopyalayın.

Temel Sohbet Tamamlama

Temel işlevsellik POST /v1/chat/completions uç noktasıdır. İsteminizi bir mesaj listesi olarak gönderin ve metin yanıtı alın. Model, yasal yetişkin kullanım için içerik reddi olmadan yanıt verecek şekilde ayarlanmıştır; bu da yaratıcı, tartışmalı veya güvenlik araştırması konuları için uygundur.

model alanını uncensored olarak ayarlayın. Davranışı temperature, top_p ve stop gibi parametrelerle kontrol edebilirsiniz. API, response_format aracılığıyla JSON modunu ve tools aracılığıyla fonksiyon çağırma özelliğini destekler. Tüm istekler asenkron olarak işlenir ve model tamamlandığında tam metni alırsınız.

Akışlı Yanıtlar

İsteğinizde stream: true ayarlayarak akışı etkinleştirin. API kısmi yanıtlarla Sunucu Tarafından Gönderilen Olaylar (SSE) döndürür. Metin parçaları oluşturuldukları anda iletilir, bu da uygulamanızda gerçek zamanlı görüntülemeye olanak tanır.

Token kullanım bilgisi akışın son parçasında sağlanır. Bu, her bireysel token'ı ayrıştırmadan maliyetleri doğru şekilde izlemenizi sağlar. Akış, gecikmenin önemli olduğu sohbet arayüzleri için idealdir. İstemcinizin SSE'yi doğru şekilde işlediğinden ve akış bittiğinde bağlantıyı kapattığından emin olun.

Fonksiyon Çağırma

API, tools parametresi aracılığıyla fonksiyon çağırma desteği sunar. Fonksiyonlarınızı tools dizisinde tanımlayın ve tool_choice değerini auto veya belirli bir fonksiyon adına ayarlayın. Model, bir fonksiyon tetiklendiğinde yapılandırılmış JSON argümanları döndürecektir.

Bu özellik, LLM'i harici API'lere veya veritabanlarına entegre etmek için kullanışlıdır. Fonksiyon tanımlarınızın doğru olduğundan emin olun, çünkü model geçerli argümanlar oluşturmak için onlara güvenir. API fonksiyonları çalıştırmaz; yürütme mantığını uygulama kodunuzda siz yönetmelisiniz.

JSON Modu

Yapılandırılmış çıktılar için response_format: {"type": "json_object"} kullanın. Bu, modelin geçerli JSON döndürmesini zorlar ve bu da aşağı akış uygulamalarında veri ayrıştırma için gereklidir. JSON modu, basit veri çıkarma görevleri için fonksiyon çağırmaya göre genellikle daha güvenilirdir.

İsteminizin modele JSON döndürmesi gerektiğini açıkça belirttiğinden emin olun. Belirsiz istemler geçersiz JSON yanıtlarına neden olabilir. JSON modu hem standart hem de akış modlarında desteklenir. Tahmin edilebilir, makine tarafından okunabilir çıktılara ihtiyaç duyduğunuzda kullanın.

Limitler, Hatalar ve Bağlam

Bağlam penceresi istem ve tamamlama için birlikte 100.000 token'dır. Maksimum çıktı, istek başına 32.000 token'dır (max_tokens ayarlanmamışsa 2.048). Hız limitleri dakikada 300 istek ve anahtar başına 8 eşzamanlı istektir. İstek gövdeleri 8 MB ile sınırlıdır.

Hatalar standart HTTP kodlarını döndürür: geçersiz anahtarlar için 401, yetersiz kredi için 402 ve hız limitleri için 429. Kredi ön ödemelidir, bu nedenle 402 hatası bakiye yüklemeniz gerektiğini gösterir. Hatalar ve reddetmeler ücretsizdir, bu nedenle ek maliyet olmadan yeniden deneyebilirsiniz. Katı içerik sınırı, reşit olmayanlarla ilgili cinsel içeriği engeller.

cURL

Copycurl https://api.openrouterapi.cc/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."}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.openrouterapi.cc/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.js

Copyimport OpenAI from "openai";

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

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)