Usage units

What it is

Usage units name what your product controls, such as credits, tokens, gpu_seconds, image_credits, gems, or energy.

When to use it

Create usage units before packages or grants that need something other than the default credits unit.

How to use it

How they work

A unit code identifies one controlled resource. Packages and grants use one unit at a time. Customer balances are tracked separately per unit. Expiration belongs to package grants and buckets, not to the usage unit itself. Your backend chooses the unit when it grants, checks, reserves, commits, or releases usage.