Kimi AI App Try Now

Kimi API: Kimi K2.5 Entegrasyonu ve Temel Özellikleri

256K bağlam penceresi ve OpenAI uyumlu yapısıyla Kimi K2.5 modelinin gücünü keşfedin ve projelerinize hız kazandırın.

Hemen Başla
Özellikler Kurulum Fiyatlandırma Limitler Çok Modlu Erişim FAQ

Kimi API Temel Özellikleri ve Entegrasyon

Kimi API Temel Özellikleri ve Entegrasyon

Kimi API, Moonshot AI tarafından geliştirilen ve 1 trilyon parametreli MoE mimarisine sahip olan Kimi K2.5 modeline erişim sağlar. Bu model, yerleşik çok modlu yetenekleri, 256K tokenlik geniş bağlam penceresi ve gelişmiş otonom özellikleri ile öne çıkar. REST tabanlı arayüz; üst düzey muhakeme, görsel anlama, belge analizi ve çoklu ajan iş akışları gerektiren uygulamalara entegrasyonu kolaylaştırır. Servise Moonshot resmi platformunun yanı sıra OpenRouter, Together AI ve NVIDIA NIM gibi üçüncü taraf sağlayıcılar üzerinden de erişilebilir.

OpenAI ekosistemine aşina olan geliştiriciler için geçiş süreci oldukça basittir. API, OpenAI SDK yapısıyla tam uyumluluk sunar ve yalnızca temel URL ile API anahtarı değişikliklerini gerektirir. Kimlik doğrulama işlemleri standart Bearer token yöntemiyle gerçekleştirilir. Python ve Node.js için sunulan resmi SDK'lar istek yönetimini kolaylaştırırken, Hugging Face üzerinde paylaşılan açık kaynaklı model ağırlıkları, altyapısı üzerinde tam kontrol isteyen ekiplerin kendi sunucularında kurulum yapmasına olanak tanır.

Bu API'yi rakiplerinden ayıran en önemli özellik, 256K bağlam penceresi ve yerleşik görme yeteneklerini Claude Opus 4.5 modelinden yaklaşık 4 kat daha uygun bir maliyetle sunmasıdır. Karmaşık RAG boru hatları, modelin tüm dokümantasyon setlerini tek seferde işlemesi ve görsel verileri doğal olarak anlamlandırması sayesinde daha efektif hale gelir.

Özellik Detaylar
Güncel Model Kimi K2.5 (kimi-k2.5)
Bağlam Penceresi 262.144 token (256K)
Girdi Türleri Metin, görsel, video, doküman
Kimlik Doğrulama Authorization başlığı ile Bearer token
SDK Desteği Python, Node.js (OpenAI uyumlu)
Sağlayıcılar Moonshot Resmi, OpenRouter, Together AI, NVIDIA NIM

API uç noktaları, sohbet tamamlama işlemleri için OpenAI yapısını yansıtır; JSON yanıtlarını, akış çıktısını ve fonksiyon çağırma özelliklerini destekler. Kimi platformuna API aracılığıyla erişmek, K2.5 modelinin sunduğu Anlık, Düşünme, Ajan ve Ajan Sürüsü gibi tüm operasyonel modlardan tam kapasiteyle yararlanmak anlamına gelir.

  • OpenAI uyumlu REST uç noktaları, sağlayıcı değişikliği sırasında kodun yeniden düzenlenme ihtiyacını azaltır.
  • Akış yanıtları özelliği, üretim sırasında kullanıcı arayüzlerinin kademeli olarak güncellenmesine imkan tanır.
  • Fonksiyon çağırma desteği, araç kullanımı ve yapılandırılmış çıktıların oluşturulmasını sağlar.
  • Yerleşik çok modlu girdi desteği, metinle birlikte görselleri ve videoları doğrudan kabul eder.
  • Otomatik bağlam önbelleğe alma sistemi, tekrarlanan girdi maliyetlerini %75 oranında düşürür.

