ID ▾
Dapatkan kunci API

cursorapikey.com/Panduan

Cara Menggunakan Kunci API Cursor dengan Endpoint Kustom

Berikut cara menggunakan pengaturan API Cursor dengan endpoint Anda sendiri: tempel kunci, ganti URL dasar OpenAI, dan tambahkan nama model uncensored. Langkah-langkah di bawah ini memakan waktu sekitar lima menit dan mencakup pemeriksaan curl yang dapat Anda jalankan terlebih dahulu.

Diperbarui

Editor kode isometrik terhubung dengan kabel bercahaya ke kubus server, mengilustrasikan endpoint API kustom

Poin utama

  • Cursor memungkinkan Anda mengganti URL dasar OpenAI dan kunci, sehingga endpoint yang kompatibel dengan OpenAI dapat melayani permintaan.
  • Gunakan URL dasar https://api.cursorapikey.com/v1 dan ID model uncensored.
  • Uji kunci dengan curl sebelum menyentuh editor, agar Anda tahu dari sisi mana kegagalan berasal.
  • Prompt 20.000 token dengan jawaban 1.000 token berharga $0,0035.

Apa yang dicakup panduan ini

Orang yang mencari cara menggunakan API Cursor biasanya merujuk pada salah satu dari dua hal. Baik mereka ingin memanggil beberapa layanan Cursor dari kode, atau mereka ingin editor Cursor mengirim permintaan model ke endpoint yang mereka pilih. Panduan ini tentang kasus kedua. Situs ini adalah API yang dihosting secara independen yang menggunakan protokol chat completions OpenAI, sehingga Cursor dapat berbicara dengannya sama seperti cara ia berbicara dengan server gaya OpenAI mana pun.

Model di baliknya adalah satu model open-weight, dijalankan oleh penyedia independen dan disesuaikan untuk menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah. Ini bukan model Cursor resmi, dan ini bukan router lintas vendor. Ini hanya menangani teks. Untuk pengkodean, ini biasanya cukup: Anda mengirim kode dan instruksi, Anda mendapatkan kode dan penjelasan kembali.

Anda membutuhkan tiga hal: kunci API, URL dasar https://api.cursorapikey.com/v1, dan ID model uncensored. Sisanya hanya masalah menemukan bidang yang tepat di editor.

Langkah 1: dapatkan kunci dan periksa dengan curl

Daftar dengan Google atau dengan email dan kata sandi, lalu buka halaman kunci API. Akun baru dapat mengklaim $0,50 kredit uji coba di sana dengan satu klik. Tidak memerlukan kartu dan berlaku selama 7 hari. Kunci uji terbatas pada 2 permintaan paralel dan 60 permintaan per menit, yang cukup untuk sesi pertama di editor.

Sebelum Anda membuka Cursor, konfirmasi kunci berfungsi. Jalankan ini di terminal, dengan kunci Anda dalam variabel lingkungan:

export API_KEY="paste-your-key-here"

curl https://api.cursorapikey.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

curl https://api.cursorapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "user", "content": "Write a Python function that reverses a linked list."}
    ]
  }'

Panggilan pertama mencantumkan model. Panggilan kedua mengembalikan penyelesaian chat normal. Jika keduanya berhasil, kegagalan selanjutnya di editor adalah masalah pengaturan dan bukan masalah kunci. Pemisahan ini menghemat banyak tebakan.

Langkah 2: atur URL dasar dan kunci di Cursor

Buka pengaturan Cursor dan buka bagian model. Nama menu dan tata letak berubah antar rilis, jadi perlakukan label di bawah ini sebagai peta dan periksa dokumentasi Cursor sendiri jika ada yang berubah.

  1. Temukan bidang untuk kunci API OpenAI dan tempel kunci Anda dari situs ini.
  2. Aktifkan opsi untuk mengganti URL dasar OpenAI dan masukkan https://api.cursorapikey.com/v1. Pertahankan /v1 di akhir dan jangan tambahkan /chat/completions; aplikasi klien menambahkan jalur itu sendiri.
  3. Tambahkan model kustom dan ketik uncensored persis, huruf kecil.
  4. Gunakan tombol verifikasi atau simpan jika editor menawarkan salah satunya, lalu pilih model baru di panel obrolan.

