Skip to main content

Overview

This endpoint returns consumption-only billing aggregates for the selected API key, including total cost, total requests, usage by billing unit, the by_model, by_logical_model, by_model_vendor, and by_scene breakdowns, plus a daily cost trend.

Notes

  • Monetary fields are USD-only. CNY inputs are retired and return 400 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.