Billing & usage

1 credit = $1 of usage. A plan (Pro / Team / Max / Ultra) includes monthly AI credits and storage; $25 top-ups add to it. Input / cached-input / output tokens are rated to micro-USD per provider receipt and debited in the same durable write. There is no automatic top-up.

Read the balance (a PAT works too)

GET https://api.kotoba.cloud/v1/billing/status
Authorization: Bearer $KOTOBA_API_TOKEN

→ {"status": "connected", "plan": "pro",
   "balances": [{"scope": "ai", "grantedMicroUSD": 12000000, "spentMicroUSD": 243,
                  "reservedMicroUSD": 0, "availableMicroUSD": 11999757}, ...]}

Rates

per million tokens: input $0.9 · cached input $0.225 · output $4.5
storage $0.2 per GiB-month · egress $0.09 per GiB

plans (USD / month): Pro $20 = 12 credits + 20 GiB · Team $150 = 60 credits + 50 GiB · Max $100 = 60 credits + 100 GiB · Ultra $200 = 120 credits + 250 GiB
top-ups: AI Credits $25 · Storage Credits $25 (12 months)
Credits 50 / 100 / 500 / 1000 monthly tiers are listed, not yet purchasable

Buy at kotoba.cloud/billing/ (Stripe Checkout, USD, tax excluded). Allowances are granted only from the paid invoice's webhook; returning to the success URL grants nothing.