Usage
Explain consumed work and account spending with the right units, periods, and execution evidence.
Usage connects spending to the work behind it. Account history answers what the organization consumed during a period. Model and token records explain generation. Individual runs show which operations completed, retried, or retained earlier output. Those records are related, but they are not interchangeable totals.
Start with the accounting question #
Choose the organization and period to reconcile, then inspect its spending history. Use model-cost and token series for the work behind that history, and run evidence or costs for particular executions. Keep filters, date range, and timezone consistent when comparing totals.
More target locales, new output, retries, or changed reuse can increase model tokens. That increase does not by itself establish the complete invoice change. Match the observed work with its charge categories before attributing a difference to one model.
Observed cost and output tokens can support estimates for comparable future work. They do not supply a provider price list, an invoice, or a guaranteed rate. Billing covers balances, purchases, payments, and plan state.
Preserve the units #
| Quantity | What it describes |
|---|---|
| Input and output tokens | Model work, under the reported provider definitions. |
| Cache-read and cache-write tokens | Provider cache activity that can overlap total input. |
| Credits and currency | Accounting under the current commercial contract. |
| Requests, words, or repository lines | Different measures of workload, with different populations. |
Do not add cache counters to total input as though all were disjoint, or label all input fresh-only. Prompt caching explains how to interpret those overlapping quantities.
Provider cost, localization charges, professional review, independent measurements, and the platform plan are separate components. A deterministic check can use no model tokens while still creating metered measurement usage. Reused translation can avoid generation without making every surrounding operation free.
When comparing costs, keep content, language coverage, review coverage, and acceptance requirements comparable. Include the effort needed to inspect and handle output rather than presenting token differences as a fixed total saving.
Use reports for the question they answer #
Workload reports describe generated volume and its distribution across languages and sources. Repository-change evidence depends on its integration and does not represent every content system.
Quality reports need the criterion and denominator beside the result. An inapplicable record supplies no answer to that criterion. An indeterminate answer completed evaluation without establishing preserved or changed quality; a record without completed evaluation is different again. Report determinate coverage alongside pass rates and completion.
For terms and rules, distinguish candidates or samples from actual use and adherence. Evaluation outcomes explains the relevant counts.
Investigate blocked or partial work before repeating it #
Read the actual error before retrying or buying credits. Validation, authentication, authorization, missing resources, credit limits, and quota limits have different causes. In the applicable API, common codes are 400, 401, 403, 404, 402, and 429 respectively, but the operation's declared error and message determine the repair. A disabled localization engine, required ID, missing model configuration, and upstream provider limit also need distinct handling.
Retry safety depends on the operation and its idempotency. A generic server error does not prove the first request did nothing. Use bounded backoff only after establishing that the operation is retryable and what earlier work was accepted.
For translation jobs, creation saves a pending job. Work begins after a successful start request; that response still does not establish translation completion. Inspect target outcomes, warnings, and retained text, then reconcile what executed and what was charged before replacing partial work.