Skip to content

Credits and top-ups

What a credit is, what consumes credits, the burn alerts you get at 50/80/100%, and how one-time top-up packs work.

A credit is the unit of AI usage, mapped to real provider cost. Paid plans grant a monthly credit allowance; usage draws it down.

What consumes credits

  • Answering a visitor's question — including retrieval, re-ranking, and

    classification, not only the final reply.

  • Voice calls, which debit a per-minute rate on top of the per-turn cost,

    billed in six-second increments when the call ends. See Voice.

  • Actions the agent runs.
  • Copilot drafts and summaries.
  • Topic clustering and

    eval runs.

  • Embedding your knowledge sources when they are processed.

Human replies in the inbox cost nothing.

The ledger

The billing page shows your balance, live usage bars, and a recent ledger of grants and debits. Credit figures on Analytics count a wider population than the billing ledger — see Analytics overview for why the two differ.

Burn alerts

The workspace owner is emailed at 50%, 80%, and 100% of the cycle's credit allowance — once per threshold per cycle. Adding a top-up re-arms the ladder, so you are warned again on the new balance rather than going quiet.

Top-up packs

One-time credit packs are bought self-serve from the billing page. Two properties matter:

  • They never expire.
  • They need no plan change — a busy month does not have to become a bigger

    subscription.

Running out

Exhaustion is handled gracefully rather than as an error:

  • Visitors get a friendly "assistant is unavailable" reply, not a billing

    message.

  • The voice agent says the equivalent.
  • The owner sees a clear "you're out — top up or upgrade" banner.
  • Human handoff keeps working, so your team can still answer.

Programmatically, a request refused for exhausted budget is USAGE_LIMIT_REACHED with HTTP 402.

Where to go next

Last updated