Kirim pesan singkat seperti "jelaskan fungsi ini" dengan file terbuka. Jawaban streaming berarti rute berfungsi dari awal hingga akhir. Cursor mengirim permintaan, endpoint melakukan streaming token kembali melalui SSE, dan editor merendernya saat tiba.

Dua peringatan. Beberapa fitur editor, seperti pelengkapan otomatis Tab inline, mungkin berjalan pada model yang dikontrol Cursor dan dapat mengabaikan kunci Anda, jadi periksa fitur mana yang sebenarnya menggunakan model kustom. Dan karena Cursor mungkin mengarahkan lalu lintas kunci kustom melalui servernya sendiri, baca dokumentasi terbarunya jika Anda perlu mengetahui secara tepat ke mana kode Anda berjalan. quickstart di situs ini mencantumkan sisi API dari kontrak tersebut.

Uji endpoint yang sama dari kode

Cara termudah untuk mengisolasi masalah adalah memanggil endpoint dengan SDK OpenAI resmi. Jika itu berhasil, endpoint baik-baik saja dan masalah yang tersisa ada di konfigurasi editor.

from openai import OpenAI

client = OpenAI(
    api_key="paste-your-key-here",
    base_url="https://api.cursorapikey.com/v1",
)

stream = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You are a terse senior engineer."},
        {"role": "user", "content": "Refactor this loop into a list comprehension: out = []\nfor x in xs:\n    if x > 0:\n        out.append(x * 2)"},
    ],
    stream=True,
)

for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

Hal yang sama di Node:

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.API_KEY,
  baseURL: "https://api.cursorapikey.com/v1",
});

const res = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Write a regex that matches ISO 8601 dates." }],
});

console.log(res.choices[0].message.content);

Respons streaming menyertakan penggunaan di akhir, sehingga Anda dapat mencatat tepat berapa banyak token yang digunakan permintaan. Setiap respons juga membawa header X-Balance-USD dengan sisa kredit Anda dan X-Request-Id yang dapat Anda kutip jika ada yang terlihat salah.

Apa yang berfungsi dalam alur kerja pengkodean

API mendukung streaming, mode JSON, dan pemanggilan fungsi (tools, tool_choice, tool_calls streaming, dan hasil dikirim kembali sebagai role: "tool"). Pengaturan sampling seperti temperature, top_p, stop, seed dan penalti diteruskan. Jendela konteks adalah 100.000 token, dibagi antara prompt dan penyelesaian, dan max_tokens bersifat opsional.

100.000 token itu adalah anggaran yang besar untuk kode. File sumber beberapa ratus baris adalah beberapa ribu token, sehingga Anda dapat menyertakan beberapa file plus instruksi panjang dan masih menyisakan ruang untuk jawaban. Ukuran body permintaan maksimum adalah 8 MB, yang tidak akan Anda capai dengan teks.

Beberapa kebiasaan yang membuat model kustom menyenangkan di editor:

  • Pertahankan temperature rendah untuk edit kode. Nilai sekitar 0,2 memberikan output yang lebih stabil; naikkan hanya untuk brainstorming.
  • Lampirkan hanya file yang penting. Setiap token yang Anda kirim ditagih sebagai input, dan seluruh percakapan dikirim ulang di setiap giliran.
  • Minta diff atau fungsi yang diubah, bukan seluruh file, ketika filenya panjang. Token output lebih mahal daripada token input.
  • Gunakan model untuk tugas di mana penolakan menjadi penghalang, seperti menulis proof-of-concept eksploit untuk lab Anda sendiri, menganalisis sampel malware yang berwenang Anda pelajari, atau menghasilkan data uji yang meniru konten dunia nyata yang kasar. Semua itu harus sah.

