跳转到主要内容

概览

该接口返回单个 API Key 维度的分页用量明细,不暴露物理路由元数据。

Query 参数

参数类型默认值 / 限制说明
pageinteger默认 1,最小 11-based 页码
limitinteger默认 50,最小 1,最大 100每页条数
logicalModelstring最大长度 100请求时使用的逻辑模型名
modelVendorstring最大长度 100公开模型厂商
sceneenum-chatimageaudiovideoembeddingreranktranslationmusic3d
accessChannelenum-platformbyok
startDatestring-起始时间,接受带时区的 RFC3339 或 YYYY-MM-DD
endDatestring-结束时间,接受带时区的 RFC3339 或 YYYY-MM-DD
如果同时提供 startDateendDate,则 startDate 必须早于或等于 endDate

说明

  • 响应是分页的。
  • 响应只包含公开账单和报表字段。
  • 内部路由和物理渠道元数据会被隐藏。
  • 所有金额字段都保留 USD 原值,并额外返回人民币展示字段,例如 cost_cnytotal_cost_cny,以及各类 breakdown 内的 cost_cny
  • api_key.exchange_rate 表示本次响应中所有 *_cny 字段使用的 USD→CNY 汇率。

示例

curl "https://api.lemondata.cc/v1/management/api-keys/key_abc123def456/usage?page=1&limit=20&scene=video&accessChannel=platform&startDate=2026-03-01&endDate=2026-03-31" \
  -H "Authorization: Bearer mt-your-management-token"

请求 / 响应

精确 schema 和响应字段请使用上方的交互式 OpenAPI 面板。