Kimi K2.7 Kod API'si Nasıl Kullanılır

Kimi K2.7 Code API, Moonshot'un OpenAI uyumlu bir uç nokta aracılığıyla kodlamaya ayarlı trilyon parametreli modelini size sunar. OpenAI API'sini çağırabiliyorsanız, bunu da çağırabilirsiniz; temel URL'yi değiştirin, model kimliğini ayarlayın ve hazırsınız. Ayrıca Anthropic uyumlu bir uç nokta da mevcuttur, böylece doğrudan Claude Code'a entegre edilebilir.

Bu kılavuz, erişim için her iki yolu, tam temel URL ve model kimliklerini, curl, Python ve Node'daki çalışan kod örneklerini, fiyatlandırmayı ve dağıtımdan önce tüm sistemi Apidog'da nasıl test edeceğinizi kapsar.

düğme

TL;DR

Temel URL: https://api.moonshot.ai/v1 (OpenAI uyumlu). Claude Code için https://api.moonshot.ai/anthropic kullanın.
Model kimliği: Jeton başına ödemeli Moonshot API'sinde kimi-k2.7-code; Kimi Code aboneliğinde kimi-for-coding.
Fiyatlandırma: Milyon girdi jetonu başına 0,95$, milyon çıktı jetonu başına 4,00$, önbellek isabetleri için milyon başına 0,19$.
Kimi platform konsolundan bir anahtar edinin, ardından herhangi bir OpenAI uç noktası gibi çağırın.
Model her zaman akıl yürütür (düşünme zorunludur), bu nedenle her yanıtta akıl yürütme jetonları bekleyin.

Modele erişmek için iki yol

Nasıl kullanacağınıza uygun yolu seçin.

Jeton başına ödemeli geliştirici API'si. Moonshot API aracılığıyla standart kullanım tabanlı faturalandırma. Model kimliği kimi-k2.7-code, temel URL https://api.moonshot.ai/v1. Bu, üretim trafiği, betikler ve programatik her şey için istediğiniz şeydir.

Kimi Code aboneliği. Kimi Code CLI ve konsoluyla bağlantılı sabit ücretli bir plan. Kimi Code konsolundan alınan anahtarlar, jeton başına değil, her 7 günde bir yenilenen bir kota üzerinden faturalandırılan kimi-for-coding model kimliğini kullanır. Jeton başına maliyetlerin birikeceği yoğun interaktif kodlama için daha iyidir.

Bu kılavuzun geri kalanı, kendi kodunuzdan çağırdığınız API olduğundan, jeton başına ödemeli API'yi kullanır.

Adım 1: Bir API anahtarı alın

Kimi platform konsolunda oturum açın.
Bir anahtar oluşturun ve kopyalayın. Bir daha görmeyeceksiniz, bu yüzden bir sır yöneticisine veya bir ortam değişkenine kaydedin.
Yerel olarak dışa aktarın:

export MOONSHOT_API_KEY="sk-anahtarınız-burada"

Anahtarı bir parola gibi değerlendirin. Sürüm kontrolüne göndermeyin ve istemci tarafı koduna yapıştırmayın.

Adım 2: İlk isteğinizi yapın

Uç nokta OpenAI'nin sohbet tamamlama özelliğini yansıttığı için, basit bir curl çağrısı işe yarar:

curl https://api.moonshot.ai/v1/chat/completions \
  -H "Authorization: Bearer $MOONSHOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kimi-k2.7-code",
    "messages": [
      {"role": "system", "content": "Sen dikkatli bir kıdemli mühendissin."},
      {"role": "user", "content": "Bir e-postayı doğrulayan ve açık bir hata mesajı döndüren bir Python fonksiyonu yaz."}
    ]
  }'

Standart bir OpenAI biçimli yanıt alacaksınız: mesajı içeren bir choices dizisi, ayrıca girdi, çıktı ve akıl yürütme jeton sayılarını gösteren bir usage nesnesi.

Adım 3: Python'dan çağırın

OpenAI uyumlu olduğu için, resmi openai SDK'sı temel URL değişikliğiyle çalışır:

from openai import OpenAI

client = OpenAI(
    api_key=os.environ["MOONSHOT_API_KEY"],
    base_url="https://api.moonshot.ai/v1",
)

resp = client.chat.completions.create(
    model="kimi-k2.7-code",
    messages=[
        {"role": "user", "content": "Bu döngüyü okunabilirlik için yeniden düzenle ve nedenini açıkla."},
    ],
)

print(resp.choices[0].message.content)
print(resp.usage)

Yeni bir istemci yok, özel bir HTTP katmanı yok. GPT ile konuşan aynı kod şimdi Kimi ile konuşuyor.

Adım 4: Node'dan çağırın

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.MOONSHOT_API_KEY,
  baseURL: "https://api.moonshot.ai/v1",
});

const resp = await client.chat.completions.create({
  model: "kimi-k2.7-code",
  messages: [
    { role: "user", content: "Boş girdi uç durumu için bir Jest testi yaz." },
  ],
});

console.log(resp.choices[0].message.content);

Modelin davranışı hakkında bilmeniz gerekenler

Birkaç tuhaflık, onu nasıl çağıracağınızı şekillendirir.

Düşünme her zaman açıktır. K2.7 Code akıl yürütmeyi zorlar ve dönüşler arasında korur. Her yanıt, çıktı olarak ödediğiniz akıl yürütme jetonlarını taşır. İyi tarafı, K2.6'dan yaklaşık %30 daha verimli akıl yürütür, bu nedenle aynı iş için fatura önceki nesilden daha düşüktür.

