Skip to content

OpenRouter: Multi-Provider Routing & Caching

Tek bir API ile Claude, GPT, Gemini, Llama'ya erişim. OpenRouter'ın caching desteği nasıl? Provider'lar arasında otomatik fallback. Türk geliştirici için neden kritik bir araç?

Şükrü Yusuf KAYA
13 min read
Intermediate

OpenRouter: Tek API, Tüm Model'ler

OpenRouter (openrouter.ai), Anthropic + OpenAI + Google + 100+ open-source model'i tek bir OpenAI-uyumlu API arkasında topluyor.
Türkiye'den geliştirici olarak bunu kullanma sebeplerin:
  1. Vendor lock-in yok — kod değişmeden Claude'dan GPT'ye geçiş
  2. Otomatik fallback — Anthropic down olursa GPT'ye yönlendir
  3. Fiyat optimizasyonu — aynı modelin farklı provider'larından en ucuzu
  4. Tek fatura — kredi kartı/fatura tek yerde, USD ödeme kolay

OpenAI-Uyumlu API#

OpenAI SDK'sini olduğu gibi kullanırsın, sadece base_url ve api_key değişir:
python
from openai import OpenAI
 
client = OpenAI(
    base_url="https://openrouter.ai/api/v1",
    api_key="sk-or-v1-...",  # OpenRouter API key
)
 
# Model adı olarak provider/model formatı
response = client.chat.completions.create(
    model="anthropic/claude-sonnet-4.6",  # ← provider/model
    messages=[{"role": "user", "content": "Merhaba"}],
)
print(response.choices[0].message.content)
OpenRouter ile Claude çağırma — OpenAI SDK üzerinden
Provider seçenekleri:
anthropic/claude-opus-4.7
anthropic/claude-sonnet-4.6
anthropic/claude-haiku-4.5
openai/gpt-4o
openai/gpt-4.1
openai/o1
google/gemini-2.5-pro
google/gemini-2.5-flash
meta-llama/llama-3.1-70b
mistralai/mistral-large
deepseek/deepseek-r1
... (200+ model)

Caching Desteği#

Önemli: OpenRouter caching'i her provider için farklı çalışır:
Provider (üzerinden)Caching DesteğiNasıl?
Anthropic✅ Tamcache_control passthrough
OpenAI✅ Autootomatik geçer
Gemini⚠️ Sınırlımanuel cache objeleri yok
Open-source (Llama, vb.)✅ Çoğunda varprovider'a göre değişir
Yani Anthropic ile aynı cache_control yapısı OpenRouter üzerinden de çalışır:
python
response = client.chat.completions.create(
    model="anthropic/claude-sonnet-4.6",
    messages=[
        {
            "role": "system",
            "content": [
                {
                    "type": "text",
                    "text": LONG_KB,
                    "cache_control": {"type": "ephemeral"},  # ← Anthropic format
                }
            ],
        },
        {"role": "user", "content": "Soru"}
    ],
)
OpenRouter üzerinden Anthropic caching

Fallback Mimari#

OpenRouter'ın sihirli özelliği: provider fallback. Bir model yetişemezse otomatik diğerine yönlendirir.
python
response = client.chat.completions.create(
    model="anthropic/claude-sonnet-4.6",
    messages=messages,
    extra_body={
        "models": [
            "anthropic/claude-sonnet-4.6",     # 1. tercih
            "openai/gpt-4o",                    # fallback 1
            "google/gemini-2.5-pro",            # fallback 2
        ],
        "route": "fallback",
    },
)
# Kullanılan modeli response'da gör
print(f"Model used: {response.model}")
Otomatik fallback — uptime SLA için
Production Pattern
Production'da bu pattern altın değerinde. Anthropic outage olursa GPT'ye yönlendirip kullanıcıların hizmeti kesintisiz kalır. Cost tradeoff: GPT genelde daha pahalı + cache kaybı, ama %0.1 trafikte oluşunca toplamda ucuz.

Fiyat Avantajı#

OpenRouter aynı modelin farklı provider'larından çekebilir:
meta-llama/llama-3.1-70b-instruct:
  - Together AI: $0.88/M input
  - Fireworks: $0.90/M input
  - DeepInfra: $0.85/M input  ← otomatik bunu seçer
OpenRouter "lowest price" route'u default. İstersen "fastest" veya "throughput" da seçebilirsin.

Türkiye'den Erişim Avantajları#

OpenAI ve Anthropic'i Türkiye'den kredi kartıyla ödemek bazen sıkıntılı:
  • Anthropic: Türk bankası kartlarını çoğu zaman reddediyor
  • OpenAI: ID doğrulama bazen başarısız
  • Gemini: Genelde sorunsuz ama paylaşılan accountlar bazen ban
OpenRouter USD ödeme alır + çoğu Türk bankası çalışır. Tek "Türk geliştirici dostu" çözüm gibi davranır.

✓ Pekiştir#

Bir Sonraki Derste#

Üç provider'ı yan yana koyacağız: karar matrisi ve hangi senaryoda hangisini seçeceğini somut tablolarla göreceksin.

Frequently Asked Questions

Yes — OpenRouter standart olarak provider fiyatına %5 markup koyuyor. Bunun karşılığı: tek API, fallback, fatura kolaylığı, monitoring. Eğer doğrudan provider hesabın varsa daha ucuz; yoksa OpenRouter çoğunlukla pratikçedir.

Yorumlar & Soru-Cevap

(0)
Yorum yazmak için giriş yap.
Yorumlar yükleniyor...

Related Content

1. Temeller — Context Penceresi Ekonomisi

Bu Eğitim Hakkında ve Prompt Caching Neden Önemli?

Start Learning
1. Temeller — Context Penceresi Ekonomisi

Token Ekonomisi 101: Input vs Output Cost Asimetrisi

Start Learning
1. Temeller — Context Penceresi Ekonomisi

Context Window Evrimi: 4K'dan 1M'a 5 Yılda Ne Oldu?

Start Learning