查询用量汇总
GET
/v1/billing返回指定日期范围内的账户用量与费用汇总。
适用于构建账户级用量报表。默认返回最近 30 天的按日汇总。
不传成员筛选参数时，返回当前认证账户（API Key 或 JWT 对应用户）的用量。企业主账号可额外传入 sub_account_id 或 key_display，按租户内成员或 API Key 分账查询。
认证
Authorization Bearer
在 Authorization 请求头中携带 API Key（sk-...）或用户 JWT。
查询参数
typeenum<string>用量查询类型。
groupenum<string>分组粒度。
start_daystring开始日期，格式 YYYY-MM-DD。默认 UTC 今日前 30 天。
end_daystring结束日期，格式 YYYY-MM-DD。默认 UTC 今日。
model_idinteger可选的内部模型 id 过滤条件。
pageinteger页码，从 1 开始。
page_sizeinteger每页数量，范围 1 到 200。
sub_account_idstring可选。企业主账号按子账号筛选用量。值为 10 位子账号 ID；查询主账号本人用量时使用 @main。仅 enterprise_admin 可传。
key_displaystring可选。企业主账号按 API Key 筛选用量。值为 key_prefix + key_hint（如 sk-token360-inf-****）。仅 enterprise_admin 可传。
企业分账（成员 / API Key）
- 默认：普通用户、企业子账号、企业主账号（未传筛选）均查询本人用量。
- 企业主账号：可传
sub_account_id或key_display查看租户内某一成员或某一 Key 的用量汇总，用于分账与对账。 - 互斥：
sub_account_id与key_display不能同时传入。 - 主账号占位符：企业主账号没有
sub_account_id时，筛选主账号本人请传sub_account_id=@main。 - key_display 格式：与企业管理台、审计列表一致，为
key_prefix与key_hint拼接（不含完整 secret）。
响应
codeinteger响应状态码。
dataobject[]用量汇总行。
data.periodstring分组周期标签。
data.hour_id_startstring分组开始时间戳。
data.hour_id_endstring分组结束时间戳。
data.wallet_amountnumber从钱包扣费的金额。
data.credit_amountnumber从 Credit 扣费的金额。
data.total_amountnumber总扣费金额。
data.input_tokensstring输入 token 数。
data.output_tokensstring输出 token 数。
data.request_numstring计费请求数。
data.image_countstring生成图片数。
data.video_secondsnumber生成视频秒数。
data.model_idstring | null按模型分组时的模型 id。
错误处理
- 401 / 未认证：缺少或无效的
Authorization。 - INVALID_BILLING_USAGE_PAGINATION：
page或page_size超出范围。 - NOT_ENTERPRISE_ADMIN：非企业主账号传了
sub_account_id或key_display。 - INVALID_BILLING_FILTER：同时传了
sub_account_id与key_display。 - 成员 / Key 不存在或不在租户内：
sub_account_id或key_display无法解析时返回业务错误（如成员未找到、Key 不存在）。
此页面对您有帮助吗？