Get Model Usage ​

GET https://openqiao.com/api/v1/management/statistics/model_usage

Retrieve the token consumption, request count, or cost of a specific model over a time range, returned as daily data, together with an aggregate value for the entire range. Useful for single-model bill reconciliation, daily usage trend charts, and similar scenarios.

Returns platform-wide aggregated data available from 2025-09-29 onward.

Authentication ​

Authorization Header * ​

Authorization: Bearer <OPENQIAO_MANAGEMENT_API_KEY>

• Name: Authorization
• Format: Bearer <API_KEY>
• Description: A Management API Key created in the 开桥 Console

Rate Limiting ​

Each endpoint has its own independent rate limit counter. The maximum number of requests per minute is configured at the platform level. Exceeding the limit returns a 422 error.

Parameters ​

model string * ​

The model identifier (slug) to query, 例如 anthropic/claude-opus-4.8.

• Free variants (the -free suffix) are merged into their corresponding paid model. For example, querying stepfun/step-3.7-flash also includes usage from stepfun/step-3.7-flash-free.
• If the model has no usage within the specified range, value returns 0 and series returns an empty array.

metric string * ​

Which metric to retrieve.

• tokens — total input + output token count
• requests — total request count
• cost — list-price cost in USD

starting_at string * ​

Start date (inclusive), in YYYY-MM-DD format.

• No earlier than 2025-09-29 (platform data floor)

ending_at string * ​

End date (inclusive), in YYYY-MM-DD format.

• No later than today

Constraints ​

• Both starting_at and ending_at are required. Omitting either returns 400.
• Data is aggregated and returned per day, and a single request must not span more than 30 days. Exceeding returns 400.
• starting_at must not be later than ending_at; otherwise returns 400.
• starting_at must not be earlier than 2025-09-29, and ending_at must not be later than today; otherwise returns 400.

Returns ​

data.model string ​

Echo of the requested model identifier (the original model parameter value).

data.label string ​

Model display name (例如 Claude Opus 4.8). Falls back to the slug itself if the slug is not found in the model catalog.

data.metric string ​

Echo of the requested metric ("tokens", "requests", or "cost").

data.starting_at string ​

Echo of the start date (YYYY-MM-DD).

data.ending_at string ​

Echo of the end date (YYYY-MM-DD).

data.value number ​

The aggregate metric value for the model across the entire range (equal to the sum of each day's value in series):

• For metric=tokens, the total token count (integer).
• For metric=requests, the total request count (integer).
• For metric=cost, the USD cost.

data.series array ​

Array broken down by day (sorted in ascending date order). Each element contains:

• date string — date, in YYYY-MM-DD format
• value number — token count, request count, or USD cost for that day. Days with no data do not appear in the series.

curl -G https://openqiao.com/api/v1/management/statistics/model_usage \
  -H "Authorization: Bearer $OPENQIAO_MANAGEMENT_API_KEY" \
  -d model=anthropic/claude-opus-4.8 \
  -d metric=tokens \
  -d starting_at=2026-06-13 \
  -d ending_at=2026-06-16

{
  "success": true,
  "data": {
    "model": "anthropic/claude-opus-4.8",
    "label": "Claude Opus 4.8",
    "metric": "tokens",
    "starting_at": "2026-06-13",
    "ending_at": "2026-06-16",
    "value": 39861207125,
    "series": [
      {
        "date": "2026-06-13",
        "value": 7761156540
      },
      {
        "date": "2026-06-14",
        "value": 6342332731
      },
      {
        "date": "2026-06-15",
        "value": 13925770233
      },
      {
        "date": "2026-06-16",
        "value": 11831947621
      }
    ]
  }
}