2026-01-13

Understanding credits

Credits are the unit tasks are billed against. Every change to a balance is recorded as its own ledger entry instead of overwriting a single number, so the balance is always a sum you can audit, not a value you have to trust.

How a task spends credits

  • A task reserves credits when it is created.
  • A completed task keeps the reservation; there is no extra debit on success.
  • A failed, cancelled, or timed-out task releases the reservation back to the balance.

How credits arrive

Credits are granted by a completed purchase, a subscription renewal, or a manual grant from an operator. Each grant links back to the purchase event that caused it, so support can trace any balance back to its source.

credit_ledger: user_id, amount_delta, event_type, source, idempotency_key

Checking your balance

Sign in to the console to see your current balance and recent task activity, or read it back through the CLI with an API key.