获取组织用量

GET/enterprise/v1/usage

使用组织所有者签发的 MANAGEMENT 类型 Admin API Key,携带 Authorization: Bearer <ADMIN_API_KEY> 和 tenant:billing:read scope。组织所有者必须仍为有效企业管理员;不使用推理 Key 或登录 JWT。成功返回 {code:200,data:...}。

查询参数使用 camelCase。startTime、endTime 是 UTC Unix 秒,不是毫秒;满足 0 <= startTime < endTime <= now,跨度最多 31 天,边界均须对齐 UTC 整点。默认结束时间为最近一个已完成小时的边界,开始时间为此前 30 天。

group仅用量接口:HOUR、DAY(默认)、MODEL
page1–1000,默认 1
limit1–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。数据来自小时用量汇总,不是正式发票,近期计费可能延迟。不接受租户选择参数。

请求

Shell
1curl "https://api.token360.ai/enterprise/v1/usage" \
2  -H "Authorization: Bearer $ADMIN_API_KEY"

错误通过 serviceCode 标识:权限不足 API_KEY_SCOPE_DENIED;非法查询 INVALID_ADMIN_QUERY;非法时间范围 INVALID_TIME_RANGE。不要自动扩展密钥权限。

HOUR / DAY 按时间桶、模型及模型类型分别汇总,并非每小时/每天仅一行。时间范围为左闭右开 [startTime,endTime)。

空结果示例:

JSON
1{"code":200,"data":{"items":[],"hasMore":false,"next":null},"msg":"success"}
此页面对您有帮助吗?
获取组织用量 · Token360