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 dakikalık okuma
OrtaOpenRouter: 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:
- Vendor lock-in yok — kod değişmeden Claude'dan GPT'ye geçiş
- Otomatik fallback — Anthropic down olursa GPT'ye yönlendir
- Fiyat optimizasyonu — aynı modelin farklı provider'larından en ucuzu
- 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ği | Nasıl? |
|---|---|---|
| Anthropic | ✅ Tam | cache_control passthrough |
| OpenAI | ✅ Auto | otomatik geçer |
| Gemini | ⚠️ Sınırlı | manuel cache objeleri yok |
| Open-source (Llama, vb.) | ✅ Çoğunda var | provider'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örprint(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.
Sık Sorulan Sorular
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...
İlgili İçerikler
1. Temeller — Context Penceresi Ekonomisi
Bu Eğitim Hakkında ve Prompt Caching Neden Önemli?
Öğrenmeye Başla1. Temeller — Context Penceresi Ekonomisi
Token Ekonomisi 101: Input vs Output Cost Asimetrisi
Öğrenmeye Başla1. Temeller — Context Penceresi Ekonomisi