Cara Menggunakan Kimi K2.7 API

API Kimi K2.7 Code memberi Anda model triliun parameter Moonshot yang disetel untuk pengkodean di balik endpoint yang kompatibel dengan OpenAI. Jika Anda dapat memanggil API OpenAI, Anda juga dapat memanggil yang ini; tukar URL dasar, atur ID model, dan selesai. Ada juga endpoint yang kompatibel dengan Anthropic sehingga langsung masuk ke Claude Code.

Panduan ini mencakup kedua cara untuk mengaksesnya, URL dasar dan ID model yang tepat, kode kerja di curl, Python, dan Node, harga, dan cara menguji semuanya di Apidog sebelum Anda meluncurkannya.

button

TL;DR

URL Dasar: https://api.moonshot.ai/v1 (kompatibel dengan OpenAI). Untuk Claude Code, gunakan https://api.moonshot.ai/anthropic.
ID Model: kimi-k2.7-code pada API Moonshot berbayar per token; kimi-for-coding pada langganan Kimi Code.
Harga: $0,95 per juta token input, $4,00 per juta token output, $0,19 per juta pada cache hits.
Dapatkan kunci di konsol platform Kimi, lalu panggil seperti endpoint OpenAI lainnya.
Model selalu melakukan penalaran (berpikir dipaksakan aktif), jadi harapkan token penalaran di setiap respons.

Dua cara untuk mengakses model

Pilih jalur yang sesuai dengan cara Anda akan menggunakannya.

API pengembang berbayar per token. Penagihan standar berdasarkan penggunaan melalui API Moonshot. ID model kimi-k2.7-code, URL dasar https://api.moonshot.ai/v1. Ini yang Anda inginkan untuk lalu lintas produksi, skrip, dan apa pun yang bersifat programatis.

Langganan Kimi Code. Paket tarif tetap yang terikat pada CLI Kimi Code dan konsol. Kunci dari konsol Kimi Code menggunakan ID model kimi-for-coding dan ditagih berdasarkan kuota yang diperbarui setiap 7 hari, bukan per token. Lebih baik untuk pengkodean interaktif yang intens, di mana biaya per token akan menumpuk.

Sisa panduan ini menggunakan API berbayar per token, karena itu yang Anda panggil dari kode Anda sendiri.

Langkah 1: Dapatkan kunci API

Masuk di konsol platform Kimi.
Buat kunci dan salin. Anda tidak akan melihatnya lagi, jadi simpan di pengelola rahasia atau variabel lingkungan.
Ekspor secara lokal:

export MOONSHOT_API_KEY="sk-your-key-here"

Perlakukan kunci seperti kata sandi. Jangan lakukan commit, dan jangan tempelkan ke kode sisi klien.

Langkah 2: Lakukan permintaan pertama Anda

Endpoint mencerminkan penyelesaian obrolan OpenAI, jadi panggilan curl biasa akan berfungsi:

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": "You are a careful senior engineer."},
      {"role": "user", "content": "Write a Python function that validates an email and returns a clear error message."}
    ]
  }'

Anda akan mendapatkan kembali respons berbentuk OpenAI standar: array choices dengan pesan, ditambah objek usage yang menunjukkan jumlah token input, output, dan penalaran.

Langkah 3: Panggil dari Python

Karena kompatibel dengan OpenAI, SDK resmi openai berfungsi dengan perubahan URL dasar:

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": "Refactor this loop for readability and explain why."},
    ],
)

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

Tidak ada klien baru, tidak ada lapisan HTTP kustom. Kode yang sama yang berbicara dengan GPT sekarang berbicara dengan Kimi.

Langkah 4: Panggil dari Node

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: "Write a Jest test for an empty-input edge case." },
  ],
});

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

Apa yang perlu diketahui tentang perilaku model

Beberapa keunikan membentuk cara Anda memanggilnya.

Penalaran selalu aktif. K2.7 Code memaksakan penalaran dan mempertahankannya di setiap giliran. Setiap respons membawa token penalaran, yang Anda bayar sebagai output. Kelebihannya adalah penalaran sekitar 30% lebih efisien daripada K2.6, jadi biayanya lebih ringan daripada generasi sebelumnya untuk pekerjaan yang sama.

Panggilan alat berfungsi seperti OpenAI. Berikan array tools dengan skema fungsi dan model mengembalikan objek panggilan alat yang Anda jalankan dan masukkan kembali. Ini disetel untuk penggunaan alat multi-langkah, sehingga menangani rantai panjang tanpa kehilangan jejak.

Ini multimodal. Anda dapat mengirim konten gambar dalam array messages untuk tugas-tugas seperti membaca tangkapan layar UI yang gagal atau diagram.

Harga dan batas tarif

