OpenRouter Nedir? Tek API ile 50+ LLM Modeline Erişim Rehberi

Geçen hafta bir müşterim diolivo.com.tr için sepet kurtarma otomasyonu kurarken şöyle bir sorun yaşadım: GPT-4o ile başladık, sonra Claude Sonnet 3.5'e geçmek istedik çünkü Türkçe e-posta tonlaması daha doğal geliyordu. Normalde iki ayrı API key, iki farklı endpoint, iki ayrı fatura demek bu. Ama ben OpenRouter kullandığım için sadece model parametresini değiştirdim, 4 dakikada geçiş tamamdı. OpenRouter'ın asıl değeri burada: tek bir entegrasyon, onlarca model, hiç vendor lock-in yok. Bu yazıda OpenRouter'ın ne olduğunu, nasıl çalıştığını ve hangi senaryolarda gerçekten mantıklı olduğunu anlatacağım. Eğer projenizde birden fazla LLM modeli test ediyor, maliyet optimizasyonu arıyor ya da model sağlayıcı değiştirme esnekliği istiyorsanız, okumaya devam edin.

OpenRouter Nedir ve Nasıl Çalışır?

OpenRouter, basitçe söylemek gerekirse bir API gateway. OpenAI, Anthropic, Google, Meta gibi farklı sağlayıcıların LLM modellerini tek bir API endpoint'i üzerinden kullanmanızı sağlıyor. Siz OpenRouter'a istek atıyorsunuz, o da arka planda ilgili modele yönlendiriyor. Dönen cevabı da standartlaştırılmış formatta size geri gönderiyor.

Teknolojik olarak baktığımızda OpenRouter bir proxy katmanı. Kendi API key'inizi alıyorsunuz, kodunuzda OpenRouter endpoint'ini kullanıyorsunuz. Model seçimini model parametresiyle yapıyorsunuz. Örneğin openai/gpt-4o, anthropic/claude-3.5-sonnet, meta-llama/llama-3.1-70b gibi. Bu sayede aynı kod yapısıyla onlarca modeli test edebiliyorsunuz.

Ben FUTIA'da özellikle prototipleme aşamasında OpenRouter'ı yoğun kullanıyorum. Bir müşteri için içerik otomasyonu kurarken önce 5-6 farklı modeli aynı prompt ile test ediyorum. Hangisi daha iyi sonuç veriyor, hangisi daha hızlı, hangisi daha ucuz, bunları karşılaştırıyorum. OpenRouter olmasa her model için ayrı hesap açmam, ayrı ödeme yöntemi eklemem gerekecekti. Şimdi tek bir kredi kartı, tek bir dashboard, tüm modeller orada.

OpenRouter'ın Avantajları

Birinci avantaj: zaman tasarrufu. Yeni bir model denemek için kod değiştirmenize gerek yok. Sadece model ismini değiştiriyorsunuz. Ben doktorbul.com projesinde içerik üretimi için başta GPT-3.5 kullandık. Sonra Llama 3.1 70B'ye geçtik çünkü maliyet %60 düştü. Kod tarafında tek satır değişiklik yaptık.

İkinci avantaj: maliyet optimizasyonu. OpenRouter, her model için gerçek zamanlı fiyatlandırma gösteriyor. Dashboard'da hangi modelin token başına ne kadar tuttuğunu görüyorsunuz. Aynı görevi farklı modellerle test edip en ucuzunu seçebiliyorsunuz. Örneğin basit bir sınıflandırma işi için GPT-4o yerine Claude Haiku kullanmak %90 daha ucuz olabiliyor.

Üçüncü avantaj: vendor lock-in riski yok. OpenAI yarın fiyatları 3 katına çıkarsa, siz bir satır kod değiştirerek Anthropic'e geçebilirsiniz. Ya da OpenAI API'si dünyada bir yerde sorun yaşıyorsa, otomatik olarak yedek modele failover yapabilirsiniz. Ben futia.net için video üretim pipeline'ında bunu kullanıyorum. GPT-4o timeout verirse otomatik olarak Claude Sonnet'e düşüyor.

Hangi Modeller Destekleniyor?

