Menu docs

Docs / Integrasi

Pakai Cent AI di OpenCode

Tambahkan Cent AI sebagai penyedia OpenAI-compatible di opencode.json, lalu pilih model berdasarkan namanya.

Terakhir diperbarui

Diuji dengan OpenCode v2.3.0 pada 2026-11-14


Setup Anda

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

OpenCode tersambung ke Cent AI sebagai penyedia OpenAI-compatible 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.
  • OpenCode sudah terpasang. Versi yang kami uji ada di akhir halaman ini.

Atur OpenCode

Tambahkan penyedia di config global ~/.config/opencode/opencode.json, atau di opencode.json pada root proyek:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "centai": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Cent AI",
      "options": {
        "baseURL": "https://api.cent-ai.dev/v1",
        "apiKey": "{env:CENT_AI_KEY}"
      },
      "models": {
        "glm-5.3": { "name": "glm-5.3" }
      }
    }
  },
  "model": "centai/glm-5.3",
  "small_model": "centai/glm-5.3"
}
FieldFungsinya
npm@ai-sdk/openai-compatible, adaptor OpenCode untuk API yang kompatibel dengan OpenAI.
options.baseURLBase URL OpenAI Cent AI, dengan /v1.
options.apiKeyMembaca key dari variabel environment CENT_AI_KEY, jadi key tidak ditulis di file.
modelsModel yang ingin muncul di daftar model OpenCode. Setiap kunci adalah nama persis seperti di daftar GET /v1/models.
model, small_modelModel bawaan dan model untuk tugas ringan seperti judul, dalam bentuk penyedia/model.

Dokumentasi OpenCode sendiri kini juga menampilkan bentuk provider yang lebih baru, dengan providers, package, settings, dan env sebagai pengganti provider, npm, dan options. Dalam uji kami dengan OpenCode 2.3.0, kedua bentuk berjalan dengan Cent AI; halaman ini tetap memakai bentuk di atas.

Isi key di environment, ganti YOUR_API_KEY dengan key Anda:

export CENT_AI_KEY="YOUR_API_KEY"

Bila CENT_AI_KEY kosong, OpenCode mengirim key kosong dan setiap request dijawab 401.

Coba

Cek key dan base URL dengan satu request Chat Completions:

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 jalankan opencode di terminal yang sama, pastikan model yang tampil centai/glm-5.3, lalu kirim satu prompt. 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 OpenCode bila ada; tanpa sinyal itu, Cent AI memakai bagian awal prompt yang stabil, yang dikirim ulang OpenCode 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_…). Pastikan CENT_AI_KEY terisi di terminal tempat Anda menjalankan OpenCode.

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 yang diminta OpenCode. Ingat small_model: model itu juga harus ada di allowlist.

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, atau bagi sesi paralel ke beberapa key.
  • 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. OpenCode hanya butuh /v1/chat/completions, yang sudah tersedia, jadi error ini biasanya berarti baseURL salah.

Stream timeout

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