Tarif berbayar per token:

Jenis Token	Harga per juta
Input	$0.95
Output (termasuk penalaran)	$4.00
Cache hit	$0.19

Dua hal yang menjaga biaya tetap rendah. Cache hit ditagih dengan sebagian kecil dari harga input, sehingga prompt sistem yang berulang dan konteks bersama menjadi murah. Dan anggaran penalaran yang berkurang berarti lebih sedikit token output per tugas daripada K2.6. Untuk taktik lebih lanjut, lihat panduan kami tentang mengurangi biaya token agen. Jika Anda ingin angka generasi yang lebih lama untuk perbandingan, panduan API Kimi K2.6 dan panduan API DeepSeek V4 kami membahasnya.

Gunakan di dalam Claude Code, Cline, atau Cursor

Anda tidak perlu menulis klien untuk menggunakan K2.7 Code di editor Anda.

Claude Code. Arahkan ke endpoint yang kompatibel dengan Anthropic:

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

Cline dan RooCode. Pilih Moonshot sebagai penyedia, pilih endpoint api.moonshot.ai, tempel kunci Anda, dan pilih kimi-k2.7-code sebagai model. Nonaktifkan alat browser untuk jalankan yang paling lancar.

Cursor. Tambahkan model melalui endpoint kustom yang kompatibel dengan OpenAI dengan URL dasar dan kunci yang sama. Pengaturan ini mencerminkan panduan Kimi-di-Cursor kami; hanya ID model yang berubah.

Uji dan debug API di Apidog

Sebelum Anda menghubungkan API ke agen, konfirmasikan dengan tepat apa yang dikembalikan. Apidog memberi Anda ruang kerja visual untuk mengirim permintaan, memeriksa respons, dan mengunci pengujian.

Buat permintaan POST ke https://api.moonshot.ai/v1/chat/completions.
Tambahkan header Authorization: Bearer {{MOONSHOT_API_KEY}}, simpan kunci sebagai variabel lingkungan Apidog agar tidak pernah dalam bentuk teks biasa.
Kirim body bergaya OpenAI dengan "model": "kimi-k2.7-code" dan messages Anda.
Jalankan. Apidog memformat JSON, menampilkan jumlah token usage, dan menyimpan panggilan.
Ubah panggilan menjadi pengujian: pastikan statusnya 200, bahwa choices[0].message.content tidak kosong, dan bahwa usage.completion_tokens tetap di bawah anggaran yang Anda tetapkan.

Sekarang Anda memiliki uji regresi yang dapat Anda jalankan ulang setiap kali ada pembaruan model. Jika Anda menggunakan panggilan alat model melalui MCP, panduan pengujian server MCP kami menunjukkan pernyataan yang menangkap kontrak alat yang rusak. Unduh Apidog untuk mengaturnya.

FAQ

Apa URL dasar API? https://api.moonshot.ai/v1 untuk panggilan yang kompatibel dengan OpenAI, https://api.moonshot.ai/anthropic untuk Claude Code.

ID model mana yang harus saya gunakan? kimi-k2.7-code pada API berbayar per token. Langganan Kimi Code menggunakan kimi-for-coding.

Apakah ini kompatibel dengan OpenAI? Ya. Format permintaan dan respons cocok dengan penyelesaian obrolan OpenAI, sehingga SDK yang ada berfungsi dengan perubahan URL dasar. Ada juga endpoint yang kompatibel dengan Anthropic.

Berapa biayanya? $0,95 per juta token input, $4,00 per juta token output, dan $0,19 per juta pada cache hit.

Apakah saya selalu membayar token penalaran? Ya. Penalaran dipaksakan aktif, sehingga setiap respons mencakup token penalaran yang ditagih dengan tarif output. Ini masih menggunakan sekitar 30% lebih sedikit daripada K2.6.

Bisakah saya mengirim gambar? Ya. Modelnya multimodal, jadi konten gambar dalam array pesan didukung.

Ringkasan

API Kimi K2.7 Code hanyalah pergantian URL dasar dari klien yang kompatibel dengan OpenAI mana pun: hubungi https://api.moonshot.ai/v1, gunakan ID model kimi-k2.7-code, dan bayar $0,95/$4,00 per juta token. Untuk pengkodean interaktif, langganan Kimi Code dengan tarif tetap menggunakan kimi-for-coding mungkin lebih murah. Ini terhubung ke Claude Code, Cline, RooCode, dan Cursor dengan perubahan konfigurasi, dan Anda dapat memvalidasi semuanya di Apidog sebelum Anda mempercayainya dalam produksi. Dapatkan kunci, kirim panggilan curl di atas, dan periksa penggunaan token untuk melihat bagaimana harga cocok dengan beban kerja Anda.

button