DEV Community

Cover image for Kimi K2.6 API Nasıl Kullanılır?
Tobias Hoffmann
Tobias Hoffmann

Posted on • Originally published at apidog.com

Kimi K2.6 API Nasıl Kullanılır?

Moonshot AI'ın Kimi K2.6 duyurusu, onu kodlama, uzun vadeli yürütme ve ajan sürüleri için açık kaynaklı yeni bir sanat eseri olarak konumlandırıyor. Gücünü sağlayan API, OpenAI uyumlu olup https://api.moonshot.ai/v1 adresinde barındırılmakta ve platform üzerinde belgelendirilmiştir. OpenAI SDK'sını kurduysanız, yaklaşık beş dakika içinde gerçek istekler gönderebilirsiniz.

Apidog'u bugün deneyin

Bu kılavuzda kimlik doğrulama, ilk istek, akış, araç çağırma, görsel ve video girişi, düşünme modu ve 300 alt ajana kadar Agent Swarm'ı kullanmayı adım adım gösteriyoruz. Ayrıca entegrasyon kodu yazmadan önce her uç noktayı Apidog ile nasıl test edeceğinizi pratiğe döküyoruz.

💡 Hızlı Yol: Herhangi bir entegrasyon kodunu kaydetmeden önce Kimi K2.6 API'sini Apidog'da görsel olarak test edin. Tek içe aktarma, tek Bearer token ve tam geçmiş ile şema doğrulamasıyla gerçek zamanlı akışlı istekler yapın.

TL;DR: 60 Saniyede Kimi K2.6 API

  • Temel URL: https://api.moonshot.ai/v1
  • Uç Nokta: POST /chat/completions
  • Model Kimlikleri: kimi-k2.6, kimi-k2.6-thinking
  • Kimlik Doğrulama: Authorization: Bearer $KIMI_API_KEY
  • Biçim: OpenAI sohbet tamamlama şeması (mesajlar, araçlar, akış vs.)
  • Bağlam: 262.144 giriş belirteci, muhakeme için 98.304’e kadar çıktı belirteci
  • Varsayılanlar: sıcaklık 1.0, top-p 1.0 (Moonshot resmi rehberi)

Minimal curl örneği:

curl https://api.moonshot.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $KIMI_API_KEY" \
  -d '{
    "model": "kimi-k2.6",
    "messages": [{"role": "user", "content": "Bir diziyi tersine çeviren bir Python fonksiyonu yazın."}]
  }'
Enter fullscreen mode Exit fullscreen mode

Hepsi bu kadar. Aşağıdaki adımlar, Agent Swarm ve Moonshot'un 4.000 adımlık yürütme sınırı gibi detayları uygulamalı şekilde kapsar.

Apidog'da Kimi K2.6

Bu API ile Neler Yapabilirsiniz?

Kimi K2.6 duyurusuna göre, API üretimde aşağıdakileri kapsar:

  • 12+ saat çalışan kodlama ajanları (Qwen3.5-0.8B Mac çıkarım demosu: 4.000+ araç çağrısı, 15’ten 193 token/sn’ye verim).
  • Çok günlük oturumlar üzerinden otonom altyapı yönetimi.
  • Rust, Go, Python ve Zig genelinde uzun vadeli güvenilirlik.
  • 300 alt ajana kadar çıkan ajan sürüleri ve 4.000+ koordineli adım.
  • Tek istemden kimlik doğrulama, veritabanı ve işlemlerle tam yığın uygulama üretimi.
  • Görsel + Python araç işlem hatları (Python ile MathVision: %93,2).

Claude Code bilgisayar kullanımı, kendi Claude Code’unuzu oluşturma veya Cursor Composer 2 gibi araçlar geliştiriyorsanız, K2.6 API’si doğrudan model katmanında alternatif sunar.

Adım 1: API Anahtarı Edinin

  1. platform.moonshot.ai veya platform.kimi.ai adresinde hesap oluşturun.
  2. Hesabınızı doğrulayın (Uluslararası kullanıcılar SMS doğrulaması görebilir).
  3. Fatura bilgisi ekleyin. Çoğu yeni hesapta küçük ücretsiz bakiye olur.
  4. Kontrol panelinde API Anahtarları'na girin, Anahtar Oluştur'a tıklayın.
  5. Anahtarı hemen kopyalayın (tek seferlik görünür).
  6. Ortam değişkeni olarak ekleyin: 
