文档中心/API 参考/使用量查询

使用量查询

查询账户的 API 使用量统计，支持按日期范围和服务商筛选。

GET/v1/usagebeta

请求参数

参数类型说明
start_datestring开始日期，格式 YYYY-MM-DD，默认 30 天前
end_datestring结束日期，格式 YYYY-MM-DD，默认今天
providerstring可选，按服务商筛选
granularitystring可选，granularity: day（按天）, week（按周）, month（按月）

响应示例

{
  "object": "usage",
  "period": {
    "start_date": "2026-04-01",
    "end_date": "2026-04-30"
  },
  "total_tokens": 1000000,
  "total_input_tokens": 600000,
  "total_output_tokens": 400000,
  "total_cost": "¥50.00",
  "by_provider": [
    {
      "provider": "ali",
      "provider_name": "阿里百炼",
      "tokens": 600000,
      "cost": "¥30.00"
    },
    {
      "provider": "volc",
      "provider_name": "火山引擎",
      "tokens": 400000,
      "cost": "¥20.00"
    }
  ],
  "by_model": [
    {
      "model": "qwen-plus",
      "tokens": 400000,
      "cost": "¥20.00"
    },
    {
      "model": "doubao-pro",
      "tokens": 600000,
      "cost": "¥30.00"
    }
  ]
}