Menu docs

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.

StatusPenyebab umumYang perlu dilakukan
401Key salah atau sudah dicabut, atau key masih ANTHROPIC_API_KEY dari layanan lainPeriksa key, atau buat key baru di Key
402Tidak ada saldo yang bisa dipakai untuk model iniTop-up atau beli paket budget, lihat Saldo
403Allowlist IP atau model pada key menolak request, atau project-nya diarsipkanUbah allowlist pada key, atau pulihkan project-nya
404Nama model tidak ada di Cent AI, atau base URL diakhiri /v1Pakai nama dari GET /v1/models dan base URL https://api.cent-ai.dev
429Lebih dari 600 request per menit untuk key ini, atau limit harian atau bulanan key atau project tercapaiBaca pesannya; lihat Rate limit
503 atau stream yang berhentiModel tidak tersedia, tidak mulai tepat waktu, atau stream mencapai durasi maksimumLihat 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.