API ile Nasıl Başlanır

API ile Nasıl Başlanır

Kayıt işlemi sadece birkaç dakika sürer. platform.moonshot.ai adresini ziyaret ederek e-posta doğrulamasıyla hesap oluşturabilir ve API anahtarları bölümüne ilerleyebilirsiniz. Platform, yaygın entegrasyon senaryolarını kapsayan kod örnekleriyle birlikte kapsamlı bir dokümantasyon sunar.

  1. platform.moonshot.ai adresine gidin ve e-posta adresinizi doğrulayarak kayıt olun.
  2. Geliştirici panelindeki API Anahtarları sekmesine gidin.
  3. İlk API anahtarınızı oluşturun ve güvenli bir yere kaydedin.
  4. OpenAI Python SDK'sını kurun veya doğrudan cURL komutlarını kullanın.
from openai import OpenAI

client = OpenAI(
    api_key="moonshot_api_anahtariniz",
    base_url="https://api.moonshot.cn/v1"
)

response = client.chat.completions.create(
    model="kimi-k2.5",
    messages=[
        {"role": "system", "content": "Siz yardımcı bir asistansınız."},
        {"role": "user", "content": "MoE mimarisini açıklayın."}
    ],
    temperature=0.7
)

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

Bu kod yapısı OpenAI API çağrılarıyla tamamen aynı mantıkta çalışır. GPT modellerinden bu yapıya geçmek için sadece base_url ve api_key parametrelerini güncellemeniz yeterlidir. Mevcut hata ayıklama, yeniden deneme mantığı ve akış uygulamaları herhangi bir modifikasyon gerektirmeden çalışmaya devam eder.

API Fiyatlandırma Bilgileri

API Fiyatlandırma Bilgileri

Kimi K2.5, farklı sağlayıcılar arasında rekabetçi fiyatlar sunar. Resmi API üzerindeki otomatik bağlam önbelleğe alma özelliği, tekrarlanan metin blokları için girdi maliyetlerini önemli ölçüde azaltır.

Sağlayıcı Girdi (1M token başı) Çıktı (1M token başı) Önbelleğe Alınmış Girdi
Moonshot Resmi 0,60 $ 3,00 $ 0,15 $ (%75 indirimli)
OpenRouter 0,45 $ 2,20 $ Değişken
Together AI 0,50 $ 2,80 $ Değişken

2026 yılı itibarıyla geçerli olan bu fiyatlar, Kimi K2.5 modelini benzer yeteneklere sahip üst düzey modellere göre stratejik bir konuma yerleştirir. Otomatik bağlam önbelleğe alma özelliği, aynı sistem komutu veya doküman ön eki kullanıldığında herhangi bir ek kod yazılmasına gerek kalmadan şeffaf bir şekilde devreye girer.

Hız Limitleri ve Kullanım Katmanları

Hız Limitleri ve Kullanım Katmanları

Resmi API, hesapta biriken toplam bakiye tutarına göre belirlenen kademeli bir sistem kullanır. Daha yüksek katmanlar, aynı anda gönderilebilecek istek sayısını ve dakikalık limitleri artırır.

Katman Toplam Bakiye Eşzamanlı İstek Dakikalık İstek (RPM)
Katman 1 10 $ 50 200
Katman 2 100 $ 100 500
Katman 3 500 $ 300 2.000
Katman 5 3.000 $ 1.000 10.000

Kurumsal seviyede daha yüksek limitlere ihtiyaç duyan projeler için Moonshot AI satış ekibiyle iletişime geçilerek özel hız limitleri planlanabilir.

Çok Modlu API Kullanım Yöntemleri

Çok Modlu API Kullanım Yöntemleri

