Cara Menggunakan Kunci API GitHub Copilot dengan API Cursor

Memahami Kompatibilitas Kunci API

Ketika pengembang merujuk pada kunci API github copilot, mereka biasanya merujuk pada token yang dibuat dalam ekosistem Microsoft GitHub. Kunci ini mengautentikasi permintaan ke server Microsoft, yang menjalankan model seperti GPT-4o atau varian khusus yang dioptimalkan untuk kode. Meskipun model-model ini kuat, model-model tersebut memiliki filter konten dan batas laju tertentu yang terikat pada akun Microsoft Anda.

Sebaliknya, API Cursor beroperasi sebagai layanan independen. API ini tidak bergantung pada infrastruktur Microsoft. Sebagai gantinya, API ini melayani satu model bahasa besar bobot terbuka yang dioptimalkan untuk konteks pengkodean. Model ini dirancang untuk menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah, menjadikannya alternatif yang berbeda bagi pengembang yang menganggap filter standar membatasi.

Memahami perbedaan ini sangat penting. Kunci API GitHub Copilot Anda yang ada tidak akan berfungsi dengan endpoint API Cursor. Anda memerlukan kunci terpisah yang dibuat dari akun Anda di cursorapikey.com. Namun, protokol dasarnya tetap sama, yang berarti kode Anda tidak perlu berubah secara signifikan.

Mengonfigurasi Lingkungan Anda

Untuk menggunakan API Cursor, Anda terlebih dahulu perlu menghasilkan kunci. Daftar di halaman Dapatkan kunci API hanya dengan email dan kata sandi. Kartu kredit tidak diperlukan untuk kredit uji coba awal. Setelah terdaftar, kunci Anda akan ditampilkan segera. Simpan kunci ini dengan aman di variabel lingkungan Anda, biasanya sebagai OPENAI_API_KEY atau variabel kustom tergantung kebutuhan agen Anda.

Sebagian besar agen pengkodean, termasuk Cursor dan alat serupa, bergantung pada standar SDK OpenAI. Ini berarti Anda tidak memerlukan pustaka khusus. Anda hanya perlu mengarahkan SDK Anda ke URL dasar yang benar. URL dasar untuk API Cursor adalah https://api.cursorapikey.com/v1. Endpoint ini sepenuhnya kompatibel dengan OpenAI, mendukung struktur permintaan yang sama yang sudah Anda kenal.

Pastikan lingkungan Anda dikonfigurasi untuk mengirim permintaan ke URL dasar baru ini. ID model yang harus Anda tentukan dalam permintaan Anda adalah uncensored. Ini memberi tahu API model spesifik mana yang akan dipanggil. Ini adalah model bobot terbuka yang dijalankan di server GPU kami sendiri, berbeda dari GPT, Claude, atau Gemini.

Mengalihkan URL Dasar

Beralih dari kunci API github copilot ke API Cursor terutama melibatkan mengubah URL dasar dalam konfigurasi klien Anda. Jika Anda menggunakan SDK Python atau Node.js OpenAI resmi, ini adalah perubahan satu baris. Misalnya, dalam Python, Anda akan menginisialisasi klien dengan URL dasar baru dan kunci API baru Anda.

Perubahan ini mengarahkan permintaan Anda dari server Microsoft ke infrastruktur kami. Manfaatnya termasuk akses ke jendela konteks 100.000 token dan model yang disesuaikan untuk penolakan yang lebih sedikit. Anda dapat memverifikasi koneksi dengan memeriksa endpoint /v1/models, yang harus mengembalikan model yang tersedia, termasuk uncensored.

Pertukaran: Meskipun sintaksnya identik, Anda sekarang membayar per token daripada melalui langganan Microsoft. Harga kami transparan: $0,25 per 1M token input dan $1,00 per 1M token output. Tidak ada biaya bulanan, hanya kredit bayar-per-penggunaan yang tidak pernah kedaluwarsa. Model ini ideal untuk beban kerja variabel di mana Anda tidak ingin berkomitmen pada biaya kursi bulanan.

Menguji Koneksi Anda

Sebelum mengintegrasikan API ke dalam alur kerja utama Anda, penting untuk memverifikasi bahwa lingkungan Anda dapat berkomunikasi dengan API Cursor. Anda dapat melakukan ini dengan perintah cURL sederhana atau skrip pendek. Pengujian ini memastikan kunci Anda valid dan URL dasar benar.

Contoh permintaan cURL:

Kirim permintaan POST ke https://api.cursorapikey.com/v1/chat/completions dengan model diatur ke uncensored. Sertakan prompt sederhana dalam array messages. Respons yang berhasil akan mengembalikan hasil di bidang choices[0].message.content.

