按模型汇总用量

同一个时间窗口,按模型而不是按时间聚合。回答的是「钱花在哪个模型上了」。窗口参数与对齐规则同 `/v1/open/usage`。响应里没有分桶,但 `bucket` 仍然有意义 ——它决定窗口按小时还是按天对齐,因而会影响实际统计的区间。查几小时的数据时传 `hour`,否则窗口会被拉宽到整天。

同一个时间窗口,按模型而不是按时间聚合。回答的是「钱花在哪个模型上了」。

窗口参数与对齐规则同 /v1/open/usage。响应里没有分桶,但 bucket 仍然有意义 ——它决定窗口按小时还是按天对齐,因而会影响实际统计的区间。查几小时的数据时传 hour,否则窗口会被拉宽到整天。

Authorization

AuthorizationBearer <token>

Authorization: Bearer sk-juc-...

前缀必须是恰好 Bearer (首字母大写 + 单个空格)。bearer、BEARER 或用制表符分隔都会被判为无效。

除 API Key 外,也接受 OAuth 设备访问令牌(仅限 oauth_access 类型的 JWT; 普通网页会话令牌会被拒绝)。

In: header

Query Parameters

start?string

窗口起点。接受 RFC 3339 时间串或裸的 Unix 秒数。省略时为 end 前 7 天。

无法解析的值会回落到默认窗口而不是报错——这是只读统计接口,把日期敲错的调用方拿到「这是最近一周」比拿到一个还得去翻文档的 400 更有用。

end?string

窗口终点(不含)。接受 RFC 3339 或 Unix 秒数,省略时为当前时间。

bucket?string

分桶粒度。非法值回落到 day。

Default"day"

Value in

"hour"
"day"

Response Body

`application/json`

curl -X GET "https://example.com/v1/open/usage/models"

{  "start": "2026-08-07T00:00:00Z",  "end": "2026-08-14T00:00:00Z",  "currency": "CNY",  "models": [    {      "key": "gpt-5.4",      "requests": 300,      "errors": 2,      "tokens_in": 1100000,      "tokens_out": 80000,      "cost_final_sum": "5.10000000"    },    {      "key": "claude-sonnet-5",      "requests": 112,      "errors": 1,      "tokens_in": 188340,      "tokens_out": 16210,      "cost_final_sum": "1.11430000"    }  ]}

Authorization

Query Parameters

Response Body

200application/json

401application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`