本頁查詢的是帳戶自己的呼叫流水。若只想查看某個 API 在整個平台上的公開呼叫統計,請使用API 呼叫統計。
資料保留範圍
呼叫紀錄及計費摘要保留最近 60 天;請求與回應本文保留最近 30 天。30–60 天的紀錄仍可查詢 trace、狀態、時間、模型、用量和實際扣費等摘要,詳情中的metadata.request、metadata.response 不再回傳。模型彙總及有效結果統計所需的摘要會在本文到期前保留。需要長期留存本文時,請在呼叫時自行儲存。
準備工作
1. 建立帳戶權杖
本介面屬於平台管理 API,需要使用 Account Token(帳戶權杖):- 登入 AceDataCloud 平台。
- 開啟 Account Token 控制台。
- 點擊「建立」,立即將權杖儲存到密碼管理器或 Secret Manager。
platform.acedata.cloud/api/v1/**;呼叫 api.acedata.cloud/** 業務介面使用的是 API 憑證(Credential),兩者不能混用。
2. 準備篩選 ID(選填)
不傳篩選條件即可查看目前帳戶有權查看的紀錄。需要縮小範圍時: 一般使用者無需傳user_id;若明確傳入,必須與目前帳戶一致,否則回傳 403。管理員可用此參數跨帳戶篩選。
介面概覽
查詢範圍
查詢參數
請求時間早於最近 60 天時,介面回傳
400 欄位驗證錯誤,提示完整呼叫明細僅保留 60 天。
請求範例
查詢最近 100 筆紀錄:回應範例
關鍵欄位
額度單位由對應 Application 的
service.unit 決定,不應預設視為美元。
錯誤與重試
同一組查詢參數最多保留一個進行中的請求。大範圍查詢優先使用一天或更小的視窗,不要以固定間隔疊加相同請求。
下一步
- 彙總呼叫量:查看按日期和 API 彙總的用量。
- 匯出呼叫量:將大量明細直接下載為 CSV。
- 查看 Proxy 呼叫記錄:查詢 Proxy 類型服務的記錄。
- 查看服務申請詳情:核對餘額和額度單位。
- 輪換 API 憑證:憑證疑似外洩時立即更換。

