Docs / SDK
Pakai Cent AI dengan SDK OpenAI JavaScript
Arahkan paket npm openai ke Cent AI dari Node.js atau TypeScript dan baca biaya setiap panggilan.
Terakhir diperbarui
Setup Anda
Mengisi YOUR_API_KEY di kode halaman ini. Key hanya ada di tab ini: tidak dikirim dan tidak disimpan.
Prasyarat
- Akun Cent AI yang punya saldo. Lihat Saldo.
- API key dari Key. Bentuknya
cai_<secret>dan hanya tampil sekali. - Node.js dengan paket
openai:
npm install openai
Atur client
Pakai base URL https://api.cent-ai.dev/v1 dan key Cent AI Anda. SDK menambahkan /chat/completions dan /responses sendiri.
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.cent-ai.dev/v1",
apiKey: process.env.CENT_AI_KEY,
});
SDK juga membaca kedua nilai itu dari variabel lingkungan, jadi kode yang memanggil new OpenAI() tanpa opsi tetap jalan tanpa diubah. Ganti YOUR_API_KEY dengan key Anda:
export OPENAI_BASE_URL=https://api.cent-ai.dev/v1
export OPENAI_API_KEY="YOUR_API_KEY"
Panggil Cent AI dari server Anda. Key yang ditaruh di kode browser bisa dibaca siapa pun yang membuka halaman itu; lihat Autentikasi.
Kirim request
Chat Completions dan Responses sama-sama jalan dengan client yang sama. Pakai nama model dari halaman model.
const r = await client.chat.completions.create({
model: "glm-5.3",
messages: [{ role: "user", content: "Halo" }],
});
console.log(r.choices[0].message.content);
Parameter seperti temperature, tools, dan response_format dikirim ke model apa adanya. Parameter yang tidak didukung model kembali sebagai error dari model.
Baca biayanya
Cent AI menambahkan cost ke objek usage standar: jumlah yang ditagih untuk request itu dalam USD, berupa string dengan 9 angka desimal. SDK tidak membuang field tambahan, tetapi tipe-nya tidak mencantumkan cost, jadi perluas tipenya saat membacanya:
type CentUsage = { cost?: string };
const r = await client.chat.completions.create({
model: "glm-5.3",
messages: [{ role: "user", content: "Halo" }],
});
console.log(r.usage?.prompt_tokens, r.usage?.completion_tokens);
console.log((r.usage as CentUsage | undefined)?.cost); // "0.000363000"
Di JavaScript biasa, r.usage.cost langsung bisa dipakai. Di Responses, biaya ada di r.usage dengan cara yang sama.
Streaming
Untuk Chat Completions, minta usage di dalam stream lewat stream_options. Chunk terakhir sebelum stream selesai berisi array choices kosong dan membawa usage, termasuk cost.
const stream = await client.chat.completions.create({
model: "glm-5.3",
messages: [{ role: "user", content: "Halo" }],
stream: true,
stream_options: { include_usage: true },
});
for await (const chunk of stream) {
if (chunk.choices.length > 0) {
process.stdout.write(chunk.choices[0].delta.content ?? "");
}
if (chunk.usage) {
console.log("\ncost:", (chunk.usage as CentUsage).cost);
}
}
Tanpa stream_options.include_usage, stream Chat Completions tidak punya chunk usage dan tidak membawa biaya. Tagihannya tetap tercatat di halaman Requests. Request yang bisa lebih lama dari 100 detik wajib memakai stream; lihat Streaming panjang.
Cek request-nya
Buka halaman Requests di dashboard. Setiap request menampilkan token per tarif, tarif yang dipakai, dan biayanya. Header respons x-request-id sama dengan ID di sana. Untuk membacanya dari SDK:
const { data, response } = await client.chat.completions
.create({ model: "glm-5.3", messages: [{ role: "user", content: "Halo" }] })
.withResponse();
console.log(response.headers.get("x-request-id"));
Troubleshooting
| Status dan kode | Penyebab umum | Yang perlu dilakukan |
|---|---|---|
401 invalid_api_key | Key salah atau sudah dicabut, atau key masih OPENAI_API_KEY dari layanan lain | Periksa key, atau buat key baru di Key |
402 insufficient_balance | Tidak ada saldo yang bisa dipakai untuk model ini | Top-up atau beli paket budget, lihat Saldo |
403 ip_not_allowed, model_not_allowed | Allowlist IP atau model pada key menolak request | Ubah allowlist pada key |
404 model_not_found | Nama model tidak ada di Cent AI | Pakai nama dari GET /v1/models |
| 404 tanpa kode itu | Base URL tidak memakai /v1 | Atur base URL ke https://api.cent-ai.dev/v1 |
429 rate_limited | Lebih dari 600 request per menit untuk key ini | Tunggu sesuai Retry-After, lihat Rate limit |
429 key_limit_exceeded, project_budget_exceeded | Limit harian atau bulanan key atau project tercapai | Naikkan limitnya atau tunggu sampai waktu di pesan |
501 not_available_yet | Endpoint yang belum dibuka, misalnya embeddings | Pakai model chat; lihat Error |
503 upstream_timeout atau stream yang berhenti | Model tidak mulai tepat waktu, atau stream mencapai durasi maksimum | Lihat Stream timeout |
SDK melempar subclass OpenAI.APIError untuk status ini, lengkap dengan status dan code, dan mencoba ulang sebagian di antaranya sendiri. Semua kode tercantum di Error.