Menu docs

Docs / Integrasi

Pakai Cent AI di Cursor

Jadikan Cent AI sebagai base URL OpenAI di Cursor, tempel key, lalu tambahkan model berdasarkan namanya.

Terakhir diperbarui


Setup Anda

Mengisi YOUR_API_KEY di kode halaman ini. Key hanya ada di tab ini: tidak dikirim dan tidak disimpan.

Cursor tersambung ke Cent AI lewat pengaturan OpenAI API key, dengan base URL https://api.cent-ai.dev/v1.

Prasyarat

  • Akun Cent AI yang punya saldo. Lihat Mulai cepat.
  • API key dari Key. Bentuknya cai_<secret> dan hanya tampil sekali.
  • Cursor sudah terpasang.

Atur Cursor

Buka Cursor Settings lalu masuk ke Models. Isi nilai berikut:

PengaturanNilai
OpenAI API KeyKey Anda, cai_<secret>
Override OpenAI Base URLAktif, dengan https://api.cent-ai.dev/v1
Model kustomglm-5.3, atau nama lain persis seperti di daftar GET /v1/models
  1. Tempel key di kolom OpenAI API Key.
  2. Aktifkan Override OpenAI Base URL dan isi https://api.cent-ai.dev/v1. Biarkan /v1: Cursor menambahkan sisa path-nya.
  3. Tambahkan glm-5.3 sebagai model kustom dan pastikan model itu aktif.
  4. Simpan.

Yang perlu diketahui tentang pengaturan ini di Cursor:

  • Cursor mengirim request lewat servernya sendiri, lalu server itu memanggil Cent AI. Request sampai ke Cent AI dari alamat Cursor, bukan dari komputer Anda.
  • Selama aktif, override base URL berlaku untuk semua model OpenAI di Cursor. Matikan untuk kembali ke model bawaan Cursor.
  • Key Anda dipakai untuk chat. Tab completion tetap memakai model bawaan Cursor.

Coba

Cek key dan base URL di luar Cursor lebih dulu. Ganti YOUR_API_KEY dengan key Anda:

export CENT_AI_KEY="YOUR_API_KEY"

curl https://api.cent-ai.dev/v1/chat/completions \
  -H "Authorization: Bearer $CENT_AI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"glm-5.3","messages":[{"role":"user","content":"Halo"}]}'

Respons memuat usage.cost, jumlah yang ditagih untuk request ini dalam USD. Setelah itu buka panel chat di Cursor, pilih glm-5.3, lalu kirim pesan. Setiap giliran tampil di halaman Requests di dashboard beserta token per tarif dan biayanya. Lihat Biaya per request.

Agar cache tetap kena

Cent AI menjaga giliran-giliran satu percakapan tetap di rute yang sama tanpa pengaturan apa pun dari Anda. Cent AI memakai sinyal sesi yang dikirim Cursor bila ada; tanpa sinyal itu, Cent AI memakai bagian awal prompt yang stabil, yang dikirim ulang Cursor di setiap giliran. Anda tidak perlu menambah apa pun di konfigurasi.

Cent AI tidak menjanjikan tingkat cache hit. Token cache hanya ditagih bila model melaporkannya. Lihat Prompt caching.

Troubleshooting

Untuk menelusuri request yang gagal, cari x-request-id dari respons di halaman Requests. Semua kode ada di Error 4xx dan Error 5xx.

401 invalid_api_key

Key salah, terpotong, sudah dicabut, atau berupa management key (cai_mgmt_…). Tempel ulang key di kolom OpenAI API Key, tanpa spasi di depan atau belakangnya.

402 insufficient_balance

Saldo yang bisa dipakai untuk model ini kosong, atau model itu tidak termasuk paket budget Anda. Top-up atau beli paket. Lihat Saldo.

403 ip_not_allowed atau model_not_allowed

  • ip_not_allowed: request datang dari server Cursor, bukan dari komputer Anda, jadi allowlist IP berisi alamat Anda sendiri akan memblokirnya. Hapus allowlist IP dari key yang dipakai di Cursor dan pakai limit harian atau bulanan sebagai gantinya.
  • model_not_allowed: key punya allowlist model tanpa model yang Anda pilih. Tambahkan model itu ke key.

404 model_not_found

Nama model itu tidak dilayani Cent AI. Salin nama persisnya dari Model atau GET /v1/models; nama dari penyedia lain, misalnya gpt-4o-mini, bukan alias. Nama :free hanya berlaku untuk model event hari ini (lihat Token gratis harian); di model lain, termasuk model event hari sebelumnya, hasilnya 404.

429 rate_limited, key_limit_exceeded, atau project_budget_exceeded

  • rate_limited: lebih dari 600 request per menit di key ini. Tunggu sesuai Retry-After.
  • rate_limited pada nama :free: pool gratis hari ini sudah habis, atau event sedang mati. Retry-After berlaku sampai 00:00 UTC; nama asli model tetap bisa dipakai dengan harga normal.
  • key_limit_exceeded: limit harian atau bulanan yang Anda pasang di key sudah tercapai.
  • project_budget_exceeded: budget project pemilik key sudah tercapai.

501 not_available_yet

Endpoint itu belum dibuka. Chat di Cursor memakai endpoint chat, yang sudah tersedia, jadi error ini biasanya berarti base URL salah.

Stream timeout

Jawaban yang panjang di-stream dengan : keepalive setiap 15 detik. Bila jawaban berhenti dengan upstream_timeout atau upstream_unavailable, lihat Stream timeout.