📜 日誌與非同步任務
檢視 API 請求、繪圖和非同步任務記錄，按條件篩選明細並跟蹤狀態、結果與退款。
平臺將 API 請求明細、繪圖記錄與音影片等長耗時非同步任務分類儲存，便於開發者快速排障、精確對賬與回溯結果。
控制台提供三個專屬日誌分割槽：
/usage-logs/common：通用 API 呼叫明細與 Token 計費日誌；/usage-logs/drawing：Midjourney 繪圖任務日誌與圖片結果；/usage-logs/task：Suno 音樂、影片等非同步生成任務日誌。
使用者日誌嚴格受許可權隔離，普通開發者僅可檢視當前賬號發起的請求記錄與任務結果。
使用日誌
在左側邊欄點選「使用日誌」或直接訪問 /usage-logs/common 檢視 API 請求與計費明細。
篩選記錄
| 篩選項 | 說明 |
|---|---|
| 時間範圍 | 按請求建立時間篩選，支援自定義起止日期。 |
| 模型名稱 | 輸入模型關鍵字，快速定位指定模型的呼叫頻次。 |
| 分組 | 按請求實際路由的渠道分組進行篩選。 |
| 日誌型別 | 包含全部型別、消耗、充值、錯誤、退款等。 |
| 令牌名稱 | 按 API 金鑰名稱篩選，精準核算各開發環境的消耗。 |
| 請求 ID | 輸入平臺生成的唯一 Request ID 定位單次請求。 |
| 上游請求 ID | 輸入模型提供商返回的原始 Request ID。 |
即時指標看板
篩選欄頂部提供即時吞吐與消耗指標：
- Usage：當前篩選條件下的總額度消耗統計；
- RPM（Requests Per Minute）：最近 60 秒內的併發請求速率；
- TPM（Tokens Per Minute）：最近 60 秒內的 Token 吞吐速率（輸入 Token + 輸出 Token）。
列表與詳情
日誌列表直觀展示呼叫時間、模型、消耗額度、提示 Token、補全 Token 及響應耗時。點選單條日誌可展開檢視請求頭、詳細報錯資訊及上下文快照。
繪圖日誌
在左側邊欄進入 /usage-logs/drawing，檢視 Midjourney 等影像生成任務明細。
- 展示提示詞（Prompt）、提交時間、耗時、執行進度與狀態；
- 生成完成後可直接在列表內預覽圖片，並支援一鍵放大（Upscale）、變換（Variation）等後續操作。
非同步任務日誌
在左側邊欄進入 /usage-logs/task，集中跟蹤影片生成（Sora / Kling / 即夢）、Suno 音樂等長耗時非同步任務。
任務狀態說明
| 狀態 | 詳細含義 |
|---|---|
| 排隊中 / 佇列中 | 任務已成功提交至生成佇列，等待算力排程。 |
| 執行中 | 上游生成引擎正在渲染生成，已可查詢進度百分比。 |
| 成功 | 任務已完成，可在控制台預覽或通過 API 獲取下載連結。 |
| 失敗 | 生成失敗，詳情列提供上游返回的具體錯誤原因。 |
非同步任務狀態通常由系統後臺每 15 秒輪詢更新一次。因大模型影片/音訊渲染耗時較長，請耐心等待狀態重新整理。
失敗、超時與自動退款
非同步任務若因上游服務受阻或超時導致最終失敗：
- 若任務在提交階段預扣了額度，系統會在確認失敗後自動全額退還預扣配額；
- 退款成功時，系統會在通用使用日誌中自動記錄一條「退款」明細，並將額度返還至原賬戶餘額或訂閱配額中。
介面參考
只讀日誌查詢 API
除控制台外，開發者可通過 API 直接拉取呼叫日誌實現自動化對賬：
| 資料型別 | 使用者只讀端點 | 時間引數單位 |
|---|---|---|
| 通用日誌明細 | 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（頁碼，從 1 開始）與 page_size（單頁條數，最大 100）。
非同步生成與任務端點
| 介面型別 | 路徑 | 功能說明 |
|---|---|---|
| 影片生成 | POST /v1/videos | 提交非同步影片生成任務，返回 task_id。 |
| 影片任務查詢 | GET /v1/videos/{task_id} | 查詢生成進度與結果 URL。 |
| 影片流式獲取 | GET /v1/videos/{task_id}/content | 流式代理獲取已生成的影片二進位制內容。 |
| Kling 文生影片 | POST /kling/v1/videos/text2video | Kling 協議文生影片任務提交。 |
| Kling 圖生影片 | POST /kling/v1/videos/image2video | Kling 協議圖生影片任務提交。 |
| Suno 音樂任務 | POST /suno/submit/{action} | 提交 Suno 音樂創作任務。 |
| Suno 狀態查詢 | GET /suno/fetch/{id} | 獲取生成音訊播放地址與歌詞。 |
| Midjourney 任務 | POST /mj/submit/{action} | 提交 Imagine、Blend、Describe 等任務。 |
| Midjourney 查詢 | GET /mj/task/{id}/fetch | 查詢 Midjourney 任務狀態與圖片結果。 |
與資料看板的關係
- 日誌：逐條記錄的原始請求流水，包含每一次呼叫的毫秒級耗時、報錯和精確 Token。
- 資料看板：按時間週期（日/周/月）、模型型別和 API 金鑰進行聚合統計的宏觀趨勢圖。
- 建議：遇到單次呼叫異常或計費疑問時，優先使用「使用日誌」根據 Request ID 定位排查；評估整體用量與選型成本時，參考「資料看板」。
這篇文件對您有幫助嗎？