Skip to content

Credits & billing

Credits are the usage currency of nara. Every billable action — an agent turn, a phone minute, a file ingestion — consumes credits from the organization balance. Admins manage credits under Account > Credits (/admin/credits).

The page header shows three figures:

  • Available credits — what can be spent right now.
  • Reserved credits — estimates held for runs that are currently in progress.
  • Total consumed — cumulative usage.

Before a billable action starts, nara reserves the estimated cost. When the action finishes, the actual cost is committed and any unused remainder of the reservation is released. Because the reservation is checked against the available balance up front, the organization can never be overdrawn. A run that would exceed the balance is rejected with an insufficient-credits error instead of starting.

ActionItem codeCredits
Agent turn (Pro model)AGENT_TURN_PRO8
Agent turn (Balanced model)AGENT_TURN_BALANCED4
Agent turn (Budget model)AGENT_TURN_BUDGET1
Function callAGENT_FUNCTION_CALL1
Phone minutePHONE_MINUTE50
File ingestionMEMORY_INGEST_FILE5
Embedding writeMEMORY_EMBEDDING_WRITE1
Ticket creationTICKET_CREATE0

One credit corresponds to roughly €0.015. The costs configured for your organization are shown in the Configured Credit Costs table on the page.

Every credit movement is recorded as a ledger entry with Created At, Type, Item Code, Sequence, Units, Unit Cost, Total Cost, and Details. Entries produced by a conversation or ticket link directly to the related Chat or Ticket, so any charge can be traced back to its source.

Entry typeMeaning
PURCHASECredits added through a purchase
INITIALStarting balance
USAGEDirect consumption
RESERVATIONEstimate held before a run starts
RESERVATION_COMMITActual cost committed after the run
RESERVATION_RELEASEUnused part of a reservation returned
REFUNDCredits returned for a charge
CORRECTIONManual adjustment (admin-only)
MONTHLY_GRANTMonthly allowance credited
MONTHLY_EXPIRATIONUnused monthly allowance expired

The Daily Credit Usage chart and the usage Distribution chart break consumption down over a selectable range of 7d, 30d, or 3m — useful for spotting cost spikes and seeing which action types dominate spend.

Purchases, corrections, and monthly allowances

Section titled “Purchases, corrections, and monthly allowances”

Purchases add PURCHASE entries to the ledger. Manual CORRECTION entries are admin-only and are used to fix billing discrepancies. If your plan includes a monthly allowance, credits are granted each month as MONTHLY_GRANT entries; any unused portion expires with a matching MONTHLY_EXPIRATION entry at the end of the period.