export KIMI_API_KEY="sk-..."
Enter fullscreen mode Exit fullscreen mode

Bunu .zshrc, .bashrc veya bir gizli anahtar yöneticisine kaydedin. Asla kod repolarına dahil etmeyin.

Ücretsiz kullanım yolları için: Kimi K2.6’yı Ücretsiz Nasıl Kullanılır rehberine bakın.

Adım 2: SDK’nızı Seçin

API, OpenAI ile uyumludur. Temel URL’yi değiştirerek resmi OpenAI SDK’larını kullanabilirsiniz.

Seçenek Kurulum En iyi olduğu alan
curl yerleşik Hızlı testler, CI
OpenAI Python pip install openai Python hizmetleri
OpenAI Node npm install openai JS/TS uygulamaları

Python 

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("KIMI_API_KEY"),
    base_url="https://api.moonshot.ai/v1",
)

response = client.chat.completions.create(
    model="kimi-k2.6",
    messages=[{"role": "user", "content": "Fransa'nın başkenti neresidir?"}],
)

print(response.choices[0].message.content)
Enter fullscreen mode Exit fullscreen mode

Node.js 

import OpenAI from "openai";

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

const response = await client.chat.completions.create({
  model: "kimi-k2.6",
  messages: [{ role: "user", content: "Fransa'nın başkenti neresidir?" }],
});

console.log(response.choices[0].message.content);
Enter fullscreen mode Exit fullscreen mode

curl 

curl https://api.moonshot.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $KIMI_API_KEY" \
  -d '{
    "model": "kimi-k2.6",
    "messages": [{"role": "user", "content": "Fransa'nın başkenti neresidir?"}]
  }'
Enter fullscreen mode Exit fullscreen mode

Tüm yöntemler aynı yanıt biçimini döndürür.

Adım 3: İstek Gövdesini Anlayın

OpenAI sohbet tamamlaması ile aynı alanlar:

{
  "model": "kimi-k2.6",
  "messages": [
    { "role": "system", "content": "Sen yardımcı bir asistansın." },
    { "role": "user", "content": "İsteminiz burada." }
  ],
  "temperature": 1.0,
  "top_p": 1.0,
  "max_tokens": 8192,
  "stream": false,
  "tools": [],
  "tool_choice": "auto",
  "thinking": { "type": "disabled" }
}
Enter fullscreen mode Exit fullscreen mode

Notlar:

  • Varsayılanlar yüksektir. Resmi blog sıcaklık 1.0 ve top-p 1.0’ı önerir.
  • thinking, kimi-k2.6-thinking üzerinde muhakeme izini açar. Hızlı yanıtlar için {"type": "disabled"} kullanılır.

Adım 4: Akış

Akış (stream), UI ve uzun yanıtlar için önerilir. Büyük çıktılar (98.304 token’a kadar) için gereklidir.

Python 

stream = client.chat.completions.create(
    model="kimi-k2.6",
    messages=[{"role": "user", "content": "MoE modelleri hakkında 500 kelimelik bir deneme yazın."}],
    stream=True,
)

for chunk in stream:
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="", flush=True)
Enter fullscreen mode Exit fullscreen mode

Node.js 

const stream = await client.chat.completions.create({
  model: "kimi-k2.6",
  messages: [{ role: "user", content: "MoE modelleri hakkında 500 kelimelik bir deneme yazın." }],
  stream: true,
});

for await (const chunk of stream) {
  const delta = chunk.choices[0]?.delta?.content;
  if (delta) process.stdout.write(delta);
}
Enter fullscreen mode Exit fullscreen mode

Akış, araç çağrılarıyla da çalışır; JSON deltalarıyla argümanlar birleştirilir.

Adım 5: Araç Çağırma

Moonshot, Toolathlon skorunda %50,0 ve iş ortağı testlerinde %96,60 araç çağırma başarısı bildiriyor. Standart OpenAI fonksiyon çağırma şeması kullanılır.

Araçları Tanımla 

