Menu docs

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.

EndpointTanpa streamingDengan streaming
POST /v1/chat/completionsusage.cost di bodyusage.cost di chunk usage terakhir (choices: []), hanya dikirim bila Anda mengisi stream_options.include_usage: true
POST /v1/messagesusage.cost di bodyusage.cost di event message_delta terakhir
POST /v1/responsesusage.cost di objek responseusage.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.