Satu batas keras yang layak diulang: tidak ada konten seksual yang melibatkan anak di bawah umur, dalam bentuk apa pun.

Memperbaiki kesalahan umum

GejalaPenyebab yang mungkinPerbaikan
401 atau "kunci tidak valid"Kunci ditempel dengan spasi, atau kunci lamaSalin ulang dari halaman kunci; uji dengan curl
404 atau "model tidak ditemukan"Nama model diketik berbedaGunakan uncensored, huruf kecil, tanpa akhiran
404 pada jalurURL dasar menyertakan /chat/completionsAkhiri URL dasar di /v1
429 dengan concurrencyTerlalu banyak permintaan sekaligusTunggu hingga stream selesai; kunci penuh memungkinkan 8, kunci uji 2
429 dengan rate_limitedLebih dari 300 permintaan per menit (60 pada uji coba)Perlambat, atau coba lagi setelah jeda
429 dengan Retry-After: 5Beban berlebih sementaraCoba lagi setelah lima detik

Permintaan streaming memegang slot konkurensinya hingga stream berakhir. Jika Anda memulai beberapa obrolan di Cursor dan membiarkannya menghasilkan, Anda dapat mencapai batas konkurensi pada kunci uji coba dengan cepat. Permintaan yang gagal atau ditolak tidak dikenakan biaya, sehingga mencoba lagi tidak memerlukan biaya tambahan.

Biaya sesi pengkodean

Harga adalah $0,15 per 1M token masukan dan $0,50 per 1M token keluaran, dibayar dari saldo prabayar tanpa langganan. Permintaan editor khas memiliki prompt besar (file Anda) dan jawaban singkat. Ambil 20.000 token masukan dan 1.000 token keluaran:

  • Input: 20.000 x $0,15 / 1.000.000 = $0,0030
  • Output: 1.000 x $0,50 / 1.000.000 = $0,0005
  • Total: $0,0035 per permintaan

Pada 100 permintaan dalam satu hari kerja itu adalah $0,35. Kredit uji coba $0,50 mencakup sekitar 140 permintaan seperti itu. Setelah uji coba, Anda dapat mengisi saldo dengan jumlah bulat apa pun dari $20 hingga $500, dengan bonus kredit +5% dari $50, +10% dari $100 dan +15% dari $200. Bayar dengan kripto (USDT pada TRC20, USDC pada Base). Saldo tidak pernah kedaluwarsa, sehingga pengisian ulang yang Anda gunakan secara perlahan tidak sia-sia. Halaman harga memiliki tabel lengkap, dan halaman tentang alternatif Cursor dan Copilot menjelaskan di mana ini cocok di samping editor berlangganan.

Prompt tidak digunakan untuk pelatihan.

01

Tanya jawab

Apakah ini berfungsi dengan agen Cursor dan pemanggilan fungsi?

API mendukung pemanggilan fungsi dengan alat, tool_choice dan tool_calls yang di-streaming. Apakah fitur Cursor tertentu menggunakan model kustom Anda tergantung pada editor, jadi uji setiap fitur setelah penyiapan.

Nama model mana yang harus saya masukkan?

Masukkan uncensored, dalam huruf kecil. Itu adalah satu-satunya ID model, dan GET /v1/models mencantumkannya.

Apakah ini API Cursor resmi?

Tidak. Ini adalah API yang kompatibel dengan OpenAI independen di depan satu model bobot terbuka. Cursor hanya memungkinkan Anda mengarahkan pengaturan OpenAI-nya ke endpoint yang berbeda.

Apakah saya memerlukan kartu untuk mencobanya?

Tidak. Kredit uji coba senilai $0,50 diklaim dengan satu klik di halaman kunci API setelah masuk, tidak memerlukan kartu, dan berlaku selama 7 hari.

Kunci Anda hanya selangkah lagi dari satu formulir

Buat akun, salin kunci, ubah URL dasar. Itu saja seluruh proses pengaturannya.