文件用量紀錄
計費
GET /v1/usage/logs
取得逐筆用量歷史，適合做帳務表格與明細頁。
GET /v1/usage/logs權限: 依後端實際 API key scope 設定而定
適合情境
要做詳細帳務表格與歷史頁的團隊。
請求歷史
帳務明細
逐筆模型追蹤
怎麼呼叫
bash
curl --request GET \
--url "https://api.midsync.dev/v1/usage/logs?page=1&limit=20" \
--header "Authorization: Bearer <midsync_api_key>"這支 API 是做什麼的
這支 API 適合做逐筆歷史表格。
當客戶想追溯每一次花費時，應用這支 API。
Common query params
page
選填。第幾頁。
limit
選填。每頁筆數。
model
選填。依模型 id 過濾。
from
選填。ISO 字串格式的起始時間。
to
選填。ISO 字串格式的結束時間。
Response 欄位
logs
用量紀錄陣列。
model
這筆請求所使用的模型。
pointsCharged
這筆請求實際扣除的點數。
usage
若相關，則包含 token 或其他用量資訊。
createdAt
請求建立時間。
Logs response shape
Logs response shape
json
{
"logs": [
{
"id": "log_123",
"model": "gpt-5-4",
"mode": "responses",
"pointsCharged": 0.21,
"creditsConsumed": 0.41,
"usage": {
"inputTokens": 2541,
"outputTokens": 44,
"reasoningTokens": 0,
"totalTokens": 2585
},
"createdAt": "2026-04-12T10:30:00.000Z"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 100
}
}前端怎麼用
- 適合做詳細表格，不適合做 summary 卡片。
- 至少清楚顯示模型、時間與扣點。
- 篩選要簡潔，讓客戶能追溯花費。
想直接開始測試？
先到 Settings 建立 general API key，再回到這裡直接複製請求範例。