OpenRouter'da 50'den fazla model var. Sürekli yenileri ekleniyor. Ben bu yazıyı yazarken saydım, şu an 63 farklı model aktif. Bunların içinde:

• OpenAI: GPT-4o, GPT-4 Turbo, GPT-3.5 Turbo, o1-preview, o1-mini
• Anthropic: Claude 3.5 Sonnet, Claude 3 Opus, Claude 3 Haiku
• Google: Gemini 1.5 Pro, Gemini 1.5 Flash, PaLM 2
• Meta: Llama 3.1 405B, Llama 3.1 70B, Llama 3.1 8B
• Mistral: Mistral Large, Mistral Medium, Mixtral 8x7B
• Cohere: Command R+, Command R
• Açık kaynak modeller: Nous Hermes, WizardLM, Dolphin, vb.

Ben projelerimde en çok GPT-4o, Claude Sonnet 3.5 ve Llama 3.1 70B kullanıyorum. GPT-4o genel amaçlı işler için çok iyi, özellikle function calling güçlü. Claude Sonnet uzun metinlerde ve Türkçe tonlamada daha başarılı. Llama 3.1 70B ise maliyet hassas projelerde tercihim.

Örnek vermek gerekirse: kamupersonelhaber.com için günlük ilan scraping ve özetleme otomasyonu kurdum. İlan.gov.tr API'sinden gelen metinleri özetliyoruz. Burada Claude Haiku kullanıyoruz çünkü basit bir özetleme işi, GPT-4o'ya gerek yok. Aylık maliyet 50 bin ilan için yaklaşık 8 dolar. Aynı işi GPT-4o ile yapsak 60-70 dolar olurdu.

Model Seçim Stratejisi

Her model farklı senaryoda parlar. Ben şöyle bir strateji kullanıyorum:

• Karmaşık reasoning, function calling: GPT-4o veya Claude Opus
• Uzun döküman analizi, Türkçe içerik: Claude Sonnet 3.5
• Yüksek hacim, basit görevler: Claude Haiku veya Llama 3.1 8B
• Hız kritik: Gemini 1.5 Flash veya GPT-3.5 Turbo
• Maliyet kritik: Llama 3.1 70B veya Mixtral 8x7B

italyanmutfagi.com için tarif üretimi yaparken Claude Sonnet kullandık. 618 tarif ürettik, her biri ortalama 400 kelime. Claude'un yemek tariflerindeki dil akışı GPT-4'ten daha doğal geldi. Ayrıca Schema.org Recipe formatına uyum konusunda daha az hata yaptı.

OpenRouter Nasıl Kullanılır?

Kullanım oldukça basit. Önce openrouter.ai'ye gidip hesap açıyorsunuz. GitHub veya Google ile giriş yapabilirsiniz. Hesap açtıktan sonra Settings > Keys bölümünden API key oluşturuyorsunuz. Bu key'i kodunuzda kullanacaksınız.

API çağrısı OpenAI formatıyla neredeyse aynı. Python örneği:

import requests

response = requests.post(
  "https://openrouter.ai/api/v1/chat/completions",
  headers={
    "Authorization": f"Bearer {OPENROUTER_API_KEY}",
    "HTTP-Referer": "https://futia.io",
    "X-Title": "FUTIA Otomasyon"
  },
  json={
    "model": "anthropic/claude-3.5-sonnet",
    "messages": [
      {"role": "user", "content": "Türkiye'de yapay zeka otomasyonunun geleceği hakkında 100 kelimelik bir paragraf yaz."}
    ]
  }
)

print(response.json()['choices'][0]['message']['content'])

Ben FUTIA projelerinde genelde OpenAI Python kütüphanesini kullanıyorum, sadece base URL'i değiştiriyorum:

from openai import OpenAI

client = OpenAI(
  base_url="https://openrouter.ai/api/v1",
  api_key=OPENROUTER_API_KEY,
)

completion = client.chat.completions.create(
  model="anthropic/claude-3.5-sonnet",
  messages=[
    {"role": "user", "content": "Prompt buraya"}
  ]
)

