Docs / Integrasi
Pakai Cent AI di Codex
Tambahkan Cent AI sebagai penyedia model di file config Codex dan simpan key di variabel environment.
Terakhir diperbarui
Diuji dengan Codex v0.161.0 pada 2026-11-13
Setup Anda
Mengisi YOUR_API_KEY di kode halaman ini. Key hanya ada di tab ini: tidak dikirim dan tidak disimpan.
Codex CLI memakai format OpenAI Responses, jadi ia tersambung ke Cent AI di https://api.cent-ai.dev/v1 dan menambahkan /responses sendiri.
Prasyarat
- Akun Cent AI yang punya saldo. Lihat Mulai cepat.
- API key dari Key. Bentuknya
cai_<secret>dan hanya tampil sekali. - Codex CLI sudah terpasang. Versi yang kami uji ada di akhir halaman ini.
Atur Codex
Codex membaca penyedia kustom dari file config pengguna ~/.codex/config.toml (di Windows %USERPROFILE%\.codex\config.toml). File .codex/config.toml milik proyek tidak bisa mendefinisikan penyedia. Tambahkan:
model = "gpt-6-sol"
model_provider = "centai"
[model_providers.centai]
name = "Cent AI"
base_url = "https://api.cent-ai.dev/v1"
env_key = "CENT_AI_KEY"
wire_api = "responses"
| Field | Fungsinya |
|---|---|
model | Model untuk sesi baru. Tulis nama persis seperti di daftar GET /v1/models. |
model_provider | Memilih penyedia centai yang didefinisikan di bawahnya. |
base_url | Base URL OpenAI Cent AI, dengan /v1. |
env_key | Variabel environment yang berisi key Anda. Codex mengirimnya sebagai Authorization: Bearer. |
wire_api | responses, format yang dipakai Codex. |
Key tidak ditulis di file. Isi di environment, ganti YOUR_API_KEY dengan key Anda:
export CENT_AI_KEY="YOUR_API_KEY"
Agar tetap ada di terminal lain, tambahkan baris yang sama ke profil shell, misalnya ~/.bashrc atau $PROFILE PowerShell.
Coba
Cek key dan base URL dengan satu request Responses:
curl https://api.cent-ai.dev/v1/responses \
-H "Authorization: Bearer $CENT_AI_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-6-sol","input":"Halo"}'
Respons memuat usage.cost, jumlah yang ditagih untuk request ini dalam USD. Setelah itu jalankan codex di terminal yang sama dan 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
Codex mengirim header Session-Id dan field prompt_cache_key yang nilainya sama selama satu percakapan, termasuk saat percakapan dilanjutkan. Cent AI memakai sinyal itu untuk mengirim setiap giliran ke rute yang melayani giliran sebelumnya, agar cache model bisa kena. 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 Codex, dan env_key di config.toml menyebut variabel yang sama.
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 ada di config.toml. 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. Tunggu sesuaiRetry-After, atau bagi sesi paralel ke beberapa key.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. Codex hanya butuh /v1/responses, yang sudah tersedia, jadi error ini biasanya berarti base_url 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.