日誌與非同步任務

平台將請求明細、繪圖記錄和影片、音樂等非同步任務分別儲存。登入後，可以從左側導覽進入「使用日誌」或「任務日誌」。本頁統一說明三個資料分區、任務狀態和介面查詢方式。

三個分區對應以下路徑：

/usage-logs/common：通用 API 使用日誌和計費明細；
/usage-logs/drawing：Midjourney 繪圖任務；
/usage-logs/task：Suno、影片等通用非同步任務。

使用日誌

在左側邊欄點擊「使用日誌」或造訪 /usage-logs/common 檢視 API 請求和計費明細。

篩選記錄

篩選項目	說明
時間範圍	依記錄建立時間篩選，起訖時間都包含在查詢範圍內。
模型名稱	依模型名稱篩選。
群組	依請求使用的群組篩選。
日誌類型	所有類型、儲值、消耗、管理、系統、錯誤、退款、登入。
權杖名稱	依 API 金鑰名稱篩選。
請求 ID	依平台請求 ID 定位一次請求。
上游請求 ID	依上游服務回傳的請求 ID 定位請求。回報問題時附上這個 ID，排查會快很多。

頁面統計

篩選列中的統計值會跟隨目前篩選條件變化：

Usage：目前篩選範圍內消費記錄的額度合計，可依時間、模型、群組和金鑰等條件檢視。
RPM：最近 60 秒內的消費請求數。
TPM：最近 60 秒內的輸入 Token 與輸出 Token 總數。

清單與詳情

清單包含時間和類型、權杖、模型、串流、Tokens、費用、耗時和詳情等欄。

Tokens：顯示輸入 Token / 輸出 Token；使用快取時還可能顯示快取讀取和寫入數量。
費用：顯示該筆記錄的額度消耗或退款結果。
耗時：對有計時資料的消費或錯誤記錄顯示回應耗時；串流請求可能額外顯示首字回應時間（FRT）和吞吐資訊。
詳情：點擊記錄可開啟詳情對話框。依日誌類型和記錄中實際儲存的欄位，可能包含請求 ID、模型對應、錯誤或退款原因、Token 明細、計費明細、快取/音訊/圖片用量、串流狀態等，不是每筆記錄都會顯示全部區塊。

為什麼看不到某筆記錄

日誌寫入有短暫延遲，剛發出的請求可能要過幾秒才出現，先重新整理頁面再確認。

並非每個失敗回應都會產生 Error 記錄：在請求到達模型之前就被擋下的情況（例如金鑰無效、額度不足），通常不會產生消費日誌。

個人資料中的「記錄 IP 位址」偏好只影響消費日誌和錯誤日誌裡是否儲存請求 IP，不影響記錄本身是否產生。

任務日誌

「任務日誌」包括「繪圖日誌」和「任務日誌」兩個子分區：

繪圖日誌：記錄 Midjourney 繪圖任務。
任務日誌：記錄文生影片、圖生影片、音訊生成等非同步任務。

繪圖日誌

在左側邊欄點擊「任務日誌」→「繪圖日誌」或造訪 /usage-logs/drawing 檢視 Midjourney 繪圖任務記錄。

繪圖日誌支援依以下條件篩選：

日期範圍；
Midjourney 任務 ID。

清單包含提交時間和狀態、操作類型、任務 ID、耗時、提交結果、進度、圖片、提示詞和失敗原因。點擊圖片可開啟預覽；點擊提示詞可檢視完整內容；點擊失敗原因可檢視完整錯誤資訊。

繪圖狀態包括：未啟動、佇列中、執行中、成功、失敗、視窗等待。

非同步任務日誌

在左側邊欄點擊「任務日誌」→「任務日誌」或造訪 /usage-logs/task 檢視非同步任務日誌。

影片、音樂等非同步介面不會在提交請求時立即回傳最終結果。提交成功後，平台會回傳對外公開的任務 ID，並儲存任務記錄，再由背景輪詢上游服務並更新狀態、進度和結果。

篩選任務

任務日誌支援依以下條件篩選：

日期範圍；
任務 ID。

清單與結果

任務清單顯示提交時間和完成時間、任務 ID、平台與操作、耗時、狀態、進度和詳情：

Suno 任務成功且回傳音訊位址時，詳情欄提供音訊預覽；
部分影片任務在成功後會顯示預覽入口；也可以使用同一帳號的登入工作階段或 API 金鑰請求 /v1/videos/{task_id}/content 取得已完成任務的影片內容。該介面會驗證任務歸屬，任務未完成或不屬於目前使用者時不會回傳內容；
其他失敗記錄會在詳情欄顯示失敗原因，點擊後可檢視完整資訊。

任務狀態與背景處理

非同步任務日誌使用以下狀態值。不同平台回傳的狀態寫法可能略有差異，透過介面讀取時建議做相容處理。

狀態	含義
未啟動	任務記錄已建立，但尚未開始處理。
佇列中	已提交到上游，等待後續處理。
排隊中	已進入處理佇列。
執行中	正在處理。
成功	已完成，可以檢視或取得結果。
失敗	處理失敗；失敗原因會寫入任務記錄（如果上游提供）。
未知	內部定義的未知狀態兜底值。

任務狀態由背景輪詢更新，約每 15 秒檢查一次，因此剛提交的任務會有短暫延遲。用介面查詢任務結果時，請按這個節奏設定輪詢間隔，不要用高頻迴圈請求。長時間沒有完成的任務會在逾時後轉為失敗終態。

