Cara Menggunakan Kimi K3.1 Pro: Panduan Lengkap

Berikut cara menggunakan Kimi K3.1 Pro melalui empat jalur: mengobrol dengannya di aplikasi web atau seluler Kimi, memanggil kimi-k3.1-pro melalui API yang kompatibel dengan OpenAI di https://api.moonshot.ai/v1, menjalankannya di dalam Kimi Code CLI dengan keanggotaan berbayar, atau mengarahkan Codex, Claude Code, atau OpenCode ke endpoint Moonshot. API terbuka setelah top-up $1 dan berbiaya $2 per juta token input serta $10 per juta token output.

Moonshot AI merilis Kimi K3.1 Pro pada 23 Oktober 2026. Ini adalah versi pasca-latih (post-trained) dari Kimi K3 dengan desain MoE 2,8T parameter yang sama (sekitar 104B aktif), jendela konteks 1.048.576 token, dan thinking yang selalu aktif. Jika Anda ingin latar belakangnya terlebih dahulu, baca apa itu Kimi K3.1 Pro. Jika Anda ingin tanpa mengeluarkan biaya sama sekali, panduan kami tentang menggunakan Kimi K3.1 Pro secara gratis membahas jalur $0. Setiap fakta di bawah ini berasal dari pengumuman Moonshot, panduan cepat API, dan halaman harga, yang dibaca pada 24 Oktober 2026.

Jalur Kimi K3.1 Pro mana yang harus Anda pilih?

Pilih berdasarkan apa yang Anda bangun. Chat cocok untuk pertanyaan cepat, API cocok untuk aplikasi, Kimi Code cocok untuk anggota yang menginginkan agen tanpa perlu mengelola kunci, dan agen Anda sendiri cocok untuk tim yang sudah berkecimpung di Codex atau Claude Code.

Gunakan Kimi K3.1 Pro di aplikasi web dan seluler Kimi

Aplikasi chat adalah cara tercepat untuk masuk. Buka aplikasi web Kimi atau aplikasi iOS, Android, atau HarmonyOS, masuk dengan akun gratis, dan K3.1 Pro sudah menjadi model default di composer, dengan thinking effort disetel ke High.

Sebelum Anda masuk, composer juga menampilkan K2.8 Preview dan Instant. Mengirim prompt memerlukan akun. Moonshot tidak memublikasikan kuota pesan K3.1 Pro untuk paket gratis [VERIFY], jadi anggap chat sebagai ajang uji coba, bukan saluran produksi.

Kimi Work desktop 3.1.0 dan versi setelahnya (Windows dan Mac dengan Apple silicon) juga menjalankan model ini. Pada Kimi Business dan Enterprise, admin harus mengaktifkannya, karena secara default fitur ini nonaktif saat peluncuran.

API Kimi K3.1 Pro: panggilan pertama di Python dan cURL

API Kimi K3.1 Pro kompatibel dengan OpenAI, jadi SDK openai standar berfungsi dengan base URL yang diubah. Penyiapannya memerlukan tiga langkah:

1. Top-up minimal $1. K3.1 Pro adalah model unggulan dan hanya terbuka setelah top-up berhasil.
2. Buat kunci di konsol kunci API dan ekspor sebagai MOONSHOT_API_KEY.
3. Panggil model kimi-k3.1-pro (atau kimi-k3.1-pro-highspeed) di https://api.moonshot.ai/v1.

Berikut contoh Python resmi dari Moonshot:

import os
from openai import OpenAI
client = OpenAI(api_key=os.environ["MOONSHOT_API_KEY"], base_url="https://api.moonshot.ai/v1")
completion = client.chat.completions.create(
    model="kimi-k3.1-pro",
    reasoning_effort="high",
    messages=[{"role": "user", "content": "Introduce Kimi K3.1 Pro in one sentence."}],
)
print(completion.choices[0].message.content)

Panggilan yang sama dalam cURL:

curl https://api.moonshot.ai/v1/chat/completions \
  --header "Authorization: Bearer $MOONSHOT_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"model": "kimi-k3.1-pro","reasoning_effort": "high","messages": [{"role": "user", "content": "Introduce Kimi K3.1 Pro in one sentence."}]}'

Model ini menerima teks, gambar, dan video sebagai input (panduan cepat menunjukkan bagian image_url dan video_url) serta mengembalikan teks. Anda juga dapat mencoba prompt di Playground sebelum menulis kode. Untuk pola era K3 yang masih berlaku, lihat panduan API Kimi K3 kami.

Reasoning effort Kimi K3.1 Pro: low, high, atau max

reasoning_effort adalah field permintaan tingkat atas yang mengatur seberapa banyak model berpikir sebelum menjawab. Field ini menerima "low", "high", dan "max", dengan default "max". Thinking tidak dapat dimatikan. Tidak ada tingkat "medium".

