kimiapikey.comPanduan
Gunakan Kunci API Gaya Kimi di Cursor: Panduan Pengaturan
Cursor dapat terhubung ke endpoint apa pun yang kompatibel dengan OpenAI, sehingga menghubungkannya dengan API ini memerlukan empat bidang dan sekitar dua menit. Panduan ini mencakup nilai pasti, uji yang membuktikan kunci berfungsi, dan kesalahan yang paling mungkin Anda temui.
Diperbarui

Poin utama
- Cursor membutuhkan tiga nilai: kunci Anda, URL dasar https://api.kimiapikey.com/v1 dan nama model
uncensored. - Uji kunci dengan curl terlebih dahulu, sehingga masalah sisi Cursor mudah dibedakan dari masalah sisi API.
- Edit bergaya agen mengirim prompt besar, jadi perhatikan token input: $0,15 per 1 juta masuk, $0,50 per 1 juta keluar.
- Kunci uji coba memungkinkan 2 permintaan paralel, yang dapat dilampaui oleh agen Cursor. Kunci penuh memungkinkan 8.
Jawaban singkat
Jika Anda mencari cara menggunakan kunci api kimi di cursor, hal pertama yang perlu diketahui adalah kunci yang diterbitkan oleh penyedia lain hanya berfungsi dengan endpoint penyedia tersebut. Kunci dari situs ini berfungsi dengan endpoint situs ini, dan Cursor menerimanya karena endpoint menggunakan format chat completions OpenAI. Anda menempelkan kunci, mengarahkan Cursor ke URL dasar yang berbeda, dan menambahkan satu nama model kustom.
Seluruh pengaturan secara berurutan:
- Buat akun dan salin kunci Anda dari halaman kunci API.
- Buka Cursor, buka Pengaturan, lalu Model.
- Tempelkan kunci ke bidang kunci API OpenAI.
- Aktifkan penggantian URL dasar dan masukkan
https://api.kimiapikey.com/v1. - Tambahkan model kustom bernama
uncensoreddan pilih di obrolan.
Sisa artikel ini menjelaskan setiap langkah, memberikan cara untuk menguji koneksi di luar editor, dan mencantumkan apa yang biasanya salah.
Apa itu kunci ini dan apa yang bukan
Situs ini menjual akses ke satu model bobot terbuka, dijalankan oleh penyedia independen dan disesuaikan untuk menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah. Ini bukan API resmi Moonshot, Kimi atau vendor lain, dan ini bukan router yang meneruskan permintaan Anda ke model orang lain. Nama situs mencerminkan apa yang orang cari, bukan siapa yang menjalankan layanan. Jika Anda sudah memegang kunci dari vendor lain, teruslah menggunakannya dengan endpoint vendor tersebut. Kedua kunci tidak dapat dipertukarkan.
Yang Anda dapatkan adalah API bergaya OpenAI: POST /v1/chat/completions dan GET /v1/models, autentikasi token bearer, jendela konteks 100.000 token, streaming, pemanggilan fungsi, dan mode JSON. Hanya teks. Tidak ada pembuatan gambar, tidak ada embedding, dan tidak ada penyetelan halus, yang penting dalam editor karena fitur Cursor yang bergantung pada itu tidak akan menggunakan endpoint ini. Penjelasan kunci API Kimi membahas penamaan dan alternatifnya secara lebih rinci.
Untuk pengkodean, "uncensored" memiliki arti praktis. Model tidak akan berhenti di tengah tugas karena nama variabel atau fixture pengujian terlihat sensitif. Alat keamanan untuk sistem yang Anda miliki, parser log penuh dengan string jelek, scraper, generator fiksi dan set pengujian moderasi adalah jenis pekerjaan yang memicu penolakan di tempat lain. Batas keras tetap berlaku: tidak ada konten seksual yang melibatkan anak di bawah umur, selamanya.
Pengaturan langkah demi langkah di Cursor
1. Dapatkan kunci dan kredit uji coba
Daftar dengan Google, atau dengan email dan kata sandi. Di halaman kunci API, Anda dapat mengklaim $0,50 kredit uji coba dengan satu klik. Tidak perlu kartu, berlaku selama 7 hari, dan satu per orang. Itu cukup untuk beberapa ratus permintaan obrolan normal, sehingga Anda dapat menyelesaikan seluruh panduan ini sebelum membayar apa pun.
2. Buka pengaturan model
Di Cursor, buka Pengaturan dan temukan bagian Model. Label menu berubah-ubah antar-versi, jadi cari bidang untuk kunci API OpenAI dan toggle atau bidang untuk mengganti URL dasar OpenAI. Itu adalah dua pengaturan yang penting.
3. Isi tiga nilai
| Bidang Cursor | Nilai |
|---|---|
| Kunci API OpenAI | Kunci Anda dari dasbor |
| Ganti URL dasar OpenAI | https://api.kimiapikey.com/v1 |
| Nama model kustom | uncensored |
Masukkan URL dasar persis seperti yang ditunjukkan. Berakhir dengan /v1, tanpa garis miring di akhir dan tanpa /chat/completions, karena klien menambahkan jalur itu sendiri. URL yang ditempelkan dengan jalur lengkap menghasilkan 404, dan pesan kesalahan jarang menjelaskan alasannya.
4. Pilih model dan kirim pesan
Buka panel obrolan, pilih uncensored dari daftar model, dan ajukan pertanyaan kecil, seperti "tulis fungsi yang memarsing tanggal ISO". Jika balasan muncul, Anda selesai. Jika Cursor menampilkan kesalahan, jangan mengubah pengaturan secara acak. Pergi ke bagian berikutnya dan uji endpoint secara langsung.
5. Ketahui efek samping penggantian
Penggantian URL dasar biasanya berlaku untuk setiap model gaya OpenAI yang Anda gunakan di Cursor, bukan hanya yang kustom. Jika Anda beralih kembali ke model OpenAI standar nanti, matikan penggantian terlebih dahulu, atau permintaan Anda akan pergi ke endpoint ini dengan nama model yang tidak dilayani.
Uji kunci sebelum menyalahkan editor
Dua menit dengan terminal menghemat satu jam menebak. Permintaan ini melakukan apa yang dilakukan Cursor: ia mengirim permintaan chat completion dengan token bearer.
curl https://api.kimiapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Reply with the word ready."}],
"max_tokens": 20
}'
Isi JSON dengan larik choices berarti kunci, URL, dan nama model semuanya benar. Periksa juga header respons. X-Balance-USD menunjukkan sisa saldo Anda dan X-Request-Id berharga untuk disimpan jika Anda perlu melacak permintaan di masa mendatang.
Pemeriksaan yang sama di Python dengan SDK OpenAI resmi:
from openai import OpenAI
client = OpenAI(
base_url="https://api.kimiapikey.com/v1",
api_key="YOUR_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Reply with the word ready."}],
max_tokens=20,
)
print(resp.choices[0].message.content)
Anda juga dapat mencantumkan model dengan GET /v1/models. Cursor dan klien serupa kadang memanggilnya saat Anda menekan tombol verifikasi, sehingga panggilan model yang berfungsi adalah tanda bagus. Jika curl berfungsi dan Cursor tidak, masalahnya ada di pengaturan editor, dan tabel kesalahan di bawah ini mencakup yang biasa.
Apa yang berubah ketika model menulis kode di editor Anda
Obrolan di panel samping murah. Pertanyaan singkat dengan beberapa ratus token konteks berharga sepersekian sen. Fitur editor yang melampirkan file, hasil pencarian, dan riwayat percakapan lebih mahal karena setiap permintaan membawa semuanya lagi. Model memiliki jendela 100.000 token yang dibagi antara prompt dan balasan, dan Cursor akan dengan senang hati mengisi banyak itu jika Anda melampirkan folder besar.
Berikut perhitungan nyata. Katakan permintaan membawa 40.000 token input dan model menulis 1.500 token kembali:
- Input: 40.000 / 1.000.000 x $0,15 = $0,006
- Output: 1.500 / 1.000.000 x $0,50 = $0,00075
- Total: $0,00675 per permintaan, jadi 100 permintaan seperti itu menghabiskan $0,675
Itu jauh di bawah satu dolar untuk sore yang berat, tetapi sisi input mendominasi, sehingga kebiasaan yang menghemat uang adalah melampirkan lebih sedikit file, bukan mengajukan pertanyaan yang lebih pendek. Mulai obrolan baru ketika topik berubah, karena riwayat lama dibayar lagi pada setiap giliran.
Pemanggilan fungsi didukung oleh API, yang menjadi dasar fitur editor bergaya agen. Model memutuskan untuk memanggil alat, klien Anda menjalankannya dan mengembalikan hasilnya sebagai pesan role: "tool". Seberapa baik model apa pun mengendalikan agen multi-langkah bergantung pada modelnya, jadi cobalah pada tugas kecil sebelum menyerahkannya untuk melakukan refaktor. Satu model bobot terbuka di balik API berarti Anda mendapatkan satu perilaku, bukan menu untuk dipilih.
Fitur Cursor yang berjalan pada model Cursor sendiri, seperti pelengkapan otomatis Tab, umumnya tidak diaktifkan oleh kunci kustom. Periksa dokumentasi terbaru Cursor untuk fitur mana yang menerima endpoint gaya OpenAI kustom, karena daftar itu berubah antar rilis.
Kesalahan umum dan cara memperbaikinya
| Gejala | Penyebab yang mungkin | Perbaikan |
|---|---|---|
| 404 atau "tidak ditemukan" | URL dasar menyertakan jalur endpoint, atau tidak memiliki /v1 | Gunakan persis https://api.kimiapikey.com/v1 |
| 401 tidak sah | Spasi tambahan atau baris baru pada kunci yang disalin, atau kunci lama | Salin ulang kunci dari dasbor dan tempelkan lagi |
| Model tidak ditemukan | Nama model diketik berbeda | Gunakan uncensored, huruf kecil semua, tidak ada yang lain |
429 dengan kode concurrency | Terlalu banyak permintaan sekaligus untuk kunci Anda | Tunggu permintaan yang sedang berjalan selesai, atau gunakan kunci penuh (8 konkuren) |
429 dengan kode rate_limited | Melebihi batas per menit | Perlambat; kunci uji coba mengizinkan 60 per menit, kunci penuh 300 |
429 dengan header Retry-After: 5 | Beban berlebih sementara | Coba lagi setelah lima detik |
| Tombol verifikasi gagal, curl berhasil | Editor menguji dengan nama model yang dikenal | Lewati langkah verifikasi dan kirim pesan obrolan nyata |
Kesalahan konkurensi layak mendapat catatan karena mengejutkan orang pada kunci uji coba. Uji coba memungkinkan 2 permintaan konkuren, dan agen yang memulai beberapa operasi secara paralel dapat melebihi itu tanpa Anda melakukan apa pun. Respons streaming juga memegang slotnya hingga stream berakhir, sehingga jawaban panjang menjaga satu slot tetap sibuk sepanjang waktu. Kunci penuh memungkinkan 8 permintaan konkuren dan 300 permintaan per menit, yang nyaman untuk satu pengembang.
Permintaan yang gagal dan ditolak tidak dibebankan biaya, sehingga mencoba lagi setelah kesalahan tidak memerlukan biaya tambahan. Anda dapat membaca batas penuh di halaman dokumentasi.
Membayarnya setelah kredit uji coba habis
Tidak ada langganan. Anda isi saldo prabayar dengan jumlah bulat apa pun dari $20 hingga $500, dan permintaan menguranginya pada $0,15 per 1 juta token input dan $0,50 per 1 juta token output. Saldo tidak pernah kedaluwarsa, sehingga bulan tanpa pemrograman tidak memerlukan biaya. Isi ulang $50 atau lebih membawa bonus: +5% dari $50, +10% dari $100, dan +15% dari $200. Anda dapat membayar dengan kripto (USDT pada TRC20, USDC pada Base). Halaman harga memiliki angka saat ini di satu tempat.
Menggunakan permintaan 40.000 masuk, 1.500 keluar dari sebelumnya, isi ulang $20 mencakup sekitar 2.960 permintaan seperti itu ($20 / $0,00675). Sebagian besar permintaan editor lebih kecil, sehingga angka sebenarnya lebih tinggi. Prompt Anda tidak digunakan untuk pelatihan, yang penting ketika kode yang Anda tempel milik klien.
Saat Anda menyelesaikan pengaturan, tugas pertama yang masuk akal adalah tugas kecil yang dapat Anda tinjau dengan cepat: tes unit untuk fungsi yang ada, regex dengan komentar panjang, atau penulisan ulang satu file berisik. Jika hasilnya sesuai dengan alur kerja Anda, tambahkan saldo. Jika tidak, Anda telah menghabiskan beberapa sen kredit uji coba untuk mengetahuinya.
Panduan lainnya
- Harga Kunci API Kimi: Berapa Biaya Alternatif Ini
- Integrasi Kunci API Kimi dengan SDK OpenAI dan LangChain
- Kunci API Kimi: Cara Kerjanya dan Apa Alternatifnya
Pertanyaan yang Sering Diajukan
Apakah modelnya sama dengan Kimi resmi dari Moonshot?
Tidak, kami menjalankan model bobot terbuka yang telah disesuaikan agar tanpa sensor. Ini bukan GPT, Claude, Gemini, Grok, DeepSeek, atau model dari vendor lain. Ini adalah model unik yang dijalankan di server kami sendiri.
Apakah Anda melatih model dengan data saya?
Tidak. Prompt dan completion Anda tidak digunakan untuk pelatihan. Kami menghargai privasi dan transparansi, sehingga data Anda tetap menjadi milik Anda.
Apa saja rate limit-nya?
Anda dibatasi hingga 300 permintaan per menit per kunci. Ukuran body permintaan maksimum adalah 8 MB. Batas-batas ini dirancang untuk memastikan kinerja stabil bagi semua pengguna.
Apa kebijakan konten-nya?
Model ini tanpa sensor untuk topik dewasa, kontroversial, dan kreatif. Namun, kami memblokir konten seksual yang melibatkan anak di bawah umur. Ini adalah batas keras yang selalu berlaku, terlepas dari tingkat langganan Anda.
Tanya jawab
Bisakah saya memasukkan kunci Moonshot atau Kimi ke dalam Cursor dengan URL dasar ini?
Tidak. Kunci hanya berfungsi dengan endpoint dari penyedia yang menerbitkannya. Gunakan kunci dari dasbor Anda di sini, atau simpan kunci lain dengan URL penyedia asalnya.
Nama model apa yang saya masukkan di Cursor?
Masukkan uncensored dalam huruf kecil. Ini adalah satu-satunya ID model yang dilayani oleh API ini, dan nama yang berbeda akan mengembalikan error model tidak ditemukan.
Apakah ini berfungsi dengan mode agen Cursor?
API mendukung pemanggilan fungsi, yang dibutuhkan fitur agen. Seberapa andal model menyelesaikan tugas multi-langkah panjang bervariasi, jadi ujilah pada tugas kecil terlebih dahulu sebelum tugas besar.
Mengapa saya mendapatkan kesalahan 429 pada kunci uji coba?
Kunci uji coba mengizinkan 2 permintaan paralel dan 60 per menit. Kunci penuh mengizinkan 8 paralel dan 300 per menit, dan header Retry-After: 5 berarti kelebihan beban singkat yang dapat Anda coba lagi.
Apakah kode saya digunakan untuk pelatihan?
Tidak. Prompt yang dikirim ke API tidak digunakan untuk pelatihan.
Kunci Anda hanya selangkah lagi dari satu formulir
Buat akun, salin kunci, ubah URL dasar. Itu saja seluruh proses pengaturannya.