ドキュメントUsage Summary
Billing
GET /v1/usage/summary
Fetch aggregated usage totals for summary cards and dashboard views.
GET /v1/usage/summary権限: api.read
向いている用途
Teams building billing dashboards and high-level account summaries.
Summary cards
Total spend
Top models
呼び出し例
json
{
"model": "hailuo-2.3-pro",
"prompt": "讓商品照慢慢旋轉，背景保持乾淨",
"images": [
"https://example.com/product.png"
],
"duration": 6,
"resolution": "1080P"
}What this API is for
Use this endpoint for overview cards.
It complements usage logs by giving totals instead of per-request rows.
Parameters
date range
Optional date window for summary aggregation if supported.
groupBy
Optional grouping such as by model when supported.
Response fields
totalPointsCharged
Total charged points for the selected period.
totalRequests
Total requests in the selected period.
totalInputTokens / totalOutputTokens
Aggregated token totals when relevant.
byModel
Per-model summary breakdown.
Frontend notes
- Use this endpoint for dashboard cards.
- Show total points, total requests, and top models first.
- Pair it with usage logs for detailed drill-down.
すぐに試したいですか？
Settings で general API key を作成してから、ここに戻ってリクエスト例をコピーしてください。