文件用量紀錄
計費

GET /v1/usage/logs

取得逐筆用量歷史,適合做帳務表格與明細頁。

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

適合情境

要做詳細帳務表格與歷史頁的團隊。

請求歷史
帳務明細
逐筆模型追蹤

怎麼呼叫

json

{
  "model": "grok-video",
  "prompt": "一隻金毛犬在明亮攝影棚中向鏡頭跑來",
  "duration": 10,
  "resolution": "720p",
  "aspectRatio": "16:9"
}

這支 API 是做什麼的

這支 API 適合做逐筆歷史表格。

當客戶想追溯每一次花費時,應用這支 API。

參數說明

page / limit

若後端支援,可用於分頁。

date range

若後端支援,可指定歷史區間。

model

若後端支援,可篩選特定模型。

Response 欄位

logs

用量紀錄陣列。

model

這筆請求所使用的模型。

pointsCharged

這筆請求實際扣除的點數。

usage

若相關,則包含 token 或其他用量資訊。

createdAt

請求建立時間。

前端怎麼用

  • 適合做詳細表格,不適合做 summary 卡片。
  • 至少清楚顯示模型、時間與扣點。
  • 篩選要簡潔,讓客戶能追溯花費。

想直接開始測試?

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

打開 API 金鑰