kimiapikey.comPanduan
Kunci API Kimi Tidak Berfungsi: Penyebab, Perbaikan, Cadangan
Jika error kunci api kimi tidak berfungsi muncul sebagai 401, 404 atau 429, penyebabnya hampir selalu salah satu dari lima hal: base URL yang salah, kunci yang tidak cocok, tidak ada saldo, batas laju, atau nama model yang tidak dikenal oleh endpoint. Selesaikan masalah ini secara berurutan.
Diperbarui


Poin utama
- Sebuah kunci hanya berfungsi terhadap penyedia yang menerbitkannya, sehingga base URL dan kunci harus berasal dari dasbor yang sama.
- 401 berarti kunci ditolak, 404 biasanya berarti jalur yang buruk, 429 berarti Anda mencapai batas atau layanan sedang sibuk.
- Tampilkan kode status dan body respons sebelum mengubah apa pun.
- Simpan endpoint lain yang kompatibel dengan OpenAI agar satu gangguan tidak menghentikan aplikasi Anda.
Baca kode status terlebih dahulu
Sebelum Anda membuat ulang apa pun, lihat apa yang sebenarnya dikirimkan server. Sebagian besar klien bergaya OpenAI menyembunyikan body di balik pengecualian generik. Tampilkan status dan teksnya.
curl -i https://api.kimiapikey.com/v1/models \
-H "Authorization: Bearer $YOUR_KEY"
Baris pertama balasan memberi tahu Anda tempat untuk mencari:
| Kode | Makna umum | Mulailah dengan |
|---|---|---|
| 401 | Kunci ditolak | Salinan kunci, kunci, dan base URL dari penyedia yang berbeda |
| 404 | Jalur atau model tidak ditemukan | Hilangnya /v1, jalur ganda, ID model salah |
| 400 | Body permintaan tidak valid | Nama parameter, format pesan, ukuran body |
| 429 | Batas terlampaui atau layanan sibuk | Laju permintaan, panggilan paralel, waktu coba ulang |
| 5xx | Masalah sisi server | Coba lagi dengan backoff, lalu beralih ke cadangan |
Jika Anda sama sekali tidak mendapatkan respons HTTP (timeout atau kesalahan DNS), masalahnya adalah jaringan atau nama host yang Anda ketik, bukan kuncinya.
Base URL dan kunci harus menyatu
Ini adalah alasan paling umum mengapa kunci baru gagal. Kunci diterbitkan per penyedia. Kunci dari satu dasbor sama sekali tidak dikenal oleh server penyedia lain, sehingga mengembalikan 401 meskipun kunci tersebut valid di tempat asalnya.
Periksa poin-poin berikut:
- Kunci dan base URL berasal dari halaman akun yang sama. Jika Anda menyalin kunci dari satu penyedia tetapi meninggalkan base URL lama di konfigurasi Anda, permintaan akan dikirim ke tempat yang salah.
- Variabel lingkungan tidak menutupi kode Anda. SDK OpenAI membaca
OPENAI_API_KEYdanOPENAI_BASE_URLketika Anda tidak melewatkan secara eksplisit, sehingga variabel shell yang usang dapat menggantikan apa yang Anda tulis di file. - Tidak ada spasi atau baris baru di akhir kunci. Baris baru yang tertinggal saat menyalin dan menempel adalah penyebab klasik 401.
- Header-nya persis
Authorization: Bearer <key>. Beberapa alat mengharapkan kunci di header yang berbeda dan perlu mengaktifkan mode kompatibel OpenAI.
Editor dan antarmuka chat menambahkan satu jebakan lagi. Banyak di antaranya memiliki bidang terpisah untuk "base URL OpenAI" dan tombol pengalih (toggle) terpisah untuk mengaktifkannya. Jika tombol pengalih dimatikan, aplikasi diam-diam terus memanggil host default dengan kunci baru Anda, dan Anda mendapatkan error 401 yang terlihat seperti kunci yang buruk. Simpan pengaturan, mulai ulang aplikasi jika aplikasi menyimpannya di cache, dan kirim satu pesan uji singkat sebelum menguji apa pun yang lebih rumit.
Base URL harus berakhir di /v1, bukan di host dan bukan di /v1/chat/completions. SDK menambahkan sisanya. URL yang sudah mencakup jalur lengkap akan berakhir menjadi jalur ganda dan 404.
Akses regional, proxy dan jaringan perusahaan
Kadang-kadang kuncinya baik-baik saja dan permintaan tidak mencapai server yang tepat. Ketersediaan penyedia dapat bergantung pada tempat Anda terhubung, dan VPN, proxy perusahaan atau aturan firewall dapat memblokir atau menulis ulang lalu lintas. Lihat dokumentasi atau halaman status resmi penyedia untuk wilayah yang didukung, dan jangan mengasumsikan aturannya sama dengan layanan lain.
Tes isolasi cepat: jalankan perintah curl yang sama dari jaringan berbeda, seperti hotspot ponsel. Jika berhasil di sana, kuncinya baik dan jaringan Anda adalah penyebabnya. Jika proxy mengatur HTTPS_PROXY, periksa apakah library HTTP Anda benar-benar menghormatinya; beberapa alat mengabaikannya dan gagal dengan kesalahan koneksi.
Saldo, kuota, dan tampilan batas laju
Kunci bisa valid dan masih menolak permintaan karena akun tidak memiliki sisa kredit atau kuota telah habis. Periksa dasbor sebelum Anda men-debug kode. Jika Anda belum pernah mengisi saldo, ingat bahwa alokasi gratis biasanya kecil dan berumur pendek.
429 adalah cerita yang berbeda. Ini berarti server memperlambat Anda, bukan karena kunci yang buruk. Pada endpoint yang dijelaskan di situs ini, kunci penuh memungkinkan 8 permintaan konkuren dan 300 permintaan per menit, sedangkan kunci uji coba memungkinkan 2 permintaan konkuren dan 60 permintaan per menit. Ketika Anda melebihi batas tersebut, API mengembalikan HTTP 429 dengan kode kesalahan rate_limited (terlalu banyak per menit) atau concurrency (terlalu banyak sekaligus). Beban berlebih sementara juga mengembalikan 429, dengan header Retry-After: 5.
Dua kebiasaan memperbaiki sebagian besar masalah ini. Hormati Retry-After ketika ada, dan batasi pekerja paralel Anda pada batas konkurensi. Permintaan streaming mempertahankan slotnya hingga stream berakhir, sehingga stream yang macet dihitung lebih lama dari yang Anda harapkan.
Nama model, parameter dan ukuran body
404 atau 400 dengan kunci yang valid biasanya mengarah ke permintaan itu sendiri. Tiga hal yang harus diperiksa:
- ID Model. Setiap penyedia memiliki nama modelnya sendiri. Tanyakan endpoint apa yang dilayaninya dengan
GET /v1/modelsdan salin ID dari balasan. Di situs ini ID-nya adalahuncensored. - Parameter. Nama seperti
max_tokens,temperaturedanresponse_formatadalah standar, tetapi penyedia mungkin hanya menerima sebagian subset. Hapus bidang opsional hingga permintaan berhasil, lalu tambahkan kembali satu per satu. - Ukuran. Prompt yang sangat besar dapat gagal karena batas body sebelum model memprosesnya. Di sini, batas maksimum body adalah 8 MB dan jendela konteks adalah 100.000 token untuk prompt dan hasil gabungan.
Streaming adalah tempat lain di mana kunci yang berfungsi terlihat rusak. Jika permintaan berhasil tanpa stream: true dan gagal dengan itu, penyebabnya sering kali adalah proxy yang melakukan buffering atau memotong event yang dikirim server, bukan endpointnya. Matikan streaming untuk mengonfirmasi, lalu periksa pengaturan proxy.
Jika Anda hanya mengubah nama model dan panggilan gagal, kembalikan nama lama untuk mengonfirmasi bahwa sisa pengaturan Anda baik-baik saja.
Siapkan endpoint cadangan
Bahkan penyedia yang sehat memiliki jam buruk. Jika produk Anda bergantung pada satu kunci, satu kegagalan menjadi gangguan Anda. Karena format permintaan OpenAI dibagi, Anda dapat menyiapkan endpoint kedua dan beralih dengan beberapa baris kode.
Endpoint di situs ini kompatibel dengan OpenAI, sehingga dapat dimasukkan sebagai penyedia kedua. Ini adalah model bobot terbuka yang di-host secara independen, bukan layanan resmi Moonshot, dan akan menjawab secara berbeda daripada model Kimi, jadi uji prompt Anda sebelum mengandalkan endpoint ini. Berikut adalah pembungkus kecil yang mencoba yang utama terlebih dahulu dan beralih pada kesalahan:
import os
from openai import OpenAI
primary = OpenAI(base_url=os.environ["PRIMARY_BASE_URL"],
api_key=os.environ["PRIMARY_KEY"])
fallback = OpenAI(base_url="https://api.kimiapikey.com/v1",
api_key=os.environ["FALLBACK_KEY"])
def ask(messages):
try:
r = primary.chat.completions.create(
model=os.environ["PRIMARY_MODEL"], messages=messages, timeout=30)
except Exception as e:
print("primary failed:", e)
r = fallback.chat.completions.create(
model="uncensored", messages=messages, timeout=60)
return r.choices[0].message.content
print(ask([{"role": "user", "content": "Say hi in five words."}]))
Harga bersifat bayar sesuai pemakaian: $0,15 per 1M token input dan $0,50 per 1M token output dari saldo prabayar yang tidak pernah kadaluarsa. Permintaan yang gagal atau ditolak tidak dikenakan biaya, sehingga fallback yang jarang berjalan hampir tidak mengeluarkan biaya untuk dipertahankan. Top-up dimulai dari $20; lihat harga untuk tingkat bonus.
Uji cadangan dalam dua menit
Pengguna baru dapat mengklaim kredit uji coba senilai $0,50 dengan satu klik di halaman kunci API setelah masuk. Tidak memerlukan kartu dan berlaku selama 7 hari, yang cukup untuk menjalankan prompt asli Anda melalui endpoint sekali. Kemudian jalankan uji asap di bawah ini.
curl https://api.kimiapikey.com/v1/chat/completions \
-H "Authorization: Bearer $FALLBACK_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'
Periksa header respons X-Balance-USD untuk melihat sisa kredit Anda. Referensi permintaan lengkap ada di dokumentasi. Jika Anda mengintegrasikan ini ke editor, panduan yang ada di menggunakan kunci API bergaya Kimi di Cursor menunjukkan di mana bidang base URL berada, dan ikhtisar kunci API Kimi menjelaskan bagaimana endpoint ini berkaitan dengan model yang Anda gunakan.
Panduan lainnya
- URL Dasar API Moonshot: Arahkan Kode Anda ke Tempat Lain
- Gunakan Kunci API Gaya Kimi di Cursor: Panduan Pengaturan
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 data saya?
Tidak. Prompt dan completion Anda tidak digunakan untuk pelatihan. Kami menghargai privasi dan transparansi, sehingga data Anda tetap menjadi milik Anda.
Berapa batas laju-nya?
Anda dibatasi hingga 300 permintaan per menit per kunci. Ukuran badan 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
Mengapa kunci baru saya langsung mengembalikan 401?
Alasan yang paling umum adalah kunci yang dikirim ke base URL penyedia lain, spasi atau baris baru yang tersisa di kunci yang disalin, atau variabel lingkungan yang menimpa kode Anda. Uji dengan curl untuk menyingkirkan kemungkinan masalah pada SDK Anda.
Apakah 429 sama dengan kunci yang salah?
Tidak. Kode 429 berarti Anda mencapai batas laju, batas konkurensi atau kelebihan beban sementara. Kunci tersebut valid. Tunggu nilai Retry-After dan kurangi permintaan paralel Anda.
Apakah permintaan yang gagal dikenakan biaya di sini?
Tidak. Permintaan yang gagal atau ditolak tidak dikenakan biaya pada endpoint ini, sehingga mencoba ulang panggilan yang rusak tidak akan menguras saldo prabayar Anda.
Bisa menggunakan endpoint ini sebagai pengganti langsung untuk model Kimi?
Endpoint ini menggunakan format permintaan OpenAI yang sama, sehingga perubahan kode hanya berupa base URL, kunci API, dan model ID uncensored. Model dasarnya berbeda, sehingga responsnya tidak akan sama; uji prompt Anda terlebih dahulu.
Kunci Anda hanya perlu mengisi satu formulir
Buat akun, salin kunci, ubah URL dasar. Itu saja seluruh proses pengaturannya.