Usage & Cost - WhizAI Documentation

The ACU Model

WhizAI measures all AI compute in AI Compute Units (ACU) — a stable, provider-agnostic unit that absorbs upstream cost volatility while giving you predictable pricing.

What is 1 ACU?

1 ACU = $0.01 USD. ACU costs are derived from provider pricing with a 20% platform margin, so the platform can absorb provider cost changes without passing volatility directly to you.

Typical ACU Costs

Operation	Typical ACU Cost
Text generation	~0.5 ACU
Image generation	~1.5 ACU
10-second video	~25 ACU
30-second video	~80 ACU

Tokens are one input to ACU cost for text-based operations, but ACU is the billed unit — not raw token counts.

Your ACU Balance

Each organization holds an ACU wallet with two components:

Subscription ACU

Included with your plan each month. Resets at the start of every billing period and does not carry over.

Wallet ACU (Top-ups)

Purchased separately via top-up. Wallet ACU does not expire and is consumed after subscription ACU is exhausted.

Subscription Plans

Plan	Monthly	ACU / mo	Max ACU / run
Developer	$29	100 ACU	3 ACU
Pro	$99	500 ACU	25 ACU
Business	$299	2,000 ACU	150 ACU
Enterprise	$999	10,000 ACU	500 ACU

Pre-flight Balance Enforcement

Before every capability run, the platform performs a pre-flight balance check. If the estimated ACU cost exceeds your available balance, the request is rejected before any AI compute starts — protecting you from unexpected charges.

Estimated cost is reserved before execution begins
If balance is insufficient, you receive a 402 Payment Required error
On completion, actual cost is reconciled against the reservation
If actual cost is lower than estimated, the difference is released back to your wallet

Immutable Transaction Ledger

Every ACU transaction — allocations, charges, reservations, and refunds — is written to an append-only ledger. This gives you a complete, auditable history of your spend.

Every credit and debit is a separate, immutable record
Each transaction links to the workflow run that triggered it
History is paginated and accessible via the dashboard and API
Records can never be modified or deleted

Viewing Usage

Dashboard

The Usage & Cost page in your dashboard shows:

Current ACU balance (subscription + wallet)
ACU consumed per time period
Breakdown by capability
Transaction history
Daily/weekly/monthly trends

API

Use the usage and billing APIs to programmatically access your balance and transaction history:

GET /v1/billing/balance

GET /v1/billing/history

GET /v1/usage

Balance API Response

GET /v1/billing/balance — returns your organization's current ACU wallet:

{
  "organizationId": "org_abc123",
  "balanceACU": 450.5,
  "subscriptionACU": 350.5,
  "walletACU": 100.0,
  "planName": "Pro",
  "currentPeriodEnd": "2026-07-31T23:59:59Z"
}

Monitor Your Usage

Keep track of your ACU balance and transaction history in the dashboard to optimize your spending.

Usage API Reference