Skip to main content
GET
查询产品账单
本接口要求 Admin Key 具备 billing:read 作用域。
就绪与金额口径:T 日数据于 T+1 日 07:00(UTC+8)起可查;此前返回 400 data_not_ready。金额分列为现金(recharge_fee)与代金券(voucher_fee)两部分,合计为 total_fee(实收金额)。时间窗左闭右开、按 CST 日界。

字段与对账关系

  • product:产品标识(模型/产品名,如 kimi-k2.5、moonshot-v1-8k 等);product_type:产品类型;business_type:业务类型(如 chat、batch 等)。枚举会随产品扩展,客户端请保留原始字符串、忽略未知值。
  • 与 daily_bills 的 model_details 对账:产品账单按产品聚合(不按 key 明细);日账单外层 total_fee − model_details 明细合计 = 非 token 费用(cache-call、tool_call、cache storage、BatchAPI 等),仅计入外层汇总。

授权

Authorization
string
header
必填

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

查询参数

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 都必须属于当前认证组织。

limit
integer
默认值:100

页大小。默认 100,最大 1000。总行数取决于组织内不同产品/业务类型的组合数,默认页大小通常一页即可取完全部数据。

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

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

响应

产品账单。

data
object[]
必填

产品账单行(产品 × 业务类型)。

has_more
boolean
必填

是否还有下一页。

next
string | null
必填

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