Bu yaklaşımın güzel yanı, mevcut OpenAI kodunuzu neredeyse hiç değiştirmeden OpenRouter'a taşıyabilirsiniz. Ben memuratamalari.com projesinde bunu yaptım. 3 satır değişiklikle tüm Claude Haiku çağrılarını OpenRouter üzerinden yapmaya başladık.

Fiyatlandırma ve Kredi Sistemi

OpenRouter iki fiyatlandırma modeli sunuyor: kredi sistemi ve doğrudan ödeme. Kredi sisteminde önceden bakiye yüklüyorsunuz, her API çağrısında bakiyeniz düşüyor. Doğrudan ödemede ise aylık fatura kesiliyor.

Ben kredi sistemini tercih ediyorum çünkü bütçe kontrolü daha kolay. 50 dolar yüklüyorum, bitince yeniden yüklüyorum. Böylece beklenmedik fatura şoku yaşamıyorum. OpenRouter'ın dashboard'u çok şeffaf, hangi model ne kadar tüketti, hangi gün kaç token kullandınız, hepsini görüyorsunuz.

Fiyatlar modele göre değişiyor. Örneğin şu anki fiyatlar (1 milyon token için):

• GPT-4o: ~15 dolar (input + output ortalaması)
• Claude Sonnet 3.5: ~12 dolar
• Claude Haiku: ~1 dolar
• Llama 3.1 70B: ~4 dolar
• GPT-3.5 Turbo: ~2 dolar

Bu fiyatlar direkt sağlayıcılardan almakla neredeyse aynı. OpenRouter çok küçük bir markup ekliyor ama esneklik karşılığında bence değer.

OpenRouter ile Gerçek Dünya Kullanım Senaryoları

Ben FUTIA'da OpenRouter'ı şu senaryolarda kullanıyorum:

1. Model A/B Testi diolivo.com.tr için sepet kurtarma e-postalarını optimize ederken 4 farklı model test ettik: GPT-4o, Claude Sonnet, Claude Haiku, Llama 3.1 70B. Aynı prompt'u 100'er sepet ile denedik. Claude Sonnet %18 daha yüksek açılma oranı verdi. Bunu OpenRouter sayesinde 2 saatte test edebildik.

2. Maliyet Optimizasyonu italyanmutfagi.com'da başta GPT-4o kullanıyorduk. Sonra fark ettik ki tarif üretimi için o kadar güçlü bir model gerekmiyor. Claude Haiku'ya geçtik, kalite farkı %5 düştü ama maliyet %85 düştü. 618 tarif için başta 120 dolar ödeyecektik, 18 dolar ödedik.

3. Failover ve Yedekleme futia.net video üretim pipeline'ında GPT-4o kullanıyoruz. Ama bazen OpenAI API'si yavaşlıyor veya rate limit veriyor. Bu durumda otomatik olarak Claude Sonnet'e geçiyoruz. Kullanıcı hiçbir şey fark etmiyor, video üretimi devam ediyor.

4. Çok Dilli İçerik Üretimi Bir müşterim için İngilizce, Almanca, Fransızca içerik üretiyoruz. GPT-4o İngilizce'de çok iyi ama Almanca'da Claude Opus daha başarılı. OpenRouter sayesinde dile göre model seçimi yapabiliyoruz.

OpenRouter'ın Dezavantajları ve Dikkat Edilmesi Gerekenler

Her teknolojinin olduğu gibi OpenRouter'ın da eksileri var. Bunları bilmek önemli:

Latency: OpenRouter bir proxy katmanı olduğu için direkt sağlayıcıya göre 50-200ms ekstra gecikme ekliyor. Çoğu senaryo için sorun değil ama gerçek zamanlı chatbot gibi uygulamalarda hissedilebilir.

Veri Gizliliği: Verileriniz OpenRouter sunucularından geçiyor. OpenRouter'ın privacy policy'sine göre logları saklamıyorlar ama yine de hassas veri işliyorsanız bunu göz önünde bulundurun. Ben hassas müşteri verisi olan projelerde direkt sağlayıcıyı tercih ediyorum.

