按模型统计用量

GET /api/open/v1/usage/models

请求参数

参数	位置	类型	必填	默认值	说明
start_timestamp	query	integer	否	见说明	起始时间（含），unix 秒
end_timestamp	query	integer	否	见说明	结束时间（含），unix 秒
limit	query	integer	否	10	返回的模型数量，取值 1–100，超出范围返回 400

时间范围规则：

• 两端都省略：最近 30 天。
• 只传 start_timestamp：向后 30 天，且不超过当前时间。
• 只传 end_timestamp：向前 30 天。
• 范围最长 366 天。

请求示例

curl "https://www.routeapi.ai/api/open/v1/usage/models?start_timestamp=1726400000&end_timestamp=1729000000&limit=10" \
  -H "Authorization: Bearer $ROUTEAPI_MANAGEMENT_KEY"

响应示例

{
  "success": true,
  "message": "",
  "data": {
    "items": [
      {
        "model_name": "gpt-4o",
        "prompt_tokens": 120000,
        "completion_tokens": 30000,
        "total_tokens": 150000,
        "amount": 3.20
      }
    ],
    "start_timestamp": 1726400000,
    "end_timestamp": 1729000000
  }
}

响应字段

字段	类型	说明
items[].model_name	string	模型名
items[].prompt_tokens	integer	该模型在时间范围内的输入 token 总数
items[].completion_tokens	integer	该模型在时间范围内的输出 token 总数
items[].total_tokens	integer	输入与输出 token 合计
items[].amount	number	该模型消耗的金额，站点币种，两位小数
start_timestamp	integer	实际生效的起始时间
end_timestamp	integer	实际生效的结束时间

错误

HTTP	code	场景
400	invalid_request	limit 不是 1–100 的整数、时间戳为负数，或时间范围非法
429	—	超过按用户的查询频率限制（默认 30 次/分钟），响应体可能为空

其他通用错误码见 开放平台 API 错误。

说明

• 结果按 total_tokens 倒序；用量相同时按模型名升序，顺序稳定。
• 只统计消费（计费）日志，失败请求不计入。
• token 数为原始计数，不是百万单位。
• 金额使用站点展示币种，见 查询余额。
• 每行 amount 独立四舍五入，各行相加与总量可能相差 ±0.01。
• 本接口与 用量统计、账户日志、导出日志、按 Key 统计 共享按用户的查询频率限制（默认 30 次/分钟），见 频率限制。