API Codex untuk Cursor: Sambungkan Model Tanpa Sensor

Yang sedang Anda siapkan

Cursor adalah editor yang mendukung penyedia model kustom. Jika Anda memberikannya base URL gaya OpenAI, kunci, dan nama model, editor akan mengirim permintaan obrolan ke sana, bukan ke penyedia defaultnya. Layanan ini menggunakan protokol tersebut: POST /v1/chat/completions dengan autentikasi Bearer, serta GET /v1/models.

Dua hal yang perlu dipahami di awal. Ini adalah API independen yang menjalankan satu model bobot terbuka, bukan Codex OpenAI dan bukan produk resmi Cursor. Dan Cursor sering mengubah layar pengaturannya, sehingga label di bawah ini mungkin berada di tempat yang sedikit berbeda di versi Anda. Tiga nilai tidak pernah berubah: base URL, kunci, nama model.

Langkah 1: dapatkan kunci dan uji di luar Cursor

Daftar di halaman kunci API dengan Google atau dengan email dan kata sandi. Akun baru dapat mengklaim $0,50 kredit uji coba dengan satu klik, berlaku selama 7 hari, tanpa kartu. Itu cukup untuk menguji pengaturan editor.

Sebelum menyentuh Cursor, pastikan kunci berfungsi. Kegagalan di dalam editor lebih sulit dibaca daripada kegagalan di terminal.

Copycurl https://api.getcodexapi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a Python function that reverses a string."}]
  }'

Jika Anda mendapatkan balasan JSON dengan kode di dalamnya, lanjutkan. Jika Anda mendapatkan kesalahan, perbaiki di sini terlebih dahulu. Penyebab umum adalah karakter yang hilang di kunci atau spasi yang ditempelkan di akhir.

Langkah 2: konfigurasi Cursor

1. Buka pengaturan Cursor dan buka bagian model.
2. Temukan bidang untuk kunci API OpenAI dan tempel kunci Anda dari layanan ini.
3. Aktifkan opsi untuk mengganti base URL OpenAI, dan masukkan https://api.getcodexapi.com/v1.
4. Tambahkan model kustom dan ketik nama persis uncensored.
5. Jalankan tombol verifikasi jika ada, lalu buka panel obrolan dan pilih uncensored dari daftar model.

Jika langkah verifikasi melaporkan kegagalan, periksa tiga hal secara berurutan: base URL berakhir dengan /v1 tanpa jalur endpoint setelahnya, kunci telah ditempelkan tanpa spasi di akhir, dan nama model tidak memiliki huruf kapital. Panduan di halaman dokumentasi mencantumkan nilai yang sama dengan contoh klien tambahan.

Satu hal yang perlu direncanakan: penggantian adalah pengaturan, bukan pilihan per-model, jadi jika Anda juga menggunakan kunci OpenAI Anda sendiri di tempat lain di Cursor, matikan penggantian terlebih dahulu. Simpan catatan tentang apa yang Anda ubah.

Setelah menyimpan, ajukan pertanyaan pemrograman sederhana kepada model di obrolan dan perhatikan balasannya. Jawaban pertama yang lambat adalah hal normal saat Cursor membangun permintaan Anda. Jika jawaban kembali, Anda telah terhubung, dan langkah selanjutnya adalah mencobanya pada pekerjaan nyata di repositori Anda sendiri.

Apa yang akan dan tidak akan melalui kunci Anda

Cursor menggabungkan beberapa fitur. Permintaan obrolan dan edit inline adalah yang paling mungkin menggunakan model kustom Anda setelah Anda memilihnya. Fitur lain, seperti pelengkapan otomatis Tab, secara historis menggunakan model yang dijalankan oleh Cursor sendiri, dan fitur bergaya agen mungkin bergantung pada cara Cursor menangani alat. Cara jujur untuk mengetahuinya adalah mencoba fitur yang Anda andalkan dan perhatikan saldo Anda.

Itu mudah dilakukan: setiap respons dari API ini membawa header X-Balance-USD, dan saldo Anda terlihat di akun Anda. Jika Anda mengirim pesan obrolan dan saldo tidak berubah, permintaan itu tidak dikirim kepada kami.

