文件用量摘要
計費
GET /v1/usage/summary
取得彙總用量數據，適合做儀表板與帳務摘要卡片。
GET /v1/usage/summary權限: 依後端實際 API key scope 設定而定
適合情境
要做帳務首頁與高層摘要卡片的團隊。
摘要卡片
總花費
常用模型
怎麼呼叫
bash
curl --request GET \
--url "https://api.midsync.dev/v1/usage/summary" \
--header "Authorization: Bearer <midsync_api_key>"這支 API 是做什麼的
這支 API 適合做高層摘要卡片。
它與 usage logs 互補：一個看總覽，一個看明細。
參數說明
date range
若後端支援，可指定摘要期間。
groupBy
若後端支援，可依模型等維度彙總。
Response 欄位
totalPointsCharged
指定期間內總扣點。
totalRequests
指定期間內總請求數。
totalInputTokens / totalOutputTokens
若相關，則為彙總 token 統計。
byModel
各模型的摘要數據。
Summary response shape
Summary response shape
json
{
"totalPointsCharged": 1234.56,
"totalRequests": 321,
"totalInputTokens": 120000,
"totalOutputTokens": 45000,
"byModel": [
{
"model": "gpt-5-4",
"requests": 120,
"pointsCharged": 530.12
}
]
}前端怎麼用
- 適合做 dashboard 卡片。
- 優先顯示總點數、總請求與最常用模型。
- 若要看細節，再搭配 usage logs。
想直接開始測試？
先到 Settings 建立 general API key，再回到這裡直接複製請求範例。