概览
该接口返回单个 API Key 维度的分页用量明细,不暴露物理路由元数据。Query 参数
| 参数 | 类型 | 默认值 / 限制 | 说明 |
|---|---|---|---|
page | integer | 默认 1,最小 1 | 1-based 页码 |
limit | integer | 默认 50,最小 1,最大 100 | 每页条数 |
logicalModel | string | 最大长度 100 | 请求时使用的逻辑模型名 |
modelVendor | string | 最大长度 100 | 公开模型厂商 |
scene | enum | - | chat、image、audio、video、embedding、rerank、translation、music、3d |
accessChannel | enum | - | platform 或 byok |
startDate | string | - | 起始时间,接受带时区的 RFC3339 或 YYYY-MM-DD |
endDate | string | - | 结束时间,接受带时区的 RFC3339 或 YYYY-MM-DD |
startDate 和 endDate,则 startDate 必须早于或等于 endDate。
说明
- 响应是分页的。
- 响应只包含公开账单和报表字段。
- 内部路由和物理渠道元数据会被隐藏。
- 所有金额字段都保留 USD 原值,并额外返回人民币展示字段,例如
cost_cny、total_cost_cny,以及各类 breakdown 内的cost_cny。 api_key.exchange_rate表示本次响应中所有*_cny字段使用的 USD→CNY 汇率。