tools = [
    {
        "type": "function",
        "function": {
            "name": "get_weather",
            "description": "Bir konumdaki mevcut hava durumunu alın.",
            "parameters": {
                "type": "object",
                "properties": {
                    "location": {"type": "string", "description": "Şehir adı"},
                    "unit": {"type": "string", "enum": ["celsius", "fahrenheit"]}
                },
                "required": ["location"]
            }
        }
    }
]
Enter fullscreen mode Exit fullscreen mode

İlk Çağrı (Model Karar Verir) 

import json

messages = [{"role": "user", "content": "Tokyo'da hava nasıl?"}]

resp = client.chat.completions.create(
    model="kimi-k2.6",
    messages=messages,
    tools=tools,
    tool_choice="auto",
)

msg = resp.choices[0].message
messages.append(msg)

if msg.tool_calls:
    for call in msg.tool_calls:
        args = json.loads(call.function.arguments)
        result = fetch_weather(args["location"], args.get("unit", "celsius"))
        messages.append({
            "role": "tool",
            "tool_call_id": call.id,
            "content": json.dumps(result),
        })
Enter fullscreen mode Exit fullscreen mode

İkinci Çağrı (Nihai Yanıt) 

final = client.chat.completions.create(
    model="kimi-k2.6",
    messages=messages,
    tools=tools,
)
print(final.choices[0].message.content)
Enter fullscreen mode Exit fullscreen mode

K2.6, çok adımlı araç zincirlerinde güçlüdür. Kimi Code gibi uzun kodlama ajanları için uygundur. Kıyas için Claude Code iş akışları döngüsüne bakabilirsiniz.

Adım 6: Görsel Giriş

K2.6, MMMU-Pro'da %79,4 ve V*'de %96,9 puan alır. Görüntüler OpenAI’ın image_url biçimiyle gönderilir:

response = client.chat.completions.create(
    model="kimi-k2.6",
    messages=[
        {
            "role": "user",
            "content": [
                {"type": "text", "text": "Bu görüntüyü tek bir cümleyle açıklayın."},
                {"type": "image_url", "image_url": {"url": "https://example.com/photo.jpg"}}
            ]
        }
    ],
)
Enter fullscreen mode Exit fullscreen mode

Yerel dosyalar için base64 kullanın:

import base64
with open("photo.jpg", "rb") as f:
    b64 = base64.b64encode(f.read()).decode("utf-8")

image_url = f"data:image/jpeg;base64,{b64}"
Enter fullscreen mode Exit fullscreen mode

OCR veya diyagramlar için metin talimatlarıyla birlikte görsel ekleyin. Matematik için Python yorumlayıcı aracı ekleyin.

Adım 7: Video Girişi

Video URL'si ya da kare dizisi iletilebilir:

response = client.chat.completions.create(
    model="kimi-k2.6",
    messages=[
        {
            "role": "user",
            "content": [
                {"type": "text", "text": "Bu videoda neler olduğunu özetleyin."},
                {"type": "video_url", "video_url": {"url": "https://example.com/clip.mp4"}}
            ]
        }
    ],
)
Enter fullscreen mode Exit fullscreen mode

Kısa videolarda tek çağrı yeterli, uzunlarda akış kullanın.

Adım 8: Düşünme Modu

kimi-k2.6-thinking, görünür muhakeme izi üretir. Moonshot, düşünme modu açıkken yüksek başarı bildiriyor.

Düşünme açık (varsayılan):

response = client.chat.completions.create(
    model="kimi-k2.6-thinking",
    messages=[{"role": "user", "content": "sqrt(2)'nin irrasyonel olduğunu kanıtlayın."}],
)
Enter fullscreen mode Exit fullscreen mode

Düşünme kapalı:

response = client.chat.completions.create(
    model="kimi-k2.6-thinking",
    messages=[{"role": "user", "content": "Hızlı: 17 * 23 kaç eder?"}],
    extra_body={"thinking": {"type": "disabled"}},
)
Enter fullscreen mode Exit fullscreen mode

Muhakeme izi yanıtın reasoning alanında döner. İsterseniz sadece sonucu kullanıcıya gösterin.

Adım 9: Ajan Sürüsü (Agent Swarm)

Ajan Sürüsü, en çok dikkat çeken özellik. Kimi K2.6 blogu: 300 alt ajan, 4.000+ adım.

Ekstra parametreyle çağırın:

response = client.chat.completions.create(
    model="kimi-k2.6",
    messages=[{
        "role": "user",
        "content": "Duyarlı tasarıma ve haber bülteni kayıt formuna sahip bir kahve markası için 5 sayfalık bir pazarlama sitesi oluşturun."
    }],
    extra_body={
        "agent": {
            "type": "swarm",
            "max_agents": 30,
            "max_steps": 4000
        }
    },
)
Enter fullscreen mode Exit fullscreen mode

Pratik ipuçları:

  1. Akış kullanın: İlerlemeyi izleyin, gerekirse erken durdurun.
  2. max_agents değerini sınırla: Çoğu görev için 10–30 idealdir.
  3. Bütçe belirleyin: Token kullanımı hızlı artabilir; her yanıtta usage değerini loglayın.

Adım 10: Her Şeyi Apidog ile Test Edin

Farklı gövde biçimleri, başlıklar ve yanıt formatları için Apidog ile görsel test yapın.

Apidog'un Kimi K2.6'yı test etmek için görsel kullanıcı arayüzü

Apidog'da Kimi K2.6 Kurulumu

  1. Apidog'u indirin ve bir proje oluşturun.
  2. Ortam: BASE_URL = https://api.moonshot.ai/v1, KIMI_API_KEY = sk-....
  3. Yeni API isteği: POST {{BASE_URL}}/chat/completions
  4. Başlıklar: Authorization: Bearer {{KIMI_API_KEY}}, Content-Type: application/json
  5. Gövde örneği: 
{
  "model": "kimi-k2.6",
  "messages": [{ "role": "user", "content": "Merhaba, Kimi K2.6!" }],
  "stream": true
}
Enter fullscreen mode Exit fullscreen mode
  1. Gönder'e tıklayın. Token’lar gerçek zamanlı olarak akar.

