概览
该接口返回单个 API Key 维度的分页用量明细，不暴露提供商执行细节。查询参数
如果同时提供
startDate 和 endDate，则 startDate 必须早于或等于 endDate。
说明
-
金额字段仅支持 USD。
CNY输入已停用，并会返回400 currency_retired。 - 响应是分页的。
- 响应只包含公开账单和报表字段。
-
当底层请求已完成结算时，每条用量明细还会包含
billing_transaction_id。建议将它与request_id一起用于请求级对账。 - 供应商执行细节会被隐藏。
示例
请求 / 响应
精确 schema 和响应字段请使用上方的交互式 OpenAPI 面板。响应示例
重要字段
object
API Key 摘要，字段与列出、创建和更新响应相同。
array
分页后的用量明细。
object
分页元数据，包含
page、limit、total 和 totalPages。object
按所选筛选条件汇总的总计。
object
按所选筛选条件汇总的明细拆分。
string | null
用于技术支持和对账的公开请求标识符。
string | null
完成结算后可用的账单交易 ID。
string
请求时使用的公开模型名称。
string
用于报表的逻辑公开模型。
string | null
公开模型厂商。
string | null
公开请求场景。
string
账单计量单位，例如
per_token。number
以 JSON 数字返回的用量，用于展示。
string
以十进制字符串返回的精确用量。
number
提示 token 数。
number
补全 token 数。
number
token 总数。
number
缓存读取 token 数。
number
缓存写入 token 总数。
number
5 分钟缓存写入 token 数。
number
1 小时缓存写入 token 数。
number
以 JSON 数字返回的 USD 费用，用于展示。
string
以十进制字符串返回的 USD 精确费用。
string
用量明细的 ISO 时间戳。
number
请求总数。
number
以 JSON 数字返回的 USD 总费用，用于展示。
string
以十进制字符串返回的 USD 精确总费用。
number
提示 token 总数。
number
补全 token 总数。
number
token 总数。
array
按计量单位分组的用量。
array
按请求时使用的公开模型拆分。
array
按逻辑公开模型拆分。
array
按公开模型厂商拆分。
array
按公开请求场景拆分。
array
每日费用趋势。