cursorapikey.com/Panduan
Kunci API Cursor Tidak Berfungsi: Perbaikan Endpoint Kustom
Ketika kunci API Cursor tidak berfungsi, penyebabnya hampir selalu salah satu dari empat hal: URL dasar, nama model, kunci itu sendiri, atau batas pada akun. Satu perintah curl akan memberi tahu Anda mana penyebabnya.
Diperbarui


Poin utama
- Uji kunci di luar Cursor terlebih dahulu dengan curl; jika curl berhasil, masalahnya ada di pengaturan Cursor.
- URL dasar harus https://api.cursorapikey.com/v1 dan nama model harus tepat uncensored.
- 401 berarti kunci salah, 404 URL salah, 429 batas laju atau batas konkurensi, dan kesalahan model berarti nama model salah.
- Label menu berubah antar versi Cursor, jadi cocokkan tujuan bidang daripada kata-kata persisnya.
Langkah 1: uji kunci di luar Cursor
Singkirkan Cursor dari persamaan. Jika permintaan biasa berhasil, kunci dan akun Anda baik-baik saja dan kesalahan ada di pengaturan editor. Jika gagal, tubuh kesalahan menyebutkan masalahnya.
curl -i https://api.cursorapikey.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Reply with the word ready."}]}'
Bendera -i mencetak baris status dan header. Status 200 dengan array choices berarti sukses. Header X-Balance-USD menunjukkan sisa saldo Anda, yang merupakan hal pertama yang harus diperiksa jika Anda mendapatkan kesalahan otorisasi atau pembayaran.
Anda juga dapat mencantumkan model, yang mengonfirmasi kunci tanpa menghabiskan apa pun:
curl https://api.cursorapikey.com/v1/models -H "Authorization: Bearer YOUR_KEY" | grep uncensored
Respons harus berisi ID model uncensored.
Langkah 2: atur bidang di Cursor
Buka pengaturan Cursor dan temukan bagian Models. Anda membutuhkan tiga nilai, dan kesalahan pada salah satunya menghasilkan kegagalan yang terlihat seperti kunci yang rusak.
- Kunci API OpenAI: tempel kunci Anda tanpa spasi atau jeda baris di kedua ujungnya.
- Atur ulang URL dasar OpenAI: aktifkan pengaturan ulang dan masukkan
https://api.cursorapikey.com/v1. Pertahankan/v1dan jangan sertakan/chat/completions. - Model kustom: tambahkan model bernama
uncensoreddan aktifkan. Nonaktifkan model yang tidak Anda gunakan agar Cursor tidak memilih model yang tidak dikenal oleh endpoint.
Setelah menyimpan, gunakan opsi verifikasi jika versi Anda memilikinya, lalu pilih uncensored di dropdown model obrolan. Tab obrolan baru adalah uji yang baik, karena tab lama mungkin mempertahankan model yang dimulainya. Panduan langkah demi langkah di cara menggunakan API Cursor menunjukkan pengaturan yang sama dengan konteks lebih banyak.
Cocokkan kesalahan dengan perbaikan
| Yang Anda lihat | Penyebab yang mungkin | Perbaikan |
|---|---|---|
| 401, "kunci tidak valid", "tidak berwenang" | Ketik kunci salah, terpotong, atau dicabut | Salin lagi dari halaman kunci; periksa spasi di akhir |
| 404, "tidak ditemukan" | URL salah, hilang /v1, atau path ganda | Gunakan tepat https://api.cursorapikey.com/v1 |
| "model tidak ditemukan" atau serupa | Nama model berbeda dari uncensored | Tambahkan model kustom dengan nama persis itu, huruf kecil |
429 dengan rate_limited | Melebihi batas permintaan per menit | Perlambat; kunci uji coba mengizinkan 60 per menit, kunci penuh 300 |
429 dengan concurrency | Terlalu banyak permintaan sekaligus | Kurangi menjalankan agen paralel; uji 2, kunci penuh 8 |
429 dengan Retry-After: 5 | Beban berlebih sementara | Tunggu lima detik dan coba lagi |
| Berfungsi di curl, gagal di Cursor | Pengaturan tidak disimpan, model tab salah, atau fitur yang tidak menggunakan kunci kustom | Lihat bagian berikutnya |
Permintaan yang gagal atau ditolak tidak dikenakan biaya, sehingga mencoba lagi saat Anda melakukan debug tidak ada biayanya.
Ketika curl berhasil tetapi Cursor masih gagal
Ini adalah kasus yang paling membingungkan, dan memiliki beberapa penjelasan umum.
Model yang salah dipilih. Cursor mempertahankan model bawaannya sendiri dalam daftar. Jika salah satu dari model tersebut dipilih, permintaan tidak dikirim ke endpoint Anda sama sekali. Pilih uncensored secara eksplisit di dropdown obrolan atau komposer yang Anda gunakan.
Tidak setiap fitur menggunakan kunci Anda. Fitur yang bergantung pada model milik Cursor, seperti autocomplete inline, mungkin tetap menggunakannya terlepas dari kunci yang Anda tambahkan. Kunci kustom berlaku di area di mana Anda dapat memilih model, yaitu mode obrolan dan edit. Periksa dokumentasi terbaru Cursor, karena hal ini berubah antar rilis.
Permintaan paralel dari mode agen. Agen dan menjalankan langkah ganda dapat mengirim beberapa permintaan sekaligus. Kunci uji coba mengizinkan dua sekaligus. Jika error hanya muncul di mode agen, Anda kemungkinan mencapai batas concurrency, dan kunci penuh meningkatkannya menjadi delapan. Permintaan streaming memegang slotnya hingga stream berakhir, sehingga output panjang menempati slot lebih lama.
Panggilan alat. API mendukung pemanggilan fungsi, dengan tool_calls streaming dan hasil diteruskan sebagai role: "tool". Kualitas penggunaan alat bergantung pada model, jadi jika menjalankan agen macet pada langkah alat, coba tugas yang sama di obrolan biasa terlebih dahulu.
Periksa sisi akun
Jika curl mengembalikan kesalahan tentang saldo, kunci valid tetapi kredit kosong atau masa uji coba telah berakhir. Uji coba bernilai $0,50, berlaku selama 7 hari, diklaim dengan satu klik di halaman kunci API setelah masuk. Setelah itu Anda perlu melakukan top up.
Top-up adalah jumlah bulat apa pun dari $20 hingga $500, dengan tambahan +5% dari $50, +10% dari $100 dan +15% dari $200. Anda dapat membayar dengan kripto (USDT pada TRC20, USDC pada Base). Halaman harga menampilkan tabelnya. Jika Anda belum memiliki kunci, dapatkan di sini.
Simpan satu kunci per alat. Jika Anda menempelkan kunci ke beberapa editor dan skrip, batas laju dibagi di antara mereka, yang dapat terlihat seperti kegagalan acak.
Pemeriksaan skrip untuk kasus membandel
Jika Anda masih tidak dapat menemukan penyebabnya, jalankan skrip pendek yang mencerminkan apa yang dilakukan editor. Ini menggunakan SDK OpenAI, yang dimodelkan pada klien gaya Cursor, dan mencetak objek kesalahan persis.
from openai import OpenAI, APIStatusError
client = OpenAI(base_url="https://api.cursorapikey.com/v1", api_key="YOUR_KEY")
try:
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Write a one-line Python hello world."}],
stream=True,
)
for chunk in r:
print(chunk.choices[0].delta.content or "", end="")
except APIStatusError as e:
print(e.status_code, e.response.headers.get("X-Request-Id"))
print(e.response.text)
Jika skrip mengalirkan teks, endpoint, kunci, dan model sudah benar, maka masalahnya terletak pada pengaturan Cursor. Jika skrip mencetak kode status, gunakan tabel di atas. Simpan nilai X-Request-Id saat menghubungi dukungan, karena nilai tersebut mengidentifikasi permintaan yang tepat. Detail parameter lengkap tersedia di halaman dokumentasi.
Cegah agar tidak rusak lagi
Beberapa kebiasaan mencegah sebagian besar masalah berulang. Simpan kunci dalam satu entitas pengelola kata sandi dan salin dari sana, bukan dari log obrolan atau catatan di mana jeda baris menyusup. Tuliskan tiga nilai (URL dasar, kunci, nama model) agar Anda dapat memasukkannya kembali setelah pembaruan editor, karena pembaruan terkadang mereset override. Setelah setiap pembaruan, kirim satu pesan obrolan pendek sebelum memulai pekerjaan nyata.
Pantau saldo. Header X-Balance-USD disertakan dalam setiap respons, dan Anda juga dapat membacanya melalui GET /v1/balance. Kredit tidak pernah kedaluwarsa, sehingga pengisian kecil yang tersisa di akun tidak terbuang sia-sia. Jika Anda menggunakan kunci dari skrip maupun editor, berikan pekerjaan batch panjang dengan loop retry yang menunggu lima detik saat menerima status 429 dan berhenti setelah beberapa percobaan, agar skrip tidak membatasi slot konkurensi editor Anda.
Pemeriksaan biaya dan apa yang harus dibaca selanjutnya
Permintaan obrolan coding dengan 10.000 token konteks file dan jawaban 700 token biaya 10.000 / 1.000.000 x $0,15 = $0,0015 untuk input dan 700 / 1.000.000 x $0,50 = $0,00035 untuk output, sekitar $0,00185 secara total. Tarifnya adalah $0,15 per 1M input dan $0,50 per 1M token output. Artikel tentang harga API Cursor mencakup perkiraan bulanan.
Jika permintaan yang gagal adalah permintaan besar, ingat jendela: prompt plus penyelesaian harus muat dalam 100.000 token, dan tubuh permintaan dibatasi pada 8 MB. Melampirkan seluruh repositori ke obrolan dapat melebihi keduanya. Potong konteks ke file yang penting dan coba lagi.
Panduan lainnya
Tanya jawab
Mengapa Cursor mengatakan kunci API saya tidak valid?
Biasanya kunci memiliki spasi liar atau disalin sebagian, atau URL dasar masih mengarah ke layanan lain. Salin ulang kunci tersebut, lalu konfirmasi bahwa URL override adalah https://api.cursorapikey.com/v1.
Nama model mana yang harus saya masukkan?
Masukkan uncensored, dalam huruf kecil. Itu adalah satu-satunya ID model yang ditawarkan API.
Apakah autocomplete menggunakan kunci saya?
Tidak selalu. Beberapa fitur Cursor menggunakan model milik Cursor, dan kunci kustom terutama berlaku untuk mode chat dan edit di mana Anda memilih model.
Apakah permintaan yang gagal ditagih?
Tidak. Permintaan yang gagal atau ditolak tidak dikenakan biaya, sehingga mencoba lagi saat Anda melakukan debug tidak memerlukan biaya.
Kunci Anda hanya selangkah lagi dari satu formulir
Buat akun, salin kunci, ubah URL dasar. Itu saja seluruh proses pengaturannya.