Araç çağırma OpenAI yöntemiyle çalışır. Fonksiyon şemalarıyla bir tools dizisi geçirin ve model, yürüttüğünüz ve geri beslediğiniz araç çağırma nesnelerini döndürür. Çok adımlı araç kullanımı için ayarlanmıştır, bu nedenle izini kaybetmeden uzun zincirleri yönetir.

Çok modludur. Başarısız bir UI ekran görüntüsünü veya bir diyagramı okuma gibi görevler için messages dizisinde görüntü içeriği gönderebilirsiniz.

Fiyatlandırma ve hız sınırları

Jeton başına ödeme oranları:

Jeton türü	Milyon başına fiyat
Girdi	$0.95
Çıktı (akıl yürütme dahil)	$4.00
Önbellek isabeti	$0.19

İki şey maliyetleri düşük tutar. Önbellek isabetleri girdi fiyatının bir kısmıyla faturalandırılır, bu nedenle tekrarlanan sistem istemleri ve paylaşılan bağlam ucuzlaşır. Ve azaltılmış akıl yürütme bütçesi, K2.6'dan daha az çıktı jetonu anlamına gelir. Daha fazla taktik için, aracı jeton maliyetlerini azaltma kılavuzumuza bakın. Karşılaştırma için eski neslin sayılarını isterseniz, Kimi K2.6 API kılavuzumuz ve DeepSeek V4 API kılavuzumuz bunları kapsar.

Claude Code, Cline veya Cursor içinde kullanın

K2.7 Code'u düzenleyicinizde kullanmak için bir istemci yazmanıza gerek yok.

Claude Code. Anthropic uyumlu uç noktayı işaret edin:

export ANTHROPIC_BASE_URL="https://api.moonshot.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="$MOONSHOT_API_KEY"
export ANTHROPIC_MODEL="kimi-k2.7-code"

Cline ve RooCode. Sağlayıcı olarak Moonshot'u seçin, api.moonshot.ai uç noktasını seçin, anahtarınızı yapıştırın ve model olarak kimi-k2.7-code'u seçin. En sorunsuz çalışma için tarayıcı aracını devre dışı bırakın.

Cursor. Aynı temel URL ve anahtarla OpenAI uyumlu özel bir uç nokta aracılığıyla modeli ekleyin. Kurulum, Kimi-in-Cursor kılavuzumuzu yansıtır; sadece model kimliği değişir.

API'yi Apidog'da test edin ve hata ayıklayın

API'yi bir aracıya bağlamadan önce, tam olarak ne döndürdüğünü doğrulayın. Apidog size istek göndermek, yanıtları incelemek ve testleri kilitlemek için görsel bir çalışma alanı sunar.

https://api.moonshot.ai/v1/chat/completions adresine bir POST isteği oluşturun.
Authorization: Bearer {{MOONSHOT_API_KEY}} başlığını ekleyin, anahtarı bir Apidog ortam değişkeni olarak saklayarak asla düz metin olarak kalmamasını sağlayın.
"model": "kimi-k2.7-code" ve messages'ınızla OpenAI tarzı bir gövde gönderin.
Çalıştırın. Apidog JSON'ı biçimlendirir, usage jeton sayılarını gösterir ve çağrıyı kaydeder.
Çağrıyı bir teste dönüştürün: durumun 200 olduğunu, choices[0].message.content'in boş olmadığını ve usage.completion_tokens'ın belirlediğiniz bir bütçenin altında kaldığını doğrulayın.

Artık her model güncellemesinde yeniden çalıştırabileceğiniz bir regresyon testiniz var. Modelin araç çağrılarını MCP aracılığıyla kullanıyorsanız, MCP sunucu testi kılavuzumuz bozuk araç sözleşmelerini yakalayan iddiaları gösterir. Kurulum için Apidog'u indirin.

SSS

API temel URL'si nedir? OpenAI uyumlu çağrılar için https://api.moonshot.ai/v1, Claude Code için https://api.moonshot.ai/anthropic.

Hangi model kimliğini kullanmalıyım? Jeton başına ödemeli API'de kimi-k2.7-code. Kimi Code aboneliği kimi-for-coding kullanır.

OpenAI uyumlu mu? Evet. İstek ve yanıt formatı OpenAI sohbet tamamlama ile eşleşir, bu nedenle mevcut SDK'lar temel URL değişikliğiyle çalışır. Ayrıca Anthropic uyumlu bir uç nokta da mevcuttur.

Maliyeti ne kadar? Milyon girdi jetonu başına 0,95$, milyon çıktı jetonu başına 4,00$ ve önbellek isabetlerinde milyon başına 0,19$.

Akıl yürütme jetonları için her zaman ödeme yapar mıyım? Evet. Düşünme zorunludur, bu nedenle her yanıt, çıktı oranından faturalandırılan akıl yürütme jetonlarını içerir. Yine de K2.6'dan yaklaşık %30 daha az kullanır.

Görüntü gönderebilir miyim? Evet. Model çok modludur, bu nedenle mesajlar dizisindeki görüntü içeriği desteklenir.

Özet

Kimi K2.7 Code API, herhangi bir OpenAI uyumlu istemciden sadece temel URL değişikliği uzaklığındadır: https://api.moonshot.ai/v1 adresine bağlanın, kimi-k2.7-code model kimliğini kullanın ve milyon jeton başına 0,95$/4,00$ ödeyin. İnteraktif kodlama için, kimi-for-coding ile sabit ücretli Kimi Code aboneliği daha az maliyetli olabilir. Claude Code, Cline, RooCode ve Cursor'a bir yapılandırma değişikliğiyle bağlanır ve üretime almadan önce her şeyi Apidog'da doğrulayabilirsiniz. Bir anahtar alın, yukarıdaki curl çağrısını gönderin ve iş yükünüz için fiyatlandırmanın nasıl olduğunu görmek için jeton kullanımını kontrol edin.

düğme