Docs / Integrasi
Pakai Cent AI di Roo Code
Atur API provider Roo Code ke OpenAI Compatible dengan base URL Cent AI, API key Anda, dan nama model.
Terakhir diperbarui
Setup Anda
Mengisi YOUR_API_KEY di kode halaman ini. Key hanya ada di tab ini: tidak dikirim dan tidak disimpan.
Provider OpenAI Compatible di Roo Code memakai format OpenAI Chat Completions, jadi ia tersambung ke Cent AI di https://api.cent-ai.dev/v1 dan menambahkan /chat/completions sendiri.
Prasyarat
- Akun Cent AI yang punya saldo. Lihat Mulai cepat.
- API key dari Key. Bentuknya
cai_<secret>dan hanya tampil sekali. - Roo Code sudah terpasang di VS Code.
Atur Roo Code
Buka pengaturan Roo Code (ikon roda gigi di panel Roo Code) lalu isi:
| Pengaturan | Nilai |
|---|---|
| API Provider | OpenAI Compatible |
| Base URL | https://api.cent-ai.dev/v1 |
| API Key | Key Anda, cai_<secret> |
| Model | Nama model persis seperti di daftar GET /v1/models, misalnya glm-5.3 |
Roo Code bekerja lewat tool call, jadi pilih model yang mendukung tool calling.
Di Model Configuration Anda bisa mengatur context window dan maksimum token output model. Pakai nilai yang tercantum untuk model itu di GET /v1/models. Harga input dan output di panel itu hanya dipakai untuk perkiraan biaya milik Roo Code; yang ditagih Cent AI ada di usage.cost dan di halaman Requests.
Coba
Cek key dan nama model dengan satu request. 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 mulai task di Roo Code, misalnya "Jelaskan file ini". Satu task biasanya mengirim beberapa request, satu per langkah. Setiap request tampil di halaman Requests di dashboard beserta token per tarif dan biayanya. Lihat Biaya per request.
Agar cache tetap kena
Roo Code mengirim ulang riwayat task di setiap langkah, jadi sebagian besar input task yang panjang bisa dibaca dari cache model. Cent AI mengirim giliran berikutnya dalam satu percakapan ke rute yang melayani giliran sebelumnya. Cent AI memakai sinyal sesi yang dikirim tool bila ada; tanpa sinyal itu, Cent AI memakai bagian awal prompt yang stabil. Anda tidak perlu menambah apa pun di pengaturan.
- Pakai satu model untuk satu task. Mengganti model, atau model milik mode, di tengah task memulai cache baru.
- Jangan ubah custom instructions dan rules selama task. Perubahan di dekat awal prompt mengubah semua bagian sesudahnya.
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 di API Key salah, terpotong, sudah dicabut, atau berupa management key (cai_mgmt_…). Tempel ulang key, atau buat key baru di Key.
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
Key punya allowlist IP tanpa alamat Anda, atau allowlist model tanpa model di pengaturan Roo Code. Bila mode yang berbeda memakai model yang berbeda, semuanya harus ada di allowlist. Tambahkan alamat atau 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. Beberapa task yang berjalan bersamaan di satu key bisa mencapainya. Tunggu sesuaiRetry-After, atau bagi pekerjaan ke beberapa key. Lihat Rate limit.rate_limitedpada nama:free: pool gratis hari ini sudah habis, atau event sedang mati.Retry-Afterberlaku 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. Provider chat Roo Code hanya butuh /v1/chat/completions, yang sudah tersedia. Bila pengindeksan codebase diatur memakai Cent AI untuk embeddings, ia mendapat 501: /v1/embeddings belum dibuka.
Stream timeout
Bila satu langkah berhenti dengan upstream_timeout atau upstream_unavailable di stream, lihat Stream timeout.