跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.lemondata.cc/llms.txt

Use this file to discover all available pages before exploring further.

​
概覽

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

​
Query 參數

參數型別預設值 / 限制說明
pageinteger預設 1，最小 1從 1 開始的頁碼
limitinteger預設 50，最小 1，最大 100每頁筆數
logicalModelstring最大長度 100請求時使用的邏輯模型名稱
modelVendorstring最大長度 100公開模型供應商
sceneenum-chat、image、audio、video、embedding、rerank、translation、music、3d
accessChannelenum-platform 或 byok
startDatestring-起始時間（含），接受帶時區的 RFC3339 或 YYYY-MM-DD
endDatestring-結束時間（含），接受帶時區的 RFC3339 或 YYYY-MM-DD
如果同時提供 startDate 與 endDate，則 startDate 必須早於或等於 endDate。

​
說明

  • 回應支援分頁。
  • 回應只包含公開 billing 與 reporting 欄位。
  • 當底層請求已完成結算時，每條用量明細還會包含 billing_transaction_id。建議將它與 request_id 一起用於請求級對帳。
  • 內部 routing 與實體渠道中繼資料會持續被隱藏。

​
範例

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 面板。