Kimi K2.5 modelinin yerleşik çok modlu yapısı, API isteklerinde görsellerin ve videoların doğrudan işlenmesine olanak tanır. MoonViT-3D kodlayıcısı, farklı çözünürlükteki girdileri istemci tarafında yeniden boyutlandırmaya gerek kalmadan analiz eder.

response = client.chat.completions.create(
    model="kimi-k2.5",
    messages=[
        {
            "role": "user",
            "content": [
                {"type": "text", "text": "Bu grafiği açıklayın ve verileri çıkarın."},
                {"type": "image_url", "image_url": {"url": "https://ornek.com/grafik.png"}}
            ]
        }
    ]
)

Modelin görsel yetenekleri OCRBench üzerinde %92,3 ve InfoVQA üzerinde %92,6 başarı puanına sahiptir. Bu performans verileri Kimi K2.5'i belge çözümleme, grafik analizi ve görsellerden veri çıkarma konularında oldukça güçlü kılar. Video girişleri ise karelere bölünerek veya video URL'si üzerinden iletilebilir.

Alternatif Erişim ve Dağıtım Seçenekleri

Alternatif Erişim ve Dağıtım Seçenekleri

Resmi API kullanımına ek olarak, Kimi K2.5 modeline çeşitli üçüncü taraf platformlar ve yerel kurulum yöntemleri ile erişmek mümkündür.

  • OpenRouter platformu üzerinden farklı yapay zeka sağlayıcıları için tek bir faturalandırma sistemiyle erişim sağlanabilir.
  • Together AI altyapısı kullanılarak düşük gecikme süreli ve optimize edilmiş bir çıkarım performansı elde edilebilir.
  • NVIDIA NIM aracılığıyla kurumsal mikroservis ekosistemine entegrasyon gerçekleştirilebilir.
  • Hugging Face üzerindeki ağırlıklar ile blok-fp8 formatında yerel sunucularda dağıtım yapılabilir.

Sıkça Sorulan Sorular

Kimi API OpenAI SDK ile uyumlu mu?

Sistem tamamen uyumludur. Temel URL adresini api.moonshot.cn/v1 olarak değiştirip Moonshot API anahtarınızı tanımlamanız yeterlidir. Sohbet tamamlama, fonksiyon çağırma ve yapılandırılmış çıktılar gibi tüm fonksiyonlar aynı şekilde çalışır. Bağlantı parametreleri dışında köklü bir kod değişikliği yapmanız gerekmez.

Maksimum bağlam penceresi ne kadardır?

Kimi K2.5 istek başına 262.144 token (256K) desteği sunar. Bu kapasite, büyük kod tabanlarının veya uzun doküman setlerinin herhangi bir bölme işlemi yapılmadan tek bir API çağrısı ile işlenmesine olanak tanır.

Bağlam önbelleğe alma nasıl çalışır?

Aynı sistem komutu veya doküman ön eki ardışık isteklerde tekrarlandığında otomatik olarak aktifleşir. Önbelleğe alınan her milyon token başına maliyet 0,15 $'dır. Süreç sistem tarafından şeffaf bir şekilde yönetildiği için manuel bir ayar yapılmasına gerek yoktur.

Modeli kendi sunucumda çalıştırabilir miyim?

Kimi K2.5 modeli Değiştirilmiş MIT Lisansı ile açık kaynaklıdır. Model ağırlıkları Hugging Face üzerinden indirilip vLLM veya Docker gibi araçlarla dağıtılabilir. 1T parametreli tam modelin çalıştırılması için kapsamlı çoklu GPU kurulumları gereklidir.

Kimi API hangi görsel formatları destekler?

Yerleşik MoonViT-3D kodlayıcısı sayesinde popüler görsel formatlarını ve video karelerini çok modlu girdi olarak destekler.

Hangi programlama dilleri destekleniyor?

Resmi olarak Python ve Node.js için SDK sunulsa da, OpenAI uyumlu REST yapısı sayesinde HTTP istekleri atabilen tüm dillerle kullanılabilir.