Jika Anda menerima kesalahan 401, kunci API Anda salah. Jika Anda mendapatkan kesalahan 429, Anda telah melebihi batas laju 300 permintaan per menit per kunci. Anda dapat membuat ulang kunci Anda kapan saja untuk membuat kunci lama tidak valid. Pengujian ini mengonfirmasi bahwa fungsionalitas teks-masuk, teks-keluar dasar berfungsi sebagaimana mestinya.

Menangani Respons Streaming

Untuk agen pengkodean, respons streaming sangat penting untuk memberikan pengalaman pengguna yang mulus. API Cursor mendukung Server-Sent Events (SSE) untuk streaming. Ini memungkinkan Anda menerima token saat token tersebut dihasilkan, alih-alih menunggu respons lengkap.

Saat menggunakan SDK OpenAI, Anda dapat mengaktifkan streaming dengan mengatur parameter stream menjadi true. SDK akan menghasilkan potongan data saat potongan tersebut tiba. Ini sangat berguna untuk generasi kode panjang, di mana Anda ingin menampilkan kemajuan kepada pengguna atau memasukkan token ke editor langsung.

Perhatikan bahwa streaming tidak mengubah model mendasar atau kemampuannya. Ini murni mekanisme pengiriman. Model uncensored masih akan mematuhi jendela konteks 100.000 token dan struktur harga yang sama. Streaming adalah fitur sisi klien yang meningkatkan latensi persepsi tanpa memengaruhi perilaku model.

Integrasi Pemanggilan Alat

Asisten pengkodean AI modern sangat bergantung pada pemanggilan alat (pemanggilan fungsi) untuk berinteraksi dengan dunia luar, seperti menjalankan perintah shell atau mengakses file. API Cursor mendukung ini melalui format yang kompatibel dengan OpenAI standar.

Anda dapat menentukan alat dalam permintaan Anda menggunakan parameter tools. Model akan merespons dengan array tool_calls jika menentukan alat harus digunakan. Aplikasi Anda kemudian harus menjalankan alat dan mengirimkan hasilnya kembali ke API dalam pesan berikutnya.

Proses ini identik dengan cara Anda menggunakan kunci API github copilot dengan model Microsoft. Keuntungannya di sini adalah konsistensi. Jika Anda memiliki kode yang ada untuk pemanggilan alat, Anda kemungkinan besar dapat menggunakannya kembali dengan penyesuaian minimal. Pastikan saja definisi alat Anda cocok dengan skema yang diharapkan untuk model uncensored.

Memantau Penggunaan

Karena Anda membayar per token, memantau penggunaan Anda penting untuk menghindari biaya tak terduga. API Cursor menyediakan dasbor tempat Anda dapat melihat saldo kredit dan riwayat penggunaan Anda. Anda dapat melihat berapa banyak token yang telah Anda konsumsi dan berapa banyak kredit yang tersisa.

Batasan kunci yang perlu diperhatikan:

• Batas laju: 300 permintaan per menit per kunci.
• Ukuran badan permintaan: Maksimal 8 MB per permintaan.
• Jendela konteks: 100.000 token total (input + output).

Jika Anda melebihi batas laju, Anda akan menerima kesalahan 429. Anda dapat memantau penggunaan Anda secara real-time untuk memastikan Anda tetap dalam batas-batas ini. Selain itu, Anda dapat membuat ulang kunci API Anda jika Anda mencurigai kunci tersebut telah disusupi, yang segera membuat kunci lama tidak valid.

Pemecahan Masalah Umum

Meskipun dengan API yang kuat, masalah dapat muncul. Berikut adalah beberapa masalah umum dan solusinya.

401 Tidak Diotorisasi: Periksa kunci API Anda. Pastikan kunci tersebut disalin dengan benar dan tidak memiliki spasi di awal atau akhir. Jika Anda membuat ulang kunci, pastikan Anda menggunakan kunci baru.

429 Terlalu Banyak Permintaan: Anda telah melebihi batas 300 permintaan per menit. Terapkan backoff eksponensial di klien Anda atau kurangi frekuensi permintaan Anda.

400 Bad Request: Ini biasanya menunjukkan payload JSON yang tidak valid atau bidang yang diperlukan hilang. Pastikan array messages Anda diformat dengan benar dan menyertakan bidang role dan content. Selain itu, verifikasi bahwa nama model persis uncensored.

Pemblokiran Konten: Meskipun modelnya tanpa sensor, model ini memblokir konten seksual yang melibatkan anak di bawah umur. Jika permintaan Anda diblokir, hal itu mungkin disebabkan oleh batas keras ini.