文件用量摘要
計費

GET /v1/usage/summary

取得彙總用量數據,適合做儀表板與帳務摘要卡片。

GET /v1/usage/summary權限: api.read

適合情境

要做帳務首頁與高層摘要卡片的團隊。

摘要卡片
總花費
常用模型

這支 API 是做什麼的

這支 API 適合做高層摘要卡片。

它與 usage logs 互補:一個看總覽,一個看明細。

參數說明

date range

若後端支援,可指定摘要期間。

groupBy

若後端支援,可依模型等維度彙總。

Response 欄位

totalPointsCharged

指定期間內總扣點。

totalRequests

指定期間內總請求數。

totalInputTokens / totalOutputTokens

若相關,則為彙總 token 統計。

byModel

各模型的摘要數據。

前端怎麼用

  • 適合做 dashboard 卡片。
  • 優先顯示總點數、總請求與最常用模型。
  • 若要看細節,再搭配 usage logs。

想直接開始測試?

先到 Settings 建立 general API key,再回到這裡直接複製請求範例。

打開 API 金鑰