Rate Limit Karmaşıklığı: Her modelin farklı rate limitleri var. OpenRouter bunları yönetiyor ama bazen hangi modelin ne kadar limit verdiğini anlamak zor olabiliyor. Dashboard'da detaylı bilgi yok, deneme yanılma ile öğreniyorsunuz.

Model Güncellemeleri: Sağlayıcılar yeni model versiyonu çıkardığında OpenRouter'ın eklemesi birkaç gün sürebiliyor. Örneğin GPT-4o mini çıktığında OpenRouter'da 3 gün sonra göründü. Eğer en yeni modeli hemen kullanmak istiyorsanız bu bir dezavantaj.

Ben bu dezavantajları göz önünde bulundurarak şöyle bir strateji izliyorum: geliştirme ve test aşamasında OpenRouter, production'da kritik işler için direkt sağlayıcı. Ama maliyet hassas ve yüksek hacimli işlerde production'da da OpenRouter kullanıyorum.

OpenRouter Alternatifleri ve Karşılaştırma

OpenRouter'a benzer hizmetler de var. En bilinenleri:

Hugging Face Inference API: Açık kaynak modellere odaklı. GPT-4 veya Claude gibi kapalı modeller yok. Ama Llama, Mistral gibi modelleri ücretsiz veya çok ucuza kullanabilirsiniz.

Together AI: Açık kaynak modeller için optimize edilmiş. Llama 3.1 405B gibi büyük modelleri çok hızlı ve ucuza sunuyorlar. Ama Claude veya GPT yok.

Anyscale Endpoints: Ray ekosisteminin bir parçası. Llama ve Mistral modelleri çok hızlı çalışıyor. Ama model çeşitliliği OpenRouter'dan az.

Direkt Sağlayıcı: Tabii ki her zaman direkt OpenAI, Anthropic, Google'dan alabilirsiniz. Latency en düşük, veri gizliliği tam kontrol altında. Ama esneklik sıfır, her sağlayıcı için ayrı entegrasyon.

Ben şöyle bir karar ağacı kullanıyorum: eğer sadece OpenAI kullanacaksam direkt OpenAI. Eğer 2-3 farklı model test edeceksem OpenRouter. Eğer sadece açık kaynak modeller yetiyorsa Together AI. Her projenin ihtiyacı farklı, tek doğru cevap yok.

OpenRouter ile Başlarken: Pratik Adımlar

Eğer OpenRouter'ı denemek istiyorsanız şu adımları izleyin:

1. openrouter.ai'ye gidin, hesap açın 2. Settings > Keys'den bir API key oluşturun 3. 5-10 dolar kredi yükleyin (başlangıç için yeterli) 4. Mevcut kodunuzu alın, base URL'i değiştirin 5. 2-3 farklı modeli aynı prompt ile test edin 6. Dashboard'dan maliyet ve performans karşılaştırın 7. En uygun modeli seçin, production'a alın

Ben yeni bir proje başlatırken her zaman OpenRouter ile başlıyorum. İlk hafta 5-6 model test ediyorum, hangisi en iyi sonuç veriyor görüyorum. Sonra production'da o modele geçiyorum. Bu yaklaşım sayesinde doktorbul.com'da %40, diolivo.com.tr'de %55 maliyet tasarrufu sağladık.

OpenRouter'ın benim için en büyük değeri şu: deneme maliyetini sıfıra indiriyor. Yeni bir model denemek için hesap açmaya, ödeme bilgisi girmeye, yeni bir SDK öğrenmeye gerek yok. Sadece model ismini değiştiriyorsunuz, 30 saniyede test ediyorsunuz. Bu hız, özellikle otomasyon projelerinde çok kritik.

Eğer siz de yapay zeka otomasyonlarınızda model esnekliği, maliyet optimizasyonu veya hızlı prototipleme arıyorsanız OpenRouter'a bir şans verin. Ben FUTIA'da müşterilerime site, otomasyon ve aylık bakım hizmeti sunarken OpenRouter'ı sık sık kullanıyorum. Sorularınız varsa WhatsApp'tan +90 532 491 17 05 numarasından veya info@futia.net adresinden ulaşabilirsiniz.