Pemanggilan fungsi didukung di endpoint ini (tools, tool_choice, streaming tool_calls, dan hasil sebagai role: "tool"), yang dibutuhkan oleh agen editor. Streaming bekerja melalui server-sent events dengan stream: true. Jendela konteks adalah 100.000 token, gabungan prompt dan penyelesaian, sehingga file besar plus tetangganya muat dalam satu permintaan.

Mengapa menggunakan model tanpa sensor di editor

Sebagian besar pekerjaan pemrograman tidak pernah mencapai penolakan. Ketika itu terjadi, itu cenderung untuk tugas-tugas sah yang terlihat berisiko oleh filter yang berhati-hati: menulis pemindai port untuk jaringan Anda sendiri, menguraikan sampel malware yang Anda analisis, menghasilkan data pengujian yang termasuk bahasa ofensif, membangun back end aplikasi roleplay atau teman untuk orang dewasa, atau melakukan refactoring kode yang menangani moderasi konten. Model ini disesuaikan untuk menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah.

Ini tetap satu model bobot terbuka umum, bukan model kode spesialis, dan tidak ada di sini yang berjanji bahwa model ini mengalahkan alternatif tertentu pada basis kode Anda. Jalankan tugas Anda sendiri melalui model ini. Satu aturan tetap: tidak ada konten seksual yang melibatkan anak di bawah umur, dan itu tidak dapat diubah.

Biaya yang sebenarnya

Harga adalah $0,15 per 1 juta token input dan $0,50 per 1 juta token output, dari saldo prabayar tanpa langganan. Lalu lintas editor bersifat dominan input, karena setiap permintaan mengirim ulang konteks file.

Permintaan dengan 8.000 token input dan 1.000 token output berbiaya 8.000 x $0,15 / 1.000.000 = $0,0012 untuk input, ditambah 1.000 x $0,50 / 1.000.000 = $0,0005 untuk output, yang merupakan $0,0017. Jika Anda membuat 150 dari itu dalam sehari yang berat, itu adalah 150 x $0,0017 = $0,255, sekitar 26 sen.

Permintaan yang mengirim 40.000 token konteks dan mendapatkan 1.500 kembali berbiaya $0,006 + $0,00075 = $0,00675. Top-up dimulai pada $20 dan kredit tidak pernah kedaluwarsa, sehingga tidak ada tekanan untuk menggunakannya habis. Lihat halaman harga untuk tier bonus, dan halaman API coding untuk gambaran umum.

Batas laju untuk penggunaan editor

Kunci penuh memungkinkan 8 permintaan paralel dan 300 permintaan per menit. Kunci uji coba memungkinkan 2 paralel dan 60 per menit. Satu orang mengetik di satu editor jarang mendekati salah satu, tetapi tim yang berbagi satu kunci, atau agen yang menembakkan banyak permintaan paralel, bisa. Ketika Anda melebihi batas, API mengembalikan HTTP 429. Kode rate_limited berarti terlalu banyak permintaan per menit, dan concurrency berarti terlalu banyak pada saat yang sama. Jika layanan kelebihan beban secara singkat, Anda juga melihat 429 dengan Retry-After: 5.

Obrolan streaming memegang slot konkurensinya hingga stream berakhir. Untuk penggunaan bersama, berikan setiap pengembang kunci mereka sendiri daripada satu kunci untuk tim.

Daftar periksa pemecahan masalah

• Model tidak ditemukan. Ketik ulang uncensored tanpa spasi. Hapus model kustom lama yang tidak Anda gunakan.
• Kesalahan autentikasi. Salin ulang kunci. Pastikan Cursor tidak masih menggunakan kunci dari penyedia lain.
• Balasan berhenti awal. Periksa apakah Cursor menetapkan batas outputnya sendiri. Di sisi kami, max_tokens adalah opsional.
• Tidak ada perubahan di saldo Anda. Fitur yang Anda gunakan tidak dialihkan melalui kunci kustom Anda. Coba obrolan sebagai gantinya.
• 429 sering terjadi. Kurangi permintaan paralel, atau gunakan kunci penuh daripada kunci uji coba.

Panduan lainnya

• Harga API Codex: Tarif dan Contoh Berbasis Token
• Base URL API Codex: Cara Mengarahkan Klien Anda ke Kami
• API LLM Tanpa Sensor untuk Cursor