Panduan reasoning effort dari Moonshot memuat referensi lengkapnya. Karena Anda membayar token output sebesar $10 per juta, menurunkan dari max ke low pada panggilan sederhana adalah penghematan termudah yang bisa Anda temukan. Jangan sertakan temperature dan top_p: panduan cepat mencantumkannya sebagai nilai tetap 1.0 dan 0.95.

Streaming reasoning, pertahankan status multi-turn, dapatkan kembali JSON

Tiga perilaku API sering membuat orang bingung, dan masing-masing punya aturan sederhana.

Streaming. Respons yang di-stream mengirim delta reasoning_content dan content secara terpisah. Tampilkan atau catat yang pertama, render yang kedua:

stream = client.chat.completions.create(
    model="kimi-k3.1-pro", reasoning_effort="low", stream=True,
    messages=[{"role": "user", "content": "Explain MoE routing briefly."}],
)
for chunk in stream:
    delta = chunk.choices[0].delta
    thinking = getattr(delta, "reasoning_content", None)
    if thinking:
        print(thinking, end="")
    if delta.content:
        print(delta.content, end="")

Multi-turn dan pemanggilan tool. Kirim kembali pesan asisten secara utuh, bukan hanya content-nya. Dokumentasi Moonshot menegaskan hal ini, dan ini paling penting ketika pemanggilan tool terlibat:

messages.append(completion.choices[0].message)  # whole message, not .content
messages.append({"role": "user", "content": "Now add tests."})

tool_choice: "required" didukung ketika Anda memerlukan model untuk memanggil sebuah tool. Mode parsial juga berfungsi: akhiri pesan Anda dengan pesan asisten yang memiliki "partial": true dan model akan melanjutkannya.

Output terstruktur. Berikan response_format dengan tipe json_schema dan strict: true, lalu parse hanya message.content. Jangan pernah mem-parse teks reasoning.

Kimi Code K3.1 Pro: jalur keanggotaan

Kimi Code adalah agen coding terminal milik Moonshot sendiri, dan inilah jalur tanpa kunci API. Anda masuk dengan akun Kimi Anda sebagai gantinya. Ini adalah manfaat keanggotaan, jadi paket gratis Adagio tidak mencakupnya.

Pasang dan masuk:

# macOS / Linux
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash
# Windows PowerShell: irm https://code.kimi.com/kimi-code/install.ps1 | iex
kimi

Di dalam sesi, jalankan /login, lalu /model untuk memilih K3.1 Pro. Kedua ID tersebut dipetakan ke tingkat paket:

• k3.1-pro: Moderato (Plus) dan di atasnya. Allegretto (Pro) dan di atasnya membuka konteks hingga 1M.
• k3.1-pro-highspeed: Allegretto (Pro) dan di atasnya, menggunakan sekitar 2x kuota.

Pada harga keanggotaan, Plus adalah $15 per bulan dengan penagihan tahunan ($19 bulanan) dan Pro adalah $31 tahunan ($39 bulanan). Dokumentasi Kimi Code membahas perintah-perintahnya, dan panduan Kimi Code CLI kami membahas lebih dalam soal penggunaan sehari-hari.

Kimi K3.1 Pro di Codex

Codex berkomunikasi dengan Kimi melalui Responses API, dan Moonshot menerbitkan panduan Codex resmi. Tambahkan ini ke ~/.codex/config.toml:

model = "kimi-k3.1-pro"
model_provider = "kimi"
model_context_window = 1048576

[model_providers.kimi]
name = "Kimi"
base_url = "https://api.moonshot.ai/v1"
env_key = "KIMI_API_KEY"
wire_api = "responses"

Perhatikan nama variabel env-nya: Codex membaca KIMI_API_KEY, bukan MOONSHOT_API_KEY. Ekspor kunci Moonshot Anda dengan nama tersebut, lalu jalankan codex seperti biasa.

Kimi K3.1 Pro di Claude Code

Moonshot menjalankan endpoint Messages yang kompatibel dengan Anthropic di https://api.moonshot.ai/anthropic, sehingga Claude Code berfungsi tanpa proxy. Letakkan variabel-variabel tersebut di blok env pada ~/.claude/settings.json:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.moonshot.ai/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_MOONSHOT_API_KEY",
    "ANTHROPIC_MODEL": "kimi-k3[1m]"
  }
}

Alias tersebut memang disengaja. Halaman troubleshooting Moonshot menyebutkan bahwa panggilan API langsung dan Codex menggunakan kimi-k3.1-pro, sementara Claude Code menggunakan alias yang kompatibel kimi-k3[1m]. Panduan Claude Code juga menyetel variabel model lainnya, jadi salin semuanya dari sana.

Satu jebakan: nilai usang di blok env pada file pengaturan akan menimpa ekspor shell. Jika Claude Code terus memanggil model lama, periksa file itu terlebih dahulu.

