OpenRouter entegrasyonu: tek anahtarla çok model, maliyet ve veri ayarları rehberi
OpenRouter entegrasyonu, ürün başlığı, açıklama, kategori önerisi ve satış analizleri gibi yapay zekâ işlerini tek bir OpenRouter API anahtarıyla, dilediğiniz sağlayıcının modelinde çalıştırmanızı sağlar. OpenRouter bir model değil; Anthropic, OpenAI, Google, DeepSeek, Mistral gibi şirketlerin modellerine giden istekleri tek hesaptan yönlendiren ve tek bakiyeden faturalayan bir aracı katmandır. Bu rehber, Ekim 2026 itibarıyla OpenRouter'ın resmî dokümanları, fiyat sayfası ve model listesiyle model seçimini, kredi ücretini, ücretsiz model sınırlarını ve veri saklama ayarlarını satıcı gözünden anlatır.
OpenRouter nedir, e-ticaret satıcısı için hangi sorunu çözer?
OpenRouter, New York merkezli OpenRouter, Inc. tarafından işletilen ve yüzlerce dil modeline tek bir API uç noktasından erişim veren bir yönlendirme platformudur. Fiyat sayfasına göre ücretli planlarda 500'ü aşkın model ve 80'i aşkın sağlayıcı bulunur. API, OpenAI'ın sohbet tamamlama biçimiyle uyumludur; yani OpenAI için yazılmış bir yazılım, adresi ve anahtarı değiştirilerek OpenRouter'a bağlanabilir.
Satıcı açısından OpenRouter'ın değeri üç noktada toplanır:
- Tek hesap, tek bakiye: Claude, GPT, Gemini, DeepSeek ya da Mistral modellerini denemek için her şirkette ayrı hesap, ayrı kart ve ayrı fatura yönetmezsiniz.
- Model değiştirmek kolaydır: Aynı iş için daha ucuz ya da güçlü bir modele geçmek, model kimliğini değiştirmekten ibarettir.
- Yedek sağlayıcı: Bir sağlayıcı hata döndürürse OpenRouter isteği aynı modeli sunan bir sonraki sağlayıcıya otomatik aktarır; başarısız ya da yedeğe düşen denemeler için model ücreti alınmaz.
OpenRouter ile doğrudan sağlayıcı API'si arasındaki fark
Doğrudan bir sağlayıcıyla çalıştığınızda oran sınırınızı, faturanızı ve veri sözleşmenizi o şirketle kurarsınız. OpenRouter'da model fiyatına kâr payı eklenmez, ancak kredi alırken platform ücreti ödenir ve isteğin hangi sunucuda işleneceği yönlendirme kurallarına bağlıdır. Tek modelde karar kıldıysanız Claude entegrasyonu gibi doğrudan bağlantı daha sadedir; modelleri karşılaştırmak ya da maliyeti işe göre bölmek istiyorsanız OpenRouter esneklik sağlar.
OpenRouter'daki güncel modeller: hangi satıcı işi için hangisi?
OpenRouter'daki model seçimi, hız, maliyet ve metin kalitesi arasında yapılan bir tercihtir; aşağıdaki tablo 13 Ekim 2026'da OpenRouter model API'sinde listelenen fiyatlardır. Fiyatlar 1 milyon token başına ABD doları cinsindendir ve modelin en uygun uç noktasına göre gösterilir. Fiyatlar sık değişir; karar vermeden önce openrouter.ai/models sayfasından güncel değeri kontrol edin.
| Model (şirket) | OpenRouter kimliği | Girdi $/1M | Çıktı $/1M | Model kartındaki konumu → satıcı işi |
|---|---|---|---|---|
| Claude Sonnet 5.5 (Anthropic) | anthropic/claude-sonnet-5.5 | 2,00 | 10,00 | Günlük işler için Sonnet sınıfı → uzun açıklama, iade ve kâr yorumu |
| Claude Haiku 5.5 (Anthropic) | anthropic/claude-haiku-5.5 | 0,10 | 0,50 | Yüksek hacimli, maliyete duyarlı işler → toplu başlık, kategori önerisi |
| GPT-6.1 Sol (OpenAI) | openai/gpt-6.1-sol | 2,00 | 10,00 | Serinin Astra'nın altındaki modeli → fiyat ve rekabet analizi |
| GPT-6 Luna (OpenAI) | openai/gpt-6-luna | 0,10 | 0,50 | Serinin hızlı, düşük maliyetli modeli → sınıflandırma, kısa metin |
| Gemini 3.8 Flash (Google) | google/gemini-3.8-flash | 0,75 | 3,75 | Flash serisinin en yeteneklisi → çok adımlı analiz, görsel girdili işler |
| DeepSeek V4.1 Flash (DeepSeek) | deepseek/deepseek-v4.1-flash | 0,044 | 0,62 | Düşük fiyatlı → deneme ve özet işleri (sağlayıcıya göre fiyat değişir) |
| Mistral Small 4 (Mistral AI) | mistralai/mistral-small-2603 | 0,15 | 0,60 | Mistral AI (Fransa) modeli → kısa metin, sınıflandırma |
| Gemma 4 31B (Google) | google/gemma-4-31b-it:free | 0 | 0 | Ücretsiz sürüm → yalnız deneme, günlük istek sınırlı |
Aynı model, farklı sağlayıcı: fiyat ve kalite neden değişir?
OpenRouter'da bir model birden fazla sağlayıcıda çalışabilir. Örneğin DeepSeek V4.1 Flash, Ekim 2026'da 30'u aşkın uç noktada sunuluyordu; girdi fiyatı 0,044 $ ile 0,60 $ arasında değişiyor, bazı uçlar modeli fp4 ya da fp8 gibi sıkıştırılmış biçimde çalıştırıyordu. Sıkıştırma maliyeti düşürür ama Türkçe metin kalitesini etkileyebilir. Varsayılan yönlendirme son 30 saniyede kesinti yaşamamış sağlayıcıları öne alıp fiyatı düşük olanları ağırlıklandırır; aynı model kimliğiyle gelen yanıtlar farklı sunuculardan dönebilir. Bu yüzden ürün metinlerinde ~anthropic/claude-sonnet-latest gibi takma adlar yerine sabit sürümlü model kimliği kullanın.
OpenRouter ücretlendirmesi: kredi, platform ücreti ve planlar
OpenRouter'da ödeme ön yüklemeli kredi sistemiyle yapılır: hesabınıza dolar cinsinden kredi yüklersiniz, her istekte token ücreti bu bakiyeden düşer. Resmî SSS'ye göre sağlayıcı fiyatına kâr payı eklenmez; OpenRouter gelirini kredi alımındaki ücretten elde eder. Kartla alımda ücret %5,5'tir ve en az 0,80 $ olarak uygulanır; kriptoyla %5'tir. Kart, AliPay ve USDC kabul edilir; otomatik yükleme de kurulabilir.
| Plan | Platform ücreti | Model / sağlayıcı | Oran sınırı | Satıcı için anlamı |
|---|---|---|---|---|
| Free | Yok | 25+ ücretsiz model, 4 ücretsiz sağlayıcı | Günde 50 istek | Yalnız deneme; bütçe kontrolü ve veri politikasına göre yönlendirme yok |
| Standard (kullandıkça öde) | %5,5 (kart), %5 (kripto) | 500+ model, 80+ sağlayıcı | Sağlayıcının sınırı geçerli | Çoğu satıcı için yeterli; harcama limitleri ve veri politikası yönlendirmesi var |
| Business (kullandıkça öde) | %8 | 500+ model, 80+ sağlayıcı | Sağlayıcının sınırı geçerli | AB ya da ABD içinde işleme (eu.openrouter.ai) gerekiyorsa |
| Enterprise | İndirim görüşülebilir | 500+ model, 80+ sağlayıcı | Daha yüksek sınır | SSO, sözleşmeli hizmet seviyesi, IP izin listesi, faturalı ödeme |
Küçük yüklemelerde platform ücretinin gerçek etkisi
En az 0,80 $ kuralı küçük yüklemeleri pahalılaştırır: 10 $ yüklediğinizde %5,5 yerine 0,80 $, yani fiilen %8 ücret ödersiniz. Oran ancak yaklaşık 14,55 $ ve üzerindeki yüklemelerde %5,5'e iner. Kullanılmayan kredinin iadesi yalnız alımdan sonraki 24 saat içinde Credits sayfasından istenebilir; platform ücreti iade edilmez, kripto ödemeler hiç iade edilmez. OpenRouter kullanım şartlarında kullanılmayan kredileri satın alımdan bir yıl sonra geçersiz sayma hakkını saklı tutar.
OpenRouter'daki BYOK ile Yox'taki kendi anahtar farkı
OpenRouter'ın BYOK özelliği, Anthropic ya da OpenAI gibi sağlayıcıların anahtarlarını OpenRouter hesabınıza eklemenizdir; Standard planda ayda 25.000 $ liste fiyatına kadar ücretsizdir, sonrasında %5 ücret kredinizden düşer. Yox İş Ortağım'daki kendi anahtar ise OpenRouter API anahtarınızı panele bağlamanızdır; çoğu satıcı için yalnız bu yeterlidir.
1.000 ürün açıklaması OpenRouter'da kaç dolar tutar? Örnek hesap
OpenRouter maliyeti, girdi ve çıktı token'larının ayrı fiyatlarla çarpılmasıyla hesaplanır; aşağıdaki tablo ölçüm değil, örnek bir varsayımdır. Varsayım: talimat ve ürün kartı alanları yaklaşık 700 girdi token'ı, yaklaşık 300 kelimelik Türkçe açıklama yaklaşık 600 çıktı token'ı tutar. Türkçe metinler eklemeli yapısı nedeniyle genellikle daha fazla token'a bölünür; ilk 20 öneriyi deneyip Activity sayfasındaki gerçek token sayısıyla karşılaştırın.
| Model | Girdi (0,7M token) | Çıktı (0,6M token) | 1.000 ürün toplamı (örnek) |
|---|---|---|---|
| Claude Sonnet 5.5 | 1,40 $ | 6,00 $ | ≈ 7,40 $ |
| GPT-6.1 Sol | 1,40 $ | 6,00 $ | ≈ 7,40 $ |
| Gemini 3.8 Flash | 0,53 $ | 2,25 $ | ≈ 2,78 $ (düşünme token'ı hariç) |
| DeepSeek V4.1 Flash (listedeki en düşük uç fiyatı) | 0,03 $ | 0,37 $ | ≈ 0,40 $ |
| Claude Haiku 5.5 | 0,07 $ | 0,30 $ | ≈ 0,37 $ |
| GPT-6 Luna | 0,07 $ | 0,30 $ | ≈ 0,37 $ |
| Gemma 4 31B (ücretsiz) | 0 $ | 0 $ | 0 $, ancak günlük istek sınırına takılır |
Hesapta gözden kaçan üç kalem vardır:
- Düşünme (reasoning) token'ları: Bazı modeller yanıt öncesi iç akıl yürütme yapar ve bu token'lar çıktı fiyatından faturalanır; aynı açıklama beklenenden pahalıya gelebilir.
- Platform ücreti: Yukarıdaki tutarlara kredi alımındaki %5,5 (en az 0,80 $) eklenir.
- Yeniden deneme: Beğenilmeyip yeniden üretilen her öneri yeni istektir; 1.000 ürün için 1.300 istek planlayın.
OpenRouter API anahtarı nasıl alınır, harcama sınırı nasıl konur?
OpenRouter API anahtarı, hesabınızın Keys sayfasından birkaç dakikada oluşturulur ve anahtara ayrı bir kredi limiti tanımlanabilir. Adımlar şöyledir:
- openrouter.ai adresinde hesap açın; ekip kullanımında organizasyon hesabı tercih edin.
- Settings > Credits sayfasından kredi yükleyin; küçük yüklemelerde en az 0,80 $ platform ücreti uygulandığını hesaba katın.
- Settings > Privacy sayfasında eğitim izni ve sıfır veri saklama (ZDR) tercihlerinizi anahtarı kullanmaya başlamadan önce belirleyin.
- Keys sayfasında yeni anahtar oluşturun, anlaşılır bir ad verin (ör. Yox İş Ortağım) ve kredi limiti seçin; limit günlük, haftalık ya da aylık sıfırlanabilir.
- Anahtarı güvenli bir yerde saklayın; e-posta ya da mesajla açık metin olarak paylaşmayın, doğrudan panele kendiniz girin.
Anahtar güvenliği: limit, süre ve sızıntı
OpenRouter dokümanı, limitsiz bir anahtar sızarsa otomatik yüklemeler dahil bütün bakiyenin harcanabileceği uyarısını yapar. Security sayfası limiti ya da süresi olmayan ve 90 gündür kullanılmayan anahtarları ayrıca listeler. OpenRouter, GitHub'ın gizli anahtar tarama ortaklarındandır ve açığa çıkan anahtarı e-postayla bildirir; bu durumda anahtarı silip yenisini oluşturun.
Oran sınırları ve sık görülen hata kodları
Ücretli planlarda oran sınırı fiyat sayfasına göre sağlayıcıdan aktarılır; makul kullanımı çok aşan trafik ise Cloudflare tarafından engellenir. Panelde bir öneri gelmediğinde bakılacak kodlar şunlardır:
- 402 Payment Required: Bakiye ya da anahtarın kredi limiti bitmiştir; ücretsiz modeller dahil istekler reddedilir.
- 429 Too Many Requests: OpenRouter ya da sağlayıcı oran sınırı aşılmıştır; kısa bir bekleme sonrası yeniden denenir.
- 503 Service Unavailable: Gizlilik ve sağlayıcı tercihlerinize uyan bir sağlayıcı bulunamamıştır; ayarlar fazla dar olabilir.
OpenRouter ücretsiz modelleri ürün içeriği için yeterli mi?
OpenRouter'daki ücretsiz modeller deneme için uygundur, ancak düzenli ürün içeriği üretimi için sınırları dardır. Model kimliği :free ile biten sürümlerde dakikada 20, günde 50 istek sınırı vardır; hesaba toplamda en az 10 $ kredi satın alınmışsa günlük sınır 1.000 isteğe çıkar. Başarısız denemeler de bu sayıya dahildir ve bakiye eksiye düşerse ücretsiz modeller de 402 hatası verir.
Ücretsiz modellerin satıcıya görünmeyen maliyetleri
- Liste değişkendir: 13 Ekim 2026'da model API'sinde :free uzantılı 15 model listeleniyordu; bir model ücretsiz sürümden çekilirse aynı talimat başka modelle farklı sonuç verir.
- Veri politikası farklı olabilir: OpenRouter'ın sağlayıcı tablosunda eğitimde kullanabilir olarak işaretli dört sağlayıcıdan üçü (NVIDIA, Liquid, Thinking Machines), Ekim 2026 ücretsiz model listesinde modeli bulunan şirketlerdir; ücretsiz Gemma sürümünü sunan Google AI Studio ise istemleri 55 gün saklar.
- Rastgele model: openrouter/free yönlendiricisi her istekte uygun ücretsiz modellerden birini rastgele seçer; ton ve uzunluk tutarlılığı kaybolur.
Pratik sonuç: ücretsiz modelleri talimatınızı denemek için kullanın, müşteri ya da sipariş bilgisi içeren işleri ücretsiz modele göndermeyin. 1.000 ürünlük katalog, günde 50 istekle en az 20 gün sürer; aynı iş Claude Haiku 5.5 ile örnek hesapta yarım doların altında kalır.
OpenRouter'da veri gizliliği ve sağlayıcı yönlendirme ayarları
OpenRouter varsayılan olarak istem ve yanıt içeriğini saklamaz; yalnız token sayısı, model ve zaman gibi istek üst verilerini kaydeder. İçeriğin hangi sağlayıcıda, ne kadar süre saklanacağı ise isteğin yönlendirildiği sağlayıcının politikasına bağlıdır. OpenRouter'ın Provider Logging sayfasında Ekim 2026'da görünen bazı sağlayıcı politikaları şöyledir:
| Sağlayıcı ucu | Merkez | İstemle model eğitimi | İstem saklama |
|---|---|---|---|
| Anthropic | ABD | Eğitmez | 30 gün |
| OpenAI | ABD | Eğitmez | Saklar (süre belirtilmemiş) |
| Google AI Studio | ABD | Eğitmez | 55 gün |
| Google Vertex | ABD | Eğitmez | Saklamaz |
| Amazon Bedrock | ABD | Eğitmez | Saklamaz |
| Azure | ABD | Eğitmez | Saklamaz |
| Mistral | Fransa | Eğitmez | 30 gün |
| DeepSeek (kendi ucu) | Çin | Eğitebilir (eğitim izni kapalıyken kullanılmaz) | Saklar |
Hesap düzeyinde açıp kapatmanız gereken üç ayar
- Eğitim izni (Settings > Privacy): Kapalıyken OpenRouter istekleri eğitim yapabilen sağlayıcılara göndermez; ücretli ve ücretsiz modeller için ayrı ayardır.
- ZDR (sıfır veri saklama): Açıldığında yalnız veri saklamayan uçlar kullanılır; Anthropic, OpenAI, Google ve diğer modeller için ayrı ayrı açılabilir. Örneğin Claude Sonnet 5.5 bu durumda Google Vertex ve Amazon Bedrock uçlarından, GPT-6 ailesi Azure ucundan çalışır.
- İstem kaydı ve %1 indirim: Girdi ve çıktılarınızın OpenRouter tarafından kullanılmasına izin karşılığında %1 indirim verir; kullanım şartlarına göre bu izin anonimleştirilmiş içeriğin lisanslanmasını da kapsar, ticari veriler için kapalı tutun.
KVKK açısından satıcıya pratik notlar
OpenRouter'ın sunucuları ABD'dedir ve istekler sağlayıcıya göre farklı ülkelerde işlenebilir; bu yüzden müşteri adı, telefon, adres gibi kişisel verileri isteğe koymamak en sağlam yoldur. Yox İş Ortağım yalnız başlattığınız yapay zekâ işlemi için gereken bilgiyi gönderir; rapor görevlerinde özetlenmiş veriler kullanılır. AB içinde işleme OpenRouter'da yalnız Business ve Enterprise planlarında eu.openrouter.ai adresiyle sunulur; bu adresle bağlantı ayrıca değerlendirilir; kurulumdan önce destek ekibimize danışın.
Yox İş Ortağım'da OpenRouter entegrasyonu nasıl çalışır?
Yox İş Ortağım'da OpenRouter entegrasyonu, AI Yönetimi ekranında OpenRouter API anahtarınızın bağlanıp modelin seçilmesiyle çalışır; panelde doğrudan seçilebilen sağlayıcılar bugün Anthropic, OpenAI ve Google'dır. Kurulum kısa sürer; ilk içerik önerisini kendiniz kontrol edersiniz. Seçtiğiniz model şu işlerde kullanılır:
- Trendyol gibi pazaryerlerinin kurallarına uygun ürün başlığı ve açıklama önerisi; öneri siz onaylamadan ilana yazılmaz.
- Kategori eşleme önerisi, Hepsiburada gibi kanallarda reddedilen ilanlar için eksik zorunlu özellik önerisi ve yurt dışı kanallar için ürün çevirisi.
- Alış faturası PDF'inden ya da görselinden bilgi okuma.
- Günlük işletme brifi, sipariş analizi, kâr ve ciro yorumu, stok risk raporu, katalog kalite, fiyatlandırma, rekabet stratejisi, iade kök-neden ve kargo analizi, müşteri sorusuna yanıt taslağı.
Her görevin talimatı Prompt Merkezi'nde düzenlenebilir ya da görev kapatılabilir. Kendi anahtarınızla yapılan kullanım token limitinden muaftır ve harcama AI Yönetimi'ndeki kullanım kaydında görünür; ücreti OpenRouter doğrudan hesabınızdan düşer.
| Paket (aylık) | Yapay zekâ kullanımı | OpenRouter anahtarı bağlama |
|---|---|---|
| Başlangıç – ₺499 | Yok | Yok |
| Büyüme – ₺999 | Yok | Yok |
| Profesyonel – ₺1.999 | Platform token'ıyla ürün açıklaması, başlık, kategori önerisi | Yok |
| Kurumsal – ₺3.999 | Platform token'ı ve kendi AI anahtarı | Var |
| Enterprise – ₺7.999 | Kurumsal kapsamı, bütün limitler sınırsız | Var |
Yıllık ödemede %20 indirim uygulanır; ayrıntılar paket karşılaştırmasında yer alır.
Türkçe ürün metinlerinde dikkat edilecekler
Model kanal kuralını sizin talimatınızdan öğrenir. Trendyol'da ürün adı en fazla 100 karakter, n11'de başlık 15–65 karakter olmalıdır; sınırları talimata yazın, uzun önerileri başlık optimizasyon aracı ile kontrol edin. Modeller kanıtlayamayacağınız sağlık etkisi ya da birincilik iddiası üretebilir; onay adımını atlamayın.
OpenRouter entegrasyonu öncesi kontrol listesi ve sık hatalar
OpenRouter entegrasyonunda sorunların çoğu modelden değil, hesap ayarlarından çıkar. Bağlamadan önce şu listeyi tamamlayın:
- Settings > Privacy'de eğitim izni kapalı, ticari veriler için istem kaydı ve %1 indirim seçeneği kapalı.
- Anahtarın aylık kredi limiti ve son kullanma tarihi tanımlı; otomatik yükleme açıksa üst sınırı belli.
- Kullanılacak model sabit sürümle seçilmiş; aynı 20 üründe en az iki model denenmiş.
- Kredi yüklemesi, en az 0,80 $ ücretin oransal etkisini düşürecek tutarda planlanmış.
Sık yapılan hatalar
- Ücretsiz modelle bütün kataloğu üretmeye çalışıp günlük 50 istek sınırına takılmak.
- ZDR ve sağlayıcı kısıtlarını o kadar daraltmak ki seçilen model için uygun uç kalmaması ve 503 hatası alınması.
- Rapor görevlerine müşteri adı ya da telefon eklemek; kişisel veri gereksizdir.
- Model fiyatını model listesinden okuyup isteğin pahalı bir sağlayıcıya gidebileceğini hesaba katmamak.
Tek bir sağlayıcıyla ilerlemek isterseniz ChatGPT ya da Gemini gibi panelde doğrudan seçilebilen bir bağlantı daha sadedir. OpenRouter bağlantısını kurmak için başvuru formunu doldurabilirsiniz; 3 gün ücretsiz deneme sunuyoruz, kurulumda takılırsanız destek ekibimiz yardımcı olur.
Son kontrol: 14 Ekim 2026
Claude
ChatGPT
Google Gemini
Grok
DeepSeek
Meta Llama
Mistral AI
Perplexity
Azure OpenAI
Qwen
Cohere
Amazon Bedrock
Kimi
Together AI