Kimi K3 API: Erişim ve Kullanım Rehberi (Python + curl)

Moonshot AI'ın 16 Temmuz 2026'da yayımladığı Kimi K3, açık ağırlıklı model dünyasının çıtasını gözle görülür biçimde yükseltti: yaklaşık 2,8 trilyon parametreli Mixture-of-Experts mimarisi, 1 milyon token bağlam penceresi ve Artificial Analysis endeksinde 189 model arasında 4. sıra. Bu rehberde K3'ün ne getirdiğini, Claude ve GPT ailelerine karşı nerede durduğunu, Türkiye'den API erişimini nasıl alacağınızı ve Python ile curl üzerinden ilk isteği nasıl atacağınızı adım adım anlatıyoruz. Tüm örnekler Onysoft AI Gateway'in OpenAI-uyumlu API'siyle çalışır; yabancı kart ya da VPN gerekmez.

Kimi K3 Ne Getiriyor?

Kimi K3, Moonshot AI'ın yeni amiral gemisi ve açık ağırlıklı (open-weight) olarak yayımlandı. Mimaride yaklaşık 2,8 trilyon parametreli bir Mixture-of-Experts tasarımı kullanılıyor; her istekte uzman ağların yalnızca bir bölümü devreye girdiği için bu devasa ölçek, kaliteyi artırırken çıkarım tarafını yönetilebilir tutuyor.

Pratikte üç özellik öne çıkıyor:

• 1M token bağlam penceresi (tam olarak 1.048.576 token) — çok dosyalı bir kod tabanını, uzun sözleşme setlerini veya saatler süren bir ajan oturumunun tüm geçmişini tek istekte taşımaya yetiyor.
• Yerleşik görüş (vision) — ekran görüntüsü, diyagram ve doküman görselleri ayrı bir modele gerek kalmadan aynı uçtan işleniyor.
• Sürekli açık muhakeme (always-on reasoning) — ayrı bir "düşünme modu" seçmiyorsunuz; model her yanıtta akıl yürütme katmanını kullanıyor.

API kimliği moonshotai/kimi-k3 — OpenAI-uyumlu her SDK ve araçtan bu adla çağrılıyor. Üstelik uzun bağlamın ek ücreti yok: fiyat, 1M pencerenin tamamında sabit. Detayları fiyatlandırma bölümünde ele alıyoruz.

Benchmark Konumu: K3 Rakiplerinin Neresinde?

Artificial Analysis Intelligence Index'te Kimi K3, 57 puanla 189 model arasında 4. sırada. Önünde yalnızca iki kapalı model var: muhakeme ayarlarıyla Claude Fable 5 ve GPT-5.6 Sol. Buna karşılık Claude Opus 4.8, GPT-5.5, Claude Sonnet 5 ve GLM-5.2'nin önünde konumlanıyor — bu tablo, K3'ü endeksin en güçlü açık ağırlıklı modeli yapıyor.

Alan bazında da tablo güçlü: kodlama skoru 76,2 ile 98. yüzdelik dilimde; doktora seviyesi bilimsel muhakemeyi ölçen GPQA'da 93,5 alıyor. Kod üretimi, çok adımlı analiz ve teknik doküman işleme gibi iş yüklerinde kapalı amiral modellerle aynı ligde oynadığını söylemek abartı olmaz.

Tarafsız okuma şu: mutlak kalite tavanı hâlâ Fable 5 ve GPT-5.6 Sol'da. K3'ün iddiası, bu seviyeye en çok yaklaşan açık ağırlıklı model olması — ve bunu tek modelde 1M bağlam, görüş ve muhakemeyi birleştirerek yapması. Kendi iş yükünüz için en sağlıklı karşılaştırma, aynı istemi Playground'da birden fazla modelle yan yana denemektir.

Kimi K3 API Erişimi: Adım Adım

Kimi K3'e erişmek için Moonshot AI ile ayrı bir sözleşme, yabancı kart ya da VPN gerekmiyor; Onysoft AI Gateway üzerinden beş dakikada başlayabilirsiniz:

1. Ücretsiz hesap oluşturun — kurumsal e-fatura ve KVKK uyumluluğu standarttır.
2. Panelden sk-ony- önekli API anahtarınızı üretin.
3. TL bakiye yükleyin; kullanım TCMB kuru üzerinden, kullandıkça öde modeliyle düşülür. Aylık taahhüt yok.
4. Kod yazmadan önce Playground'da moonshotai/kimi-k3'ü deneyin — aynı istemi Kimi ailesinin ekonomik üyeleriyle karşılaştırmak model seçimini ciddi hızlandırır.
5. Uygulamanızda base_url değerini https://api.onysoft.com/v1 yapın, model adını verin; hepsi bu.

Mevcut bir OpenAI entegrasyonunuz varsa geçiş iki satırlık değişikliktir: base_url ve model. Aynı anahtarla katalogdaki 708+ model arasından dilediğinize erişirsiniz — tek bakiye, tek fatura, tek API. Sorun yaşarsanız 7/24 Türkçe destek ekibi yanınızda.

Python ve curl ile İlk İstek

Onysoft ucu OpenAI şemasını birebir izlediği için resmi openai Python paketi doğrudan çalışır:

from openai import OpenAI

client = OpenAI(
    base_url="https://api.onysoft.com/v1",
    api_key="sk-ony-ANAHTARINIZ",
)

response = client.chat.completions.create(
    model="moonshotai/kimi-k3",
    messages=[
        {"role": "user", "content": "Bu sözleşme setindeki riskli maddeleri başlıklar halinde çıkar."}
    ],
)
print(response.choices[0].message.content)

Aynı istek curl ile:

curl https://api.onysoft.com/v1/chat/completions \
  -H "Authorization: Bearer sk-ony-ANAHTARINIZ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "moonshotai/kimi-k3",
    "messages": [{"role": "user", "content": "Kimi K3 ile K2.x arasindaki farki ozetle."}]
  }'

Streaming için isteğe "stream": true eklemek yeterli; fonksiyon çağırma (tools) ve JSON modu da aynı şemayla destekleniyor. Görsel girdi için OpenAI şemasındaki image_url içerik bloklarını aynı uçta kullanabilirsiniz — K3'ün görüşü yerleşik olduğundan ayrı bir model seçmeniz gerekmez. Tüm parametreler, hata kodları ve dil bazlı örnekler için API dokümantasyonuna bakın.

Fiyatlandırma ve Maliyet Stratejisi: K3 mü, K2.x mi?

Onysoft üzerinde Kimi K3 fiyatlandırması net: girdi $4.50 / 1M token, çıktı $22.50 / 1M token. Asıl önemli detay şu: uzun bağlam ek ücreti yok. Birçok sağlayıcı belli bir eşiğin üzerindeki istemlerde fiyatı kademeli artırırken, K3'te 1M pencerenin tamamında aynı tarife geçerli — dev bağlamlı iş yüklerinde faturayı öngörülebilir kılan ciddi bir avantaj.

Peki her iş için K3 mü? Hayır. Kimi ailesinin ekonomik üyeleri kimi-k2.5, kimi-k2.6 ve kod odaklı kimi-k2.7-code da katalogda; güncel fiyatları model kataloğunda görebilirsiniz. Pratik iş bölümü şöyle:

• K3'e verin: karmaşık muhakeme gerektiren adımlar, repo ölçeğinde kod analizi, görsel + metin birlikte işlenen işler, uzun ajan oturumları.
• K2.x'e verin: yüksek hacimli özetleme, sınıflandırma ve veri çıkarımı gibi basit uçlar; rutin kod tamamlama işlerinde kimi-k2.7-code ekonomik alternatif.
• Senaryonuzun aylık maliyetini maliyet hesaplayıcı ile modelleyin; kademeli model stratejisinin incelikleri için maliyet optimizasyonu rehberimize göz atın.

Kısacası: kaliteyi belirleyen adımlarda K3, hacmi taşıyan adımlarda K2.x — çoğu üretim mimarisinde en iyi fiyat/performans dengesi bu ikili kurgudan çıkıyor.