概覽
這個 endpoint 會回傳單一 API Key 維度的用量明細，同時不暴露實體 routing 中繼資料。查詢參數
如果同時提供
startDate 與 endDate，則 startDate 必須早於或等於 endDate。
說明
-
金額欄位僅支援 USD。
CNY輸入已停用，並會回傳400 currency_retired。 - 回應支援分頁。
- 回應只包含公開 billing 與 reporting 欄位。
-
當底層請求已完成結算時，每條用量明細還會包含
billing_transaction_id。建議將它與request_id一起用於請求級對帳。 - 內部 routing 與實體渠道中繼資料會持續被隱藏。
範例
請求 / 回應
精確 schema 與回應欄位，請使用上方的互動式 OpenAPI 面板。回應範例
重要欄位
object
API Key 摘要，欄位與列出、建立和更新回應相同。
array
分頁後的用量明細。
object
分頁中繼資料，包含
page、limit、total 和 totalPages。object
依所選篩選條件彙總的總計。
object
依所選篩選條件彙總的明細拆分。
string | null
用於技術支援和對帳的公開請求識別碼。
string | null
完成結算後可用的帳單交易 ID。
string
請求時使用的公開模型名稱。
string
用於報表的邏輯公開模型。
string | null
公開模型廠商。
string | null
公開請求場景。
string
帳單計量單位，例如
per_token。number
以 JSON 數字回傳的用量，供顯示使用。
string
以十進位字串回傳的精確用量。
number
提示 token 數。
number
完成 token 數。
number
token 總數。
number
快取讀取 token 數。
number
快取寫入 token 總數。
number
5 分鐘快取寫入 token 數。
number
1 小時快取寫入 token 數。
number
以 JSON 數字回傳的 USD 費用，供顯示使用。
string
以十進位字串回傳的 USD 精確費用。
string
用量明細的 ISO 時間戳記。
number
請求總數。
number
以 JSON 數字回傳的 USD 總費用，供顯示使用。
string
以十進位字串回傳的 USD 精確總費用。
number
提示 token 總數。
number
完成 token 總數。
number
token 總數。
array
依計量單位分組的用量。
array
依請求時使用的公開模型拆分。
array
依邏輯公開模型拆分。
array
依公開模型廠商拆分。
array
依公開請求場景拆分。
array
每日費用趨勢。