Billing units
Usage is metered and settled in structured units; amounts are shown as USD decimals.
Usage units (usage_type)
| usage_type | Description |
|---|---|
input_tokens |
Input tokens |
cached_input_tokens |
Cached input tokens |
cache_write_tokens |
Cache-write tokens |
output_tokens |
Output tokens |
reasoning_tokens |
Reasoning tokens |
image_units |
Image units |
audio_units |
Audio units |
video_units |
Video units |
Billing model
- Each request is billed as actual usage × unit price, summed across units.
- Amounts are stored as high-precision integers internally and converted to USD decimals for display, avoiding floating-point drift.
Invoices
- Every call's token breakdown, amount, and
request_idare visible in the console Usage page. - Top-ups, charges, and refunds each produce a ledger entry; your balance is updated in real time.