Kimi API: Panduan Lengkap Integrasi
Gunakan kekuatan Moonshot K2.5 dengan konteks 256K dan teknologi MoE tercanggih dalam aplikasi Anda hari ini.
Mulai Sekarang
Panduan Lengkap Menggunakan Kimi API
Kimi API memberikan akses ke Moonshot AI Kimi K2.5, sebuah model MoE dengan 1 triliun parameter yang memiliki kemampuan multimodal asli, jendela konteks 256K token, dan fitur agen cerdas. Antarmuka berbasis REST ini memungkinkan integrasi ke dalam aplikasi yang membutuhkan penalaran tingkat lanjut, pemahaman visual, analisis dokumen, serta alur kerja multi-agen. Layanan ini tersedia melalui platform resmi Moonshot dan penyedia pihak ketiga termasuk OpenRouter, Together AI, dan NVIDIA NIM.
Bagi pengembang yang terbiasa dengan ekosistem OpenAI, proses migrasi sangatlah mudah. API ini mempertahankan kompatibilitas penuh dengan struktur SDK OpenAI, sehingga hanya memerlukan perubahan URL dasar dan kunci API. Autentikasi menggunakan otorisasi token Bearer standar. SDK resmi untuk Python dan Node.js mengelola permintaan dengan efisien, sementara bobot model sumber terbuka di Hugging Face memungkinkan penerapan mandiri bagi tim yang membutuhkan kendali penuh atas infrastruktur mereka.
Apa yang membuat API ini unggul? Kombinasi antara jendela konteks 256K, kemampuan visi asli, dan mode Agent Swarm ditawarkan dengan harga sekitar 4 kali lebih murah dibandingkan Claude Opus 4.5. Jalur kerja RAG yang kompleks menjadi lebih sederhana ketika model Anda memproses seluruh kumpulan dokumentasi dalam satu sesi sekaligus memahami konten gambar, bagan, dan video secara alami.
| Fitur | Detail |
|---|---|
| Model Saat Ini | Kimi K2.5 (kimi-k2.5) |
| Jendela Konteks | 262.144 token (256K) |
| Jenis Input | Teks, gambar, video, dokumen |
| Autentikasi | Token Bearer melalui header Authorization |
| SDK | Python, Node.js (Kompatibel dengan OpenAI) |
| Penyedia | Moonshot Official, OpenRouter, Together AI, NVIDIA NIM |
Endpoint API mencerminkan struktur OpenAI untuk penyelesaian obrolan, mendukung respons JSON, keluaran streaming, dan pemanggilan fungsi untuk membangun alur kerja agen. Akses ke Kimi melalui API berarti memanfaatkan kemampuan penuh K2.5 termasuk empat mode operasional: Instant, Thinking, Agent, dan Agent Swarm.
- Endpoint REST yang kompatibel dengan OpenAI mengurangi perombakan kode saat berganti penyedia.
- Respons streaming memungkinkan pembaruan antarmuka pengguna secara progresif selama pembuatan teks.
- Dukungan pemanggilan fungsi untuk penggunaan alat eksternal dan keluaran terstruktur.
- Input multimodal asli menerima gambar dan video bersamaan dengan teks.
- Penyimpanan cache konteks otomatis mengurangi biaya input berulang sebesar 75%.
Cara Memulai dengan API
Pendaftaran hanya memakan waktu beberapa menit. Anda cukup mengunjungi platform.moonshot.ai, membuat akun dengan verifikasi email, dan menuju ke bagian kunci API. Platform ini menyediakan dokumentasi lengkap yang mencakup berbagai pola integrasi teknis yang umum digunakan oleh pengembang.
- Daftar di platform.moonshot.ai dan lakukan verifikasi alamat email Anda.
- Buka bagian API Keys pada dasbor pengembang yang tersedia.
- Buat kunci API pertama Anda dan simpan dengan aman karena tidak dapat dilihat kembali setelah dibuat.
- Pasang SDK Python OpenAI atau gunakan cURL secara langsung untuk mengirim permintaan.
from openai import OpenAI
client = OpenAI(
api_key="your_moonshot_api_key",
base_url="https://api.moonshot.cn/v1"
)
response = client.chat.completions.create(
model="kimi-k2.5",
messages=[
{"role": "system", "content": "Anda adalah asisten yang membantu."},
{"role": "user", "content": "Jelaskan tentang arsitektur MoE."}
],
temperature=0.7
)
print(response.choices[0].message.content)Kode ini berfungsi sama persis dengan panggilan API OpenAI. Peralihan dari model GPT hanya memerlukan perubahan pada parameter base_url dan api_key. Penanganan kesalahan, logika percobaan ulang, implementasi streaming, dan penguraian respons yang sudah ada dapat digunakan kembali tanpa modifikasi.
Struktur Harga API
Kimi K2.5 menawarkan harga yang kompetitif di berbagai penyedia, dengan fitur penyimpanan cache konteks otomatis pada API resmi yang sangat menguntungkan pengguna. Saat ini, pada tahun 2026, fitur ini dapat memangkas biaya input secara signifikan untuk data yang diproses berulang kali.
| Penyedia | Input (per 1M token) | Output (per 1M token) | Input Cache |
|---|---|---|---|
| Moonshot Official | $0,60 | $3,00 | $0,15 (Diskon 75%) |
| OpenRouter | $0,45 | $2,20 | Bervariasi |
| Together AI | $0,50 | $2,80 | Bervariasi |
Harga tersebut menempatkan Kimi K2.5 pada posisi yang jauh lebih ekonomis dibandingkan kompetitor kelas atas lainnya untuk kapasitas konteks yang setara. Fitur penyimpanan cache konteks otomatis akan aktif secara transparan ketika instruksi sistem atau awalan dokumen yang sama digunakan kembali dalam permintaan berikutnya.
Batas Kecepatan dan Tingkatan
API resmi menggunakan sistem tingkatan berdasarkan jumlah akumulasi pengisian saldo akun Anda. Tingkatan yang lebih tinggi membuka akses ke jumlah permintaan bersamaan dan batas kecepatan yang lebih besar.
| Tingkatan | Akumulasi Saldo | Permintaan Bersamaan | Permintaan per Menit |
|---|---|---|---|
| Tier 1 | $10 | 50 | 200 |
| Tier 2 | $100 | 100 | 500 |
| Tier 3 | $500 | 300 | 2.000 |
| Tier 5 | $3.000 | 1.000 | 10.000 |
Untuk aplikasi yang membutuhkan batas lebih tinggi, paket perusahaan dengan batas kecepatan khusus tersedia melalui kontak langsung dengan tim penjualan Moonshot AI. Perlu dicatat bahwa versi model diperbarui secara berkala untuk menjaga kinerja optimal.
Penggunaan API Multimodal
Arsitektur multimodal asli Kimi K2.5 menerima gambar dan video secara langsung dalam permintaan API. Encoder visi MoonViT-3D memproses input dengan berbagai resolusi tanpa memerlukan pra-pemrosesan atau pengubahan ukuran di sisi klien.
response = client.chat.completions.create(
model="kimi-k2.5",
messages=[
{
"role": "user",
"content": [
{"type": "text", "text": "Jelaskan bagan ini dan ekstrak datanya."},
{"type": "image_url", "image_url": {"url": "https://example.com/chart.png"}}
]
}
]
)Kemampuan visi model ini mencapai skor tinggi pada tolok ukur industri seperti OCRBench dan InfoVQA. Hal ini membuat Kimi K2.5 sangat kuat dalam memahami dokumen, melakukan analisis bagan, serta mengekstraksi data dari gambar mentah dengan akurasi presisi.
Metode Akses Alternatif
Selain API resmi, Kimi K2.5 dapat diakses melalui beberapa platform pihak ketiga dan opsi penerapan mandiri untuk kebutuhan kontrol data yang lebih ketat.
- OpenRouter menyediakan akses agregat dengan sistem penagihan tunggal untuk berbagai penyedia AI.
- Together AI menawarkan infrastruktur inferensi yang dioptimalkan dengan latensi rendah.
- NVIDIA NIM mendukung penerapan tingkat perusahaan melalui platform layanan mikro inferensi.
- Penerapan mandiri dapat dilakukan dengan mengunduh bobot model dari Hugging Face dalam format block-fp8.
Model ini memerlukan sumber daya GPU yang besar untuk menjalankan seluruh 1 triliun parameter secara lokal. Namun, efisiensi tetap terjaga berkat arsitektur MoE yang hanya mengaktifkan sebagian kecil parameter selama proses inferensi berlangsung.