Billing & Credits

Bayar API pakai pro credits — saldo yang sama dengan kakak.ai chat & studio.

Aturan Dasar

  • Pro credits only — basic credits tidak pernah dipakai untuk API
  • Reserve sebelum work — kredit dikunci atomik (FOR UPDATE) sebelum LLM call
  • True-up setelah run — lebih bayar direfund, kurang bayar dipotong (bisa bikin balance negatif)
  • Negative balance — ditoleransi sampai −1000 pro credits, lalu hard-suspend
  • Semua tercatat di CDR — channel='api', auditable
  • Gagal = refund penuh — upstream error, validation failure
  • Cancel queued run = refund penuh — belum ada work yang dilakukan

DOC-01 Pricing

ResourceRateUnit
Input tokens2pro credits / 1K tokens
Output tokens6pro credits / 1K tokens
RAG retrieval0included in v1
Office file gen0included in v1

Contoh

Proposal 12 halaman (~9K input token) + output ~3K token: 18 + 18 = ~36 pro credits. Estimate ditampilkan sebagai quoted_credits. Actual charged_credits dihitung setelah LLM call selesai.

Balance Check

GET /v1/usage/balance
→ {"pro_credits":1840,"bonus_pro":200,"regular_pro":1640,"basic_credits_excluded":true}