OpenCode

OpenCode tidak memerlukan file konfigurasi. Jalankan opencode auth login, pilih "Moonshot AI", tempelkan kunci Anda, lalu pilih K3.1 Pro dari daftar model Moonshot AI. Panduan OpenCode dari Moonshot ditulis untuk K3, jadi pastikan model tersebut muncul di daftar Anda [VERIFY].

Biarkan agen Anda menguji API Kimi dengan Apidog CLI

Setelah Codex atau Claude Code berjalan di atas K3.1 Pro, manfaatkan sesi yang sama untuk mengerjakan uji regresi bagi API Kimi itu sendiri. Agen Anda yang menulis dan menjalankan pemeriksaannya; Anda cukup menulis satu prompt. Apidog CLI memberinya output JSON terstruktur dan schema, sehingga ia tidak menebak-nebak bentuk payload.

Pasang CLI, masuk, dan tambahkan skill untuk agen:

npm install -g apidog-cli@latest
apidog login --with-token <YOUR_TOKEN>
apidog skill install

Lalu berikan satu prompt kepada agen Anda:

In Apidog project <projectId>, create an environment for https://api.moonshot.ai/v1.
Then create a test case for POST /chat/completions with model kimi-k3.1-pro and
reasoning_effort "low" that asserts status 200 and non-empty choices[0].message.content.
Run it and summarize any failures.

Agen tersebut membuat environment, membaca schema, memvalidasi payload-nya, menulis test case, dan menjalankannya:

apidog environment create kimi-prod --project <projectId> --base-url https://api.moonshot.ai/v1
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <projectId> --file case.json
apidog run --test-case <caseId> --project <projectId> -e <envId> -r cli,json

Test case memerlukan kategori yang valid, dan apidog test-case category --project <projectId> akan menampilkan daftarnya. Status 200 dengan jawaban yang tidak kosong juga membuktikan bahwa API menerima reasoning_effort. Ganti dengan -r junit dan eksekusi yang sama bisa langsung masuk ke CI, seperti yang ditunjukkan oleh panduan CI/CD Apidog CLI kami. Penyiapan khusus agen ada di Apidog CLI di Codex dan Apidog CLI di Claude Code. Paket Free Apidog mencakup hingga 4 pengguna.

Catatan biaya Kimi K3.1 Pro

API ini bersifat bayar sesuai pemakaian, tanpa langganan, dan harga tidak termasuk pajak.

K3.1 Pro sepertiga lebih murah daripada K3 untuk input dan output. Caching otomatis untuk prefiks yang berulang, dengan TTL default 5 menit, dan cache hit ditagih $0.20. Highspeed berjalan 2-3x lebih cepat dengan harga dua kali lipat.

Top-up minimum $1 Anda bisa membeli sekitar 500K token input atau 100K token output. Ketika total top-up kumulatif Anda mencapai $5, Anda mendapat voucher $5, tetapi voucher tidak dihitung dalam isi ulang kumulatif, dan apakah voucher berlaku untuk K3.1 Pro tidak disebutkan [VERIFY]. Akun $1 dimulai pada Tier0 menurut halaman limit: 1 permintaan bersamaan, 3 RPM, dan 1,5 juta token per hari. Tier1 pada akumulasi $10 menaikkannya menjadi 100 RPM.

FAQ

Apakah Kimi K3.1 Pro open weight?

Belum. Moonshot menyatakan bobot lengkap model akan dirilis paling lambat 4 November 2026. Lisensinya belum disebutkan.

Apa perbedaan antara K3.1 Pro dan K3.1 Pro Highspeed?

Keluarga model yang sama, kecepatan dan harga yang berbeda. Highspeed berjalan 2-3x lebih cepat dan berbiaya $4/$20 per juta token dibandingkan $2/$10. Di Kimi Code, ia memerlukan paket Pro dan menggunakan sekitar 2x kuota.

Bisakah saya mematikan thinking di Kimi K3.1 Pro?

Tidak. Thinking selalu aktif. Setel reasoning_effort ke "low" untuk memangkas token reasoning dan latensi.

Mengapa percakapan multi-turn saya rusak?

Kemungkinan besar Anda hanya mengirim kembali content dari asisten. Tambahkan objek pesan asisten secara utuh ke riwayat Anda, seperti yang diwajibkan dokumentasi Moonshot untuk obrolan multi-turn dan pemanggilan tool.

Apakah API Kimi gratis?

Tidak. K3.1 Pro terbuka setelah top-up minimum $1. Chat gratis di aplikasi Kimi adalah opsi $0, yang dibahas di panduan gratis kami.

Apakah Kimi K3.1 Pro mendukung jendela konteks 1M?

Ya. API mendukung 1.048.576 token. Di Kimi Code, konteks 1M penuh memerlukan Allegretto (Pro) atau di atasnya.