Docs / SDK
Pakai Cent AI dengan SDK Anthropic TypeScript
Arahkan paket @anthropic-ai/sdk ke Cent AI, kirim request Messages, 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
@anthropic-ai/sdk:
npm install @anthropic-ai/sdk
Atur client
Pakai base URL https://api.cent-ai.dev, tanpa /v1, dan key Cent AI Anda. SDK menambahkan /v1/messages sendiri. Cent AI menerima key di x-api-key maupun Authorization: Bearer.
import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic({
baseURL: "https://api.cent-ai.dev",
apiKey: process.env.CENT_AI_KEY,
});
SDK juga membaca kedua nilai itu dari variabel lingkungan, jadi kode yang memanggil new Anthropic() tanpa opsi tetap jalan tanpa diubah. Ganti YOUR_API_KEY dengan key Anda:
export ANTHROPIC_BASE_URL=https://api.cent-ai.dev
export ANTHROPIC_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
Pakai nama model dari halaman model. max_tokens wajib diisi menurut format Messages.
const m = await client.messages.create({
model: "claude-opus-5",
max_tokens: 1024,
messages: [{ role: "user", content: "Halo" }],
});
for (const block of m.content) {
if (block.type === "text") console.log(block.text);
}
system, tools, thinking, dan cache_control dikirim ke model apa adanya. Lihat Messages dan Prompt caching.
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 };
console.log(m.usage.input_tokens, m.usage.cache_read_input_tokens, m.usage.output_tokens);
console.log((m.usage as CentUsage).cost); // "0.003210000"
Di format ini input_tokens tidak termasuk token cache.
Streaming
Di dalam stream, biaya ada di usage pada event message_delta terakhir. Baca dari event mentah create({ ..., stream: true }):
const stream = await client.messages.create({
model: "claude-opus-5",
max_tokens: 1024,
messages: [{ role: "user", content: "Halo" }],
stream: true,
});
let cost: string | undefined;
for await (const event of stream) {
if (event.type === "content_block_delta" && event.delta.type === "text_delta") {
process.stdout.write(event.delta.text);
} else if (event.type === "message_delta") {
cost = (event.usage as CentUsage).cost ?? cost;
}
}
console.log("\ncost:", cost);
Helper client.messages.stream(...) menyusun pesan akhir untuk Anda, tetapi tidak dijamin menyalin cost ke dalamnya. Bila butuh biayanya, telusuri event-nya dan baca message_delta seperti di atas. 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.messages
.create({ model: "claude-opus-5", max_tokens: 1024, messages: [{ role: "user", content: "Halo" }] })
.withResponse();
console.log(response.headers.get("x-request-id"));
Troubleshooting
Error di /v1/messages memakai bentuk Anthropic: type error mengikuti status HTTP dan pesannya menjelaskan yang terjadi.
| Status | Penyebab umum | Yang perlu dilakukan |
|---|---|---|
| 401 | Key salah atau sudah dicabut, atau key masih ANTHROPIC_API_KEY dari layanan lain | Periksa key, atau buat key baru di Key |
| 402 | Tidak ada saldo yang bisa dipakai untuk model ini | Top-up atau beli paket budget, lihat Saldo |
| 403 | Allowlist IP atau model pada key menolak request, atau project-nya diarsipkan | Ubah allowlist pada key, atau pulihkan project-nya |
| 404 | Nama model tidak ada di Cent AI, atau base URL diakhiri /v1 | Pakai nama dari GET /v1/models dan base URL https://api.cent-ai.dev |
| 429 | Lebih dari 600 request per menit untuk key ini, atau limit harian atau bulanan key atau project tercapai | Baca pesannya; lihat Rate limit |
| 503 atau stream yang berhenti | Model tidak tersedia, tidak mulai tepat waktu, atau stream mencapai durasi maksimum | Lihat Error 5xx dan Stream timeout |
SDK melempar subclass Anthropic.APIError untuk status ini, lengkap dengan status dan headers, dan mencoba ulang sebagian di antaranya sendiri. Semua kode tercantum di Error.