ID ▾
Dapatkan kunci API

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

Panel editor kode abstrak dengan kunci yang sedang dimasukkan, kunci inggris, dan kaca pembesar di sampingnya
Cabang isometrik dengan jalur menuju editor, server, dan terminal, menggambarkan pemilihan alternatif untuk Cursor

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.

  1. Kunci API OpenAI: tempel kunci Anda tanpa spasi atau jeda baris di kedua ujungnya.
  2. Atur ulang URL dasar OpenAI: aktifkan pengaturan ulang dan masukkan https://api.cursorapikey.com/v1. Pertahankan /v1 dan jangan sertakan /chat/completions.
  3. Model kustom: tambahkan model bernama uncensored dan 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 lihatPenyebab yang mungkinPerbaikan
401, "kunci tidak valid", "tidak berwenang"Ketik kunci salah, terpotong, atau dicabutSalin lagi dari halaman kunci; periksa spasi di akhir
404, "tidak ditemukan"URL salah, hilang /v1, atau path gandaGunakan tepat https://api.cursorapikey.com/v1
"model tidak ditemukan" atau serupaNama model berbeda dari uncensoredTambahkan model kustom dengan nama persis itu, huruf kecil
429 dengan rate_limitedMelebihi batas permintaan per menitPerlambat; kunci uji coba mengizinkan 60 per menit, kunci penuh 300
429 dengan concurrencyTerlalu banyak permintaan sekaligusKurangi menjalankan agen paralel; uji 2, kunci penuh 8
429 dengan Retry-After: 5Beban berlebih sementaraTunggu lima detik dan coba lagi
Berfungsi di curl, gagal di CursorPengaturan tidak disimpan, model tab salah, atau fitur yang tidak menggunakan kunci kustomLihat 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.

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.

01

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.