Docs / SDK
Pakai Cent AI dengan SDK Anthropic Python
Arahkan paket Python anthropic 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. - Python dengan paket
anthropic:
pip install anthropic
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 os
from anthropic import Anthropic
client = Anthropic(
base_url="https://api.cent-ai.dev",
api_key=os.environ["CENT_AI_KEY"],
)
SDK juga membaca kedua nilai itu dari variabel lingkungan, jadi kode yang memanggil Anthropic() tanpa argumen 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"
Kirim request
Pakai nama model dari halaman model. max_tokens wajib diisi menurut format Messages.
m = client.messages.create(
model="claude-opus-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Halo"}],
)
for block in m.content:
if block.type == "text":
print(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 menyimpan field yang tidak dikenalnya, jadi Anda bisa membacanya sebagai atribut. getattr membuat type checker tidak protes; usage.model_extra mengembalikan semua field tambahan sebagai dict.
print(m.usage.input_tokens, m.usage.cache_read_input_tokens, m.usage.output_tokens)
print(getattr(m.usage, "cost", None)) # "0.003210000"
print(m.usage.model_extra) # {"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):
stream = client.messages.create(
model="claude-opus-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Halo"}],
stream=True,
)
cost = None
for event in stream:
if event.type == "content_block_delta" and event.delta.type == "text_delta":
print(event.delta.text, end="")
elif event.type == "message_delta":
cost = getattr(event.usage, "cost", cost)
print("\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:
raw = client.messages.with_raw_response.create(
model="claude-opus-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Halo"}],
)
print(raw.headers.get("x-request-id"))
m = raw.parse()
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 anthropic.AuthenticationError, anthropic.RateLimitError, dan subclass anthropic.APIStatusError lain untuk status ini, dan mencoba ulang sebagian di antaranya sendiri. Semua kode tercantum di Error.