Overview
This endpoint returns consumption-only billing aggregates for the selected API key, including total cost, total requests, usage by billing unit, theby_model, by_logical_model, by_model_vendor, and by_scene breakdowns, plus a daily cost trend.
Notes
-
Monetary fields are USD-only.
CNYinputs are retired and return400 currency_retired. - Recharge, invoices, and other organization-level financial records are intentionally excluded.
Example
Request / Response
Use the interactive OpenAPI panel above for the exact schema.Response example
Important fields
object
API key summary using the same fields as list/create/update responses.
object
Aggregated totals for the selected filters.
object
Aggregated breakdowns for the selected filters.
number
Total request count.
number
Total cost in USD as a JSON number for display.
string
Exact total cost in USD as a decimal string.
number
Total prompt tokens.
number
Total completion tokens.
number
Total tokens.
array
Usage quantity grouped by usage unit.
array
Breakdown by requested public model.
array
Breakdown by logical public model.
array
Breakdown by public model vendor.
array
Breakdown by public request scene.
array
Daily cost trend.