Kimi K2.5 OpenRouter entegrasyonu, Moonshot AI'nin açık ağırlıklı amiral gemisi modeline birleşik bir API ağ geçidi üzerinden sorunsuz erişim sağlar. OpenRouter ile geliştiriciler, Kimi K2.5'in uzun bağlam ve akıl yürütme yeteneklerini mevcut uygulamalara minimum API değişikliğiyle dahil edebilir.
OpenRouter Nedir?
OpenRouter, tek ve standartlaştırılmış bir arayüz üzerinden yüzlerce AI modeline erişim sağlayan birleşik bir API ağ geçididir. Kimi K2.5'i OpenRouter üzerinden kullanan geliştiriciler şu avantajlardan yararlanır:
- Tüm modeller için tek API: Sağlayıcılar arasında tutarlı arayüz
- Otomatik yedekleme: Bir model kullanılamazsa modeli değiştirin
- Rekabetçi fiyatlandırma: Mevcut en iyi tarifelere erişim
- Kullanım analitiği: Merkezi izleme ve takip
- Geniş uyumluluk: OpenAI uyumlu SDK'lar ile çalışır
Kimi K2.5'e OpenRouter Üzerinde Başlarken
Hesap Kurulumu
- OpenRouter Hesabı Oluşturun: openrouter.ai adresini ziyaret edin
- Ödeme Yöntemi Ekleyin: Faturalandırma tercihlerini yapılandırın
- API Anahtarı Oluşturun: Erişim kimlik bilgilerinizi oluşturun
- Kimi K2.5'i Bulun: Model listesinde "moonshotai/kimi-k2.5" araması yapın
Temel Entegrasyon
from openai import OpenAI
# OpenRouter ile başlat
client = OpenAI(
base_url="https://openrouter.ai/api/v1",
api_key="YOUR_OPENROUTER_API_KEY"
)
# Kimi K2.5'e istek gönder
response = client.chat.completions.create(
model="moonshotai/kimi-k2.5",
messages=[
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "Explain quantum computing in simple terms."}
]
)
print(response.choices[0].message.content)
Kimi K2.5 için OpenRouter Fiyatlandırması
Maliyet Karşılaştırması
| Sağlayıcı | Girdi (1M token başına) | Çıktı (1M token başına) |
|---|---|---|
| OpenRouter | $0.45 | $2.25 |
| Doğrudan Moonshot | $0.60 | $3.00 |
Fiyatlandırma Avantajları
Kimi K2.5'i OpenRouter üzerinden kullanmak şunları sunar:
- Şeffaf fiyatlandırma: Gizli ücret yok
- Kullandıkça öde: Yalnızca kullandığınız kadar ödersiniz
- Sağlayıcı fiyatının doğrudan aktarımı: OpenRouter, sağlayıcı model fiyatının doğrudan aktarıldığını belirtir
- Birleşik faturalandırma/analitik: Çok modelli kullanımı tek bir panodan takip edin
Popüler Frameworkler için Kod Örnekleri
Python (OpenAI SDK)
import openai
client = openai.OpenAI(
base_url="https://openrouter.ai/api/v1",
api_key="$OPENROUTER_API_KEY"
)
completion = client.chat.completions.create(
model="moonshotai/kimi-k2.5",
messages=[
{"role": "user", "content": "Write a Python function to calculate fibonacci numbers."}
],
extra_headers={
"HTTP-Referer": "YOUR_SITE_URL",
"X-Title": "YOUR_APP_NAME"
}
)
print(completion.choices[0].message.content)
JavaScript/TypeScript
import OpenAI from 'openai';
const openai = new OpenAI({
baseURL: 'https://openrouter.ai/api/v1',
apiKey: process.env.OPENROUTER_API_KEY,
defaultHeaders: {
'HTTP-Referer': 'YOUR_SITE_URL',
'X-Title': 'YOUR_APP_NAME'
}
});
async function getCompletion() {
const completion = await openai.chat.completions.create({
model: 'moonshotai/kimi-k2.5',
messages: [
{ role: 'user', content: 'Hello!' }
]
});
console.log(completion.choices[0].message.content);
}
getCompletion();
cURL
curl https://openrouter.ai/api/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $OPENROUTER_API_KEY" \
-H "HTTP-Referer: YOUR_SITE_URL" \
-H "X-Title: YOUR_APP_NAME" \
-d '{
"model": "moonshotai/kimi-k2.5",
"messages": [
{"role": "user", "content": "What is the meaning of life?"}
]
}'
Gelişmiş Özellikler
Model Yönlendirme ve Yedekleme
OpenRouter akıllı model seçimini mümkün kılar:
# Otomatik yedekleme yapılandırması
response = client.chat.completions.create(
model="moonshotai/kimi-k2.5",
messages=messages,
extra_body={
"models": ["moonshotai/kimi-k2.5", "openai/gpt-4o"],
"route": "fallback"
}
)
Akış Yanıtları
Gerçek zamanlı uygulamalar için:
# OpenRouter üzerinde Kimi K2.5 ile akış
stream = client.chat.completions.create(
model="moonshotai/kimi-k2.5",
messages=[{"role": "user", "content": "Tell me a story."}],
stream=True
)
for chunk in stream:
if chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="")
Function Calling
Kimi K2.5, OpenRouter üzerinden araç kullanımını destekler:
tools = [
{
"type": "function",
"function": {
"name": "get_weather",
"description": "Get current weather",
"parameters": {
"type": "object",
"properties": {
"location": {"type": "string"}
},
"required": ["location"]
}
}
}
]
response = client.chat.completions.create(
model="moonshotai/kimi-k2.5",
messages=[{"role": "user", "content": "What's the weather in Tokyo?"}],
tools=tools
)
Framework Entegrasyonları
LangChain Entegrasyonu
from langchain_openai import ChatOpenAI
llm = ChatOpenAI(
model="moonshotai/kimi-k2.5",
base_url="https://openrouter.ai/api/v1",
api_key="YOUR_OPENROUTER_API_KEY",
model_kwargs={
"headers": {
"HTTP-Referer": "YOUR_SITE_URL",
"X-Title": "YOUR_APP_NAME"
}
}
)
response = llm.invoke("Explain machine learning.")
LlamaIndex Entegrasyonu
from llama_index.llms.openai import OpenAI
llm = OpenAI(
model="moonshotai/kimi-k2.5",
api_base="https://openrouter.ai/api/v1",
api_key="YOUR_OPENROUTER_API_KEY",
additional_kwargs={
"headers": {
"HTTP-Referer": "YOUR_SITE_URL",
"X-Title": "YOUR_APP_NAME"
}
}
)
OpenRouter Üzerinde Kullanılabilen Kimi K2.5 Özellikleri
Tam Yetenek Erişimi
| Özellik | OpenRouter'da Mevcut | Notlar |
|---|---|---|
| Bağlam Uzunluğu | Evet | 262,144 token (~256K) |
| Function Calling | Evet | Araç kullanımı destekleniyor |
| Akış | Evet | Gerçek zamanlı yanıtlar |
| JSON Modu | Evet | Yapılandırılmış çıktı |
| Akıl Yürütme Kontrolleri | Evet | reasoning / include_reasoning parametreleri aracılığıyla |
| Görüş | Evet | Çok modlu destek |
Özel Parametreler
Kimi K2.5'in benzersiz özelliklerine erişin:
# Akıl yürütme kontrollerini etkinleştir
response = client.chat.completions.create(
model="moonshotai/kimi-k2.5",
messages=messages,
reasoning={"max_tokens": 4000},
include_reasoning=True
)
Karşılaştırma: Doğrudan vs OpenRouter
| Yön | Doğrudan Moonshot API | OpenRouter |
|---|---|---|
| Kurulum Karmaşıklığı | Tek sağlayıcı | Evrensel ağ geçidi |
| Fiyatlandırma | 1M başına $0.60/$3.00 | 1M başına $0.45/$2.25 |
| Model Değiştirme | Manuel | Otomatik yedekleme |
| Analitik | Sağlayıcıya özel | Birleşik pano |
| Hız Limitleri | Sağlayıcı tarafından tanımlı | Optimize edilmiş yönlendirme |
En İyi Uygulamalar
Optimizasyon İpuçları
- Gerektiğinde Header Kullanın:
HTTP-RefererveX-Titleisteğe bağlıdır, ancak uygulama atıfı için faydalıdır - Yeniden Deneme Uygulayın: Geçici hataları zarif bir şekilde ele alın
- Kullanımı İzleyin: Maliyetleri OpenRouter panosu üzerinden takip edin
- Yanıtları Önbelleğe Alın: Tekrarlanan sorgular için maliyetleri azaltın
- Akış Kullanın: Uzun yanıtlarda daha iyi kullanıcı deneyimi için
Hata İşleme
import time
from openai import OpenAI, RateLimitError
client = OpenAI(
base_url="https://openrouter.ai/api/v1",
api_key="YOUR_KEY"
)
def robust_completion(messages, max_retries=3):
for attempt in range(max_retries):
try:
return client.chat.completions.create(
model="moonshotai/kimi-k2.5",
messages=messages
)
except RateLimitError:
if attempt < max_retries - 1:
time.sleep(2 ** attempt) # Exponential backoff
else:
raise
Kullanım Senaryoları
Çok Modelli Uygulamalar
# Modeller arasında yanıtları karşılaştır
models = [
"moonshotai/kimi-k2.5",
"openai/gpt-4o",
"anthropic/claude-3.5-sonnet"
]
for model in models:
response = client.chat.completions.create(
model=model,
messages=[{"role": "user", "content": prompt}]
)
print(f"{model}: {response.choices[0].message.content}")
Maliyet Optimize Edilmiş İş Akışları
# Basit sorguları daha ucuz modellere yönlendir
def smart_route(prompt_complexity):
if prompt_complexity == "simple":
return "moonshotai/kimi-k2.5" # En uygun maliyetli
elif prompt_complexity == "complex":
return "moonshotai/kimi-k2.5" # Yine de en iyi değer
else:
return "moonshotai/kimi-k2.5" # Varsayılan olarak Kimi
Sıkça Sorulan Sorular
Kimi K2.5'e OpenRouter üzerinde nasıl erişirim?
OpenRouter'a yaptığınız API çağrılarında moonshotai/kimi-k2.5 model tanımlayıcısını kullanın.
Kimi K2.5 fiyatlandırması OpenRouter'da aynı mı?
Tam olarak değil. 2026-02-10 itibarıyla OpenRouter, moonshotai/kimi-k2.5 modelini 1M token başına $0.45 girdi / $2.25 çıktı olarak listelerken, doğrudan Moonshot sağlayıcı fiyatı $0.60 girdi (cache miss) / $3.00 çıktı olarak listelenir.
OpenRouter'ı doğrudan API yerine kullanmanın faydaları nelerdir?
OpenRouter; birleşik faturalandırma, otomatik yedekleme, kullanım analitiği ve kodunuzu değiştirmeden kolay model değiştirme imkanı sağlar.
Kimi K2.5, OpenRouter üzerinde function calling destekliyor mu?
Evet. OpenRouter, moonshotai/kimi-k2.5 için tools, akış, yapılandırılmış çıktılar ve 262,144 tokenlık bağlam penceresi desteğini listeler.
Mevcut OpenAI SDK kodumu OpenRouter ile kullanabilir miyim?
Kesinlikle. Sadece base_url değerini https://openrouter.ai/api/v1 olarak değiştirin ve moonshotai/kimi-k2.5 model adını kullanın.
OpenRouter'da hız limitleri var mı?
Hız limitleri, OpenRouter hesap kademenize göre değişir. Daha yüksek kademeler, artırılmış hız limitleri ve öncelikli erişim sunar.
Kimlik doğrulamayı nasıl ele alırım?
OpenRouter API anahtarınızı, Authorization başlığında Bearer token formatıyla kullanın.
Kimi K2.5'i OpenRouter üzerinden LangChain ile kullanabilir miyim?
Evet, LangChain'in OpenAI entegrasyonu, base URL ve model adı yapılandırılarak OpenRouter ile sorunsuz çalışır.
Kimi K2.5'i bugün kullanmaya başlayın ve OpenRouter ile birleşik çok modelli yönlendirme üzerinden hızlı entegrasyon yolunu deneyimleyin.