概覽
這個 endpoint 會回傳單一 API Key 維度的用量明細,同時不暴露實體 routing 中繼資料。Query 參數
| 參數 | 型別 | 預設值 / 限制 | 說明 |
|---|---|---|---|
page | integer | 預設 1,最小 1 | 從 1 開始的頁碼 |
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。
說明
- 回應支援分頁。
- 回應只包含公開 billing 與 reporting 欄位。
- 內部 routing 與實體渠道中繼資料會持續被隱藏。
- 所有金額欄位都保留 USD 原值,並額外返回人民幣展示欄位,例如
cost_cny、total_cost_cny,以及各類 breakdown 內的cost_cny。 api_key.exchange_rate表示本次回應中所有*_cny欄位使用的 USD→CNY 匯率。