每日用量统计

接口信息

方法: POST
路径: /v1/web/statistics/daily_usage
鉴权方式: Bearer Token（API 密钥）

请求 Headers

Header	必填	说明
`Authorization`	是	`Bearer <your_secret_key>`
`Content-Type`	是	`application/json`

请求体（JSON）

参数	类型	必填	说明
`start_date`	string	是	统计开始日期（含），格式 `YYYY-MM-DD`
`end_date`	string	是	统计结束日期（含），格式 `YYYY-MM-DD`
`timezone`	string	否	时区名称，默认 `Asia/Shanghai`，支持所有 IANA 时区
`page`	int	否	页码，传 -1 返回全部数据
`page_size`	int	否	每页行数
`order_by`	str	否	排序字段：`day_str` / `total_quota`
`sort`	int	否	排序方向：1 升序 / -1 降序

约束：

end_date 必须大于等于 start_date
日期范围最多 7 天（含首尾两端）

请求示例

bash

curl --request POST \
  --url https://yyken.com/v1/web/statistics/daily_usage \
  --header 'Authorization: Bearer {您的API密钥}' \
  --header 'Content-Type: application/json' \
  --data '{
    "start_date": "2026-03-03",
    "end_date": "2026-03-03",
    "timezone": "Asia/Shanghai"
  }'

返回结构

json

{
  "status": 0,
  "info": "ok",
  "data": {
    "model_names": ["string"],
    "total": 0,
    "rows": [
      {
        "day_str": "YYYY-MM-DD",
        "department": "string",
        "token_name": "string",
        "models": {
          "<model_name>": 0
        },
        "total_quota": 0
      }
    ]
  }
}

字段说明

顶层 data

字段	类型	说明
`model_names`	string[]	本次查询范围内出现的所有模型名列表
`total`	int	返回行数
`rows`	object[]	聚合数据行，见下表

rows 每行字段

字段	类型	说明
`day_str`	string	日期，格式 `YYYY-MM-DD`，按请求 `timezone` 换算
`department`	string	令牌名称中 `-` 前的部分，用于部门分组；若无 `-` 则与 `token_name` 相同
`token_name`	string	令牌名称
`models`	object	各模型用量（quota），key 为模型名，value 为整型用量值
`total_quota`	int	该行所有模型的用量之和

models 的 key 集合与顶层 model_names 保持一致，未产生用量的模型值为 0。

返回示例

json

{
  "status": 0,
  "info": "ok",
  "data": {
    "model_names": ["claude-haiku-4-5-20251001", "claude-sonnet-4-6", "gpt-4o"],
    "total": 2,
    "rows": [
      {
        "day_str": "2026-03-01",
        "department": "研发部",
        "token_name": "研发部-张三",
        "models": {
          "claude-haiku-4-5-20251001": 120000,
          "claude-sonnet-4-6": 450000,
          "gpt-4o": 0
        },
        "total_quota": 570000
      },
      {
        "day_str": "2026-03-01",
        "department": "产品部",
        "token_name": "产品部-李四",
        "models": {
          "claude-haiku-4-5-20251001": 0,
          "claude-sonnet-4-6": 210000,
          "gpt-4o": 88000
        },
        "total_quota": 298000
      }
    ]
  }
}

错误码

status	HTTP 状态码	说明
`0`	`200`	成功
`100`	`200`	参数错误，详见 `data.err_msg`
`101`	`401`	鉴权失败（密钥无效或已过期）
`106`	`200`	数据库错误

常见参数错误（status: 100）

`data.err_msg`	原因
`日期格式错误，应为 YYYY-MM-DD`	日期格式不正确
`结束日期必须大于等于开始日期`	`end_date` 早于 `start_date`
`查询范围不能超过 7 天`	日期跨度超出限制
`无效的时区: xxx`	`timezone` 不在 IANA 时区列表
`用户缺少平台配置`	账户未完成平台配置，请联系管理员