失敗、逾時與退款

任務進入失敗終態後，若任務有提交階段預扣的額度，系統通常會嘗試退還，並在退款成功時寫入一筆「退款」日誌。退款成功後會清除任務記錄中的待退款額度，並回減累計用量；請求次數不會因此回退。

以下情況可能導致頁面狀態與餘額暫時不一致：

任務本來就沒有預扣額度（費用顯示為 0）；
退款暫時沒有成功，系統會保留該額度以便重試或人工對帳。這種情況請保留任務 ID 聯絡客服。

介面參考

日誌查詢介面

如果你想把用量接入自己的對帳或監控系統，可以呼叫以下唯讀介面。介面使用登入狀態認證，回傳結果始終限定為目前帳號。

資料	介面	時間參數單位
通用日誌	`GET /api/log/self`	秒（`created_at`）
日誌統計	`GET /api/log/self/stat`	秒
Midjourney 繪圖	`GET /api/mj/self`	毫秒（`submit_time`）
非同步任務	`GET /api/task/self`	秒（`submit_time`）

日誌和任務清單介面使用分頁參數 p 和 page_size；頁碼從 1 開始，超過 100 的 page_size 會被截為 100。

另外，GET /api/log/token 可以直接用 API 金鑰讀取該金鑰最近的日誌，無需登入狀態，適合在伺服器端做用量自查；最多回傳最近 1000 筆記錄。金鑰過期或額度耗盡都不影響這個查詢。

GET /api/task/self 的常用查詢參數：p、page_size、task_id、start_timestamp、end_timestamp，也接受 platform、action、status。

任務介面的 start_timestamp、end_timestamp 使用 Unix 秒時間戳記；Midjourney 繪圖介面的時間參數使用毫秒。

非同步生成與任務介面

以下介面用於提交和查詢影片、音樂、繪圖等非同步任務，均使用 API 金鑰認證。影片內容介面也接受登入工作階段，並會驗證任務歸屬，只回傳屬於你自己的任務內容。

具體支援哪些平台取決於目前開通的模型，可在模型廣場按模型類型篩選確認。

介面	路徑	說明
OpenAI 影片生成	`POST /v1/videos`	建立 OpenAI 相容的影片生成非同步任務，成功後回傳任務識別碼。
OpenAI 影片任務查詢	`GET /v1/videos/{task_id}`	查詢影片生成任務的狀態、進度和結果資訊。
影片內容取得	`GET /v1/videos/{task_id}/content`	將已完成影片內容串流回傳；系統會依任務結果從上游取得內容或解碼已儲存的 data URL。
影片 Remix	`POST /v1/videos/{video_id}/remix`	基於已有影片提交新的 Remix 非同步任務。
舊版影片生成	`POST /v1/video/generations`	相容舊版影片生成路徑，建立非同步影片任務。
舊版影片任務查詢	`GET /v1/video/generations/{task_id}`	查詢舊版影片生成任務狀態和結果。
Kling 文生影片	`POST /kling/v1/videos/text2video`	使用 Kling 格式提交文字生成影片任務，系統會先執行請求格式轉換。
Kling 圖生影片	`POST /kling/v1/videos/image2video`	使用 Kling 格式提交圖像生成影片任務。
Kling 任務查詢	`GET /kling/v1/videos/text2video/{task_id}` `GET /kling/v1/videos/image2video/{task_id}`	查詢 Kling 文生影片或圖生影片任務結果。
即夢官方介面	`POST /jimeng/`	相容即夢官方 API 格式，透過 `Action`、`Version` 等參數區分提交任務和查詢操作。
Suno 任務提交	`POST /suno/submit/{action}`	提交 Suno 音樂生成任務，具體任務類型由 `action` 參數決定。
Suno 任務查詢	`POST /suno/fetch` `GET /suno/fetch/{id}`	查詢 Suno 任務清單或指定任務的狀態和結果。
Midjourney 任務提交	`POST /mj/submit/{action}` `POST /{mode}/mj/submit/{action}`	支援 `imagine`、`describe`、`blend`、`change`、`simple-change`、`edits`、`video`、`action`、`modal` 和 `shorten` 等任務操作。
Midjourney 任務查詢	`GET /mj/task/{id}/fetch` `GET /mj/task/{id}/image-seed` `POST /mj/task/list-by-condition`	查詢任務狀態、圖像種子或依條件查詢任務清單；也支援帶 `{mode}` 前綴的路徑。
Midjourney 圖片代理	`GET /mj/image/{id}` `GET /{mode}/mj/image/{id}`	依 Midjourney 任務 ID 取得或代理生成的圖片。
Midjourney 擴充操作	`POST /mj/insight-face/swap` `POST /mj/submit/upload-discord-images`	提供換臉和上傳 Discord 圖片等擴充功能。

與資料看板的關係

日誌是逐筆明細，資料看板是依時間、模型和群組彙總後的統計。兩者的重新整理時機不同：新請求先出現在日誌中，圖表資料要等彙總後才更新，所以短時間內兩邊對不上是正常的。

排查一次呼叫時，建議先在使用日誌中依時間、模型、Request ID 或 Upstream Request ID 定位請求；非同步請求則記錄提交介面回傳的 task_id，再查詢任務最終狀態和失敗詳情。需要聯絡客服時，附上請求 ID 或任務 ID 是最快的方式。