Docs / Konsep
Biaya per request
Setiap respons sukses membawa jumlah yang ditagih di usage.cost, dalam USD.
Terakhir diperbarui
Setup Anda
Mengisi YOUR_API_KEY di kode halaman ini. Key hanya ada di tab ini: tidak dikirim dan tidak disimpan.
Tempat biaya tampil
Cent AI menambah satu field di objek usage standar: cost, jumlah yang ditagih untuk request itu dalam USD, berupa string desimal dengan 9 digit pecahan (contoh "0.000363000"). Nilainya sama dengan tagihan yang tercatat di riwayat saldo Anda, setelah minimum dan pembulatan.
| Endpoint | Tanpa streaming | Dengan streaming |
|---|---|---|
POST /v1/chat/completions | usage.cost di body | usage.cost di chunk usage terakhir (choices: []), hanya dikirim bila Anda mengisi stream_options.include_usage: true |
POST /v1/messages | usage.cost di body | usage.cost di event message_delta terakhir |
POST /v1/responses | usage.cost di objek response | usage.cost di objek response pada response.completed |
Tidak ada header biaya.
Streaming dengan client OpenAI
Minta usage di stream agar biaya ikut terkirim:
curl https://api.cent-ai.dev/v1/chat/completions \
-H "Authorization: Bearer $CENT_AI_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"glm-5.3","messages":[{"role":"user","content":"Halo"}],
"stream":true,"stream_options":{"include_usage":true}}'
Chunk data terakhir sebelum data: [DONE] lalu membawa usage:
data: {"id":"chatcmpl-9f2c1a","object":"chat.completion.chunk","created":1792051200,"model":"glm-5.3","choices":[],"usage":{"prompt_tokens":10000,"prompt_tokens_details":{"cached_tokens":9000},"completion_tokens":800,"total_tokens":10800,"cost":"0.000363000"}}
Membacanya dari SDK
SDK menyimpan field yang tidak dikenalnya. Dengan SDK OpenAI Python:
from openai import OpenAI
client = OpenAI(base_url="https://api.cent-ai.dev/v1", api_key="YOUR_API_KEY")
r = client.chat.completions.create(model="glm-5.3", messages=[{"role": "user", "content": "Halo"}])
print(r.usage.cost)
Usage perkiraan
Bila model tidak melaporkan usage, Cent AI menghitung token dengan tokenizer dan menandai respons dengan usage.estimated: true. Usage perkiraan tidak pernah memuat token cache. Request itu juga ditandai estimated di halaman Requests.
Bila respons tidak memuat biaya
Bila stream putus sebelum usage tiba, client Anda tidak menerima cost. Tagihannya tetap tercatat dan tampil di halaman Requests, dicocokkan lewat header x-request-id.