Apidog'un Ekledikleri

  • OpenAI sohbet tamamlama şemasına karşı şema doğrulaması
  • İstek geçmişi ile çağrı tekrarı
  • Tek tıklamayla ortam geçişi
  • Ekip paylaşımı (ör: 50+ mühendislik ekibi için API testi)
  • Sahte sunucular ile offline test
  • SSE akış desteği (Kimi'nin akış biçimini destekler)

Ayrıca Apidog'un bir VS Code eklentisi ile doğrudan editörden test mümkündür. Postman’dan çıkmak için Postman olmadan API testi nasıl yapılır rehberine bakın.

Hata Yönetimi

Moonshot standart HTTP kodları döner:

  • 400: Kötü istek (gövde hatası, model adı yanlış).
  • 401: Kimlik doğrulama hatası (anahtar eksik/yanlış/süresi dolmuş).
  • 429: Oran limiti veya kota bitti.
  • 500: Sunucu hatası (üstel geri çekilme ile yeniden deneyin).
  • 529: Aşırı yükleme, kısa süre bekleyip tekrar deneyin.

Tekrar deneme için örnek sarmalayıcı:

import time
from openai import OpenAI, RateLimitError, APIError

def call_kimi(messages, max_retries=5):
    for attempt in range(max_retries):
        try:
            return client.chat.completions.create(
                model="kimi-k2.6",
                messages=messages,
            )
        except RateLimitError:
            time.sleep(2 ** attempt)
        except APIError as e:
            if e.status_code >= 500 and attempt < max_retries - 1:
                time.sleep(2 ** attempt)
            else:
                raise
    raise RuntimeError("Kimi K2.6 denemelerden sonra başarısız oldu")
Enter fullscreen mode Exit fullscreen mode

Akış ortasında kesilirse, alınan token’ları takip edin ve "buradan devam et" talimatı ile tekrar başlatın.

Maliyet Kontrolü

Moonshot fiyatlandırması: kimi.com/membership/pricing

Üretim için öneriler:

  • max_tokens değerini sınırlayın. 2.048 çoğu sohbet için yeterlidir.
  • Sistem istemlerini önbelleğe alın. Tekrarlanan mesajlarda kazanç sağlar.
  • usage değerini loglayın. Her yanıtta prompt_tokens, completion_tokens, total_tokens döner. Prometheus vb. ile izleyin.

Üretim Deseni: GitHub Sorun Düzeltici

Kimi K2.6 ile kod tabanında otomatik hata düzeltici bir ajan:

from openai import OpenAI
import os, json

client = OpenAI(
    api_key=os.getenv("KIMI_API_KEY"),
    base_url="https://api.moonshot.ai/v1",
)

tools = [
    {"type": "function", "function": {
        "name": "read_file",
        "description": "Repo'daki bir dosyayı oku.",
        "parameters": {
            "type": "object",
            "properties": {"path": {"type": "string"}},
            "required": ["path"]
        }
    }},
    {"type": "function", "function": {
        "name": "search_code",
        "description": "Kod tabanında bir deseni ripgrep ile ara.",
        "parameters": {
            "type": "object",
            "properties": {"query": {"type": "string"}},
            "required": ["query"]
        }
    }},
    {"type": "function", "function": {
        "name": "run_tests",
        "description": "Proje test paketini çalıştır.",
        "parameters": {"type": "object", "properties": {}}
    }},
]

def tool_dispatch(name, args):
    if name == "read_file":
        with open(args["path"]) as f:
            return f.read()
    if name == "search_code":
        return run_ripgrep(args["query"])
    if name == "run_tests":
        return run_pytest()
    raise ValueError(f"Bilinmeyen araç: {name}")

messages = [
    {"role": "system", "content": "Sen kıdemli bir mühendissin. Açıklanan hatayı düzelt."},
    {"role": "user", "content": "Sorun: yavaş ağlarda giriş formu iki kez gönderiliyor."}
]

while True:
    resp = client.chat.completions.create(
        model="kimi-k2.6",
        messages=messages,
        tools=tools,
    )
    msg = resp.choices[0].message
    messages.append(msg)

    if not msg.tool_calls:
        print(msg.content)
        break

    for call in msg.tool_calls:
        result = tool_dispatch(call.function.name, json.loads(call.function.arguments))
        messages.append({
            "role": "tool",
            "tool_call_id": call.id,
            "content": result,
        })
Enter fullscreen mode Exit fullscreen mode

Agent Swarm'a ölçeklemek için extra_body parametresi eklenebilir. İnsan müdahalesi gerektiren kontrol noktaları için Hermes çoklu ajan yığını ile entegre edin.

SSS

Moonshot'a özel bir SDK'ya ihtiyacım var mı?

Hayır. OpenAI Python ve Node SDK'ları, base_url değiştirilerek doğrudan çalışır.

API'nin hız sınırı var mı?

Evet. Sınırlar kademenize göre değişir, kontrol panelinden görebilirsiniz.

Kimi K2.6, LangChain, LlamaIndex, Vercel AI SDK ile çalışır mı?

Evet, OpenAI uyumlu temel URL kabul eden her çerçeveyle çalışır.

Kimi K2.6, JSON modunu destekliyor mu?

Evet. response_format: {"type": "json_object"} ya da katı şemalar için {"type": "json_schema", ...} kullanın.

Bağlam penceresi ne kadar büyük?

Resmi bloga göre 262.144 giriş, 98.304 çıktı belirteci.

API ile ince ayar yapılabilir mi?

Şu an hayır. Açık ağırlıkları HuggingFace üzerinden kendi donanımınızda çalıştırabilirsiniz.

kimi-k2.6 ve kimi-k2.6-thinking farkı nedir?

kimi-k2.6 hızlı ajan modeli, kimi-k2.6-thinking ise muhakeme adımlarını açar (AIME 2026: %96,4, GPQA-Diamond: %90,5).

Ücretsiz katman var mı?

Cloudflare Workers AI, kimi.com sohbeti ve Kimi K2.6 ücretsiz erişim rehberi ile erişim mümkün.

Özet

Kimi K2.6 API’si, temel URL ve API anahtarını değiştirerek tüm OpenAI uyumlu zincirlere entegre olur. 262K bağlam penceresi, 300 alt ajanlı Agent Swarm, %96,60 araç çağırma başarısı ve açık kaynak ağırlıkları sunar.

Yeni entegrasyonlarda, tüm uç noktaları önce Apidog ile test edin. Şema ve kimlik doğrulama hataları kod tabanınıza ulaşmadan yakalanır. Sonrasında çalışan istekleri Python veya Node hizmetinize aktarabilirsiniz.

Referanslar ve İleri Okumalar

Top comments (0)