查询模型账单汇总
/enterprise/v1/billing/products使用组织所有者签发的 MANAGEMENT 类型 Admin API Key,携带 Authorization: Bearer <ADMIN_API_KEY> 和 tenant:billing:read scope。组织所有者必须仍为有效企业管理员;不使用推理 Key 或登录 JWT。成功返回 {code:200,data:...}。
固定 MODEL 分组;此处产品指模型用量,并非独立的项目/SKU 账单 API。传入的 group 会被覆盖。
查询参数使用 camelCase。startTime、endTime 是 UTC Unix 秒,不是毫秒;满足 0 <= startTime < endTime <= now,跨度最多 31 天,边界均须对齐 UTC 整点。默认结束时间为最近一个已完成小时的边界,开始时间为此前 30 天。
group | 仅用量接口:HOUR、DAY(默认)、MODEL |
page | 1–1000,默认 1 |
limit | 1–200,默认 50 |
subAccountId | 可选,成员接口返回的成员标识 |
keyDisplay | 可选,成员 Key 接口返回的标识,不是密钥明文 |
同时传两个筛选条件时,Key 必须属于该成员。data 包含 items、hasMore、next;还有下一页时,将 next 作为 page,保留相同筛选条件与明确的时间范围;hasMore=false 时停止。汇总数据更新可能改变分页结果,对账应选择已稳定的时间窗口。
每行字段:bucketStart、model、modelType、requests、inputTokens、outputTokens、cacheReadTokens、cacheCreation5mTokens、cacheCreation1hTokens、imageCount、videoSeconds、amount、walletAmount、voucherAmount。MODEL 分组的 bucketStart 为 null;金额单位 USD。数据来自小时用量汇总,不是正式发票,近期计费可能延迟。不接受租户选择参数。