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
| Resource | Rate | Unit |
|---|---|---|
| Input tokens | 2 | pro credits / 1K tokens |
| Output tokens | 8 | pro credits / 1K tokens |
| RAG retrieval | 0 | included in v1 |
| Office file gen | 0 | included in v1 |
Contoh
Proposal 12 halaman (~9K input token) + output ~3K token: 18 + 24 = ~42 pro credits. Estimate ditampilkan sebagai quoted_credits. Actual charged_credits dihitung setelah LLM call selesai.
Untuk reservasi awal, output diestimasi 10.000 token (atau max_output_tokens workflow bila lebih kecil). Model berpikir sebelum menjawab dan token berpikir dihitung sebagai output, jadi run yang berat bisa melebihi estimasi; selisihnya ditagih (atau dikembalikan bila lebih kecil) setelah run selesai.
Balance Check
GET /v1/usage/balance
→ {"pro_credits":1840,"bonus_pro":200,"regular_pro":1640,"basic_credits_excluded":true}