Skip to main content
GET
查询用量聚合
本接口要求 Admin Key 具备 billing:read 作用域。时间窗口上限按粒度分档:1m 最长 24 小时、1h 最长 31 天、1d 最长 93 天。uid[] 是过滤维度(只返回这些用户名下 key 的行),聚合行按时间桶 × 模型 × 项目 × key 分组。

粒度、对齐与空桶

数据留存以平台数据保留策略为准(不承诺固定天数);聚合行按时间桶 × 模型 × 项目 × key 分组。

授权

Authorization
string
header
必填

Authorization 请求头携带 Admin API secret 作为 Bearer 令牌,格式为 Bearer sk-admin-***。Admin Key 可在「控制台 → 组织管理 → Admin API Keys」创建。

路径参数

usage_type
enum<string>
必填

用量类型。当前仅支持 completions。

可用选项:
completions

查询参数

start
integer<int64>
必填

起始时间(epoch 毫秒),含边界。例如 1790784000000(2026-10-01 00:00 CST)。

必填范围: x >= 0
end
integer<int64>
必填

结束时间(epoch 毫秒),不含边界。例如 1792598400000(2026-10-22 00:00 CST)。

必填范围: x >= 0
project_id
string[]

项目 ID 列表。每个项目都必须属于当前认证组织。

key
string[]

推理 API 密钥 ID 列表。每个 key 都必须属于当前认证组织。

uid
string[]

用户 ID 过滤。返回结果限制为组织内这些用户的行。

granularity
enum<string>
默认值:1d

时间桶粒度。不同粒度的时间窗口上限不同:1m 最长 24 小时, 1h 最长 31 天,1d 最长 93 天。1d 按 Asia/Shanghai 自然日切分。

可用选项:
1m,
1h,
1d
limit
integer
默认值:100

页大小。默认 100,最大 1000。

必填范围: 1 <= x <= 1000
cursor
string

上一次响应 next 字段返回的游标。游标只携带页位置;每次翻页都需原样重复全部查询参数(limit 除外),服务端不校验参数一致性。

响应

用量聚合行,按时间桶时间升序。

data
object[]
必填

用量聚合行(时间桶 × 模型 × 项目 × 推理 API 密钥)。

has_more
boolean
必填

是否还有下一页。

next
string | null
必填

下一页游标。翻页时将其原样作为 cursor 参数传回。