跳轉到主要內容

概覽

這個 endpoint 會回傳單一 API Key 維度的用量明細,同時不暴露實體 routing 中繼資料。

Query 參數

參數型別預設值 / 限制說明
pageinteger預設 1,最小 1從 1 開始的頁碼
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

說明

  • 回應支援分頁。
  • 回應只包含公開 billing 與 reporting 欄位。
  • 內部 routing 與實體渠道中繼資料會持續被隱藏。
  • 所有金額欄位都保留 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 面板。