要捕獲的公共識別碼
| 識別碼 | 出現位置 | 用途 |
|---|---|---|
request_id | 錯誤主體、儀表板日誌、使用記錄 | 請求級別的支援和對帳 |
id / task_id | 非同步創建和狀態響應 | 輪詢圖像、視頻、音樂和 3D 任務 |
poll_url | 非同步創建響應 | 首選狀態 URL |
billing_transaction_id | 結算時的非串流響應、非同步任務狀態響應、使用記錄、X-Billing-Transaction-ID | 成本對帳 |
X-Task-ID | 非同步任務響應標頭 | 標頭級別的任務關聯 |
| 您自己的工作/用戶 ID | 您的應用程式 | 將 TokenLab 活動與用戶工作流程關聯 |
要記錄的內容
記錄足夠的信息以診斷請求而不洩漏秘密：- 端點、HTTP 方法、模型、狀態碼、時間戳和延遲。
- 公共識別碼：
request_id、task_id、poll_url和billing_transaction_id（如果存在）。 - 清理過的請求形狀：哪些字段存在，而不是完整的提示或私有媒體內容。
- 終端非同步狀態響應，包括公共錯誤字段。
- 客戶端重試計數以及重試是否創建了新任務或恢復了現有任務。
Authorization、API 鍵、管理令牌、簽名 URL、私有媒體 URL、完整提示和用戶個人數據。
故障排除矩陣
使用情況對帳
使用管理 API 進行伺服器端對帳：GET /v1/management/api-keys/{keyId}/usage 可以根據 scene、accessChannel、logicalModel、modelVendor、startDate 和 endDate 進行過濾。使用這些記錄，而不是抓取儀表板頁面或依賴上游供應商任務 ID。
串流響應可能在串流發送後結算，因此即使稍後記錄使用情況，計費標頭也可能缺失。非同步媒體任務可能在終端輪詢後結算。
支援包模板
聯繫支援時，請包括：request_id。task_id和poll_url用於非同步工作。billing_transaction_id（如果存在）。- 端點、方法、模型、時間戳和狀態碼。
- 清理過的請求形狀和公共錯誤主體。
- 您的預期結果和用戶實際看到的內容。
操作檢查
- 對重複的
401、402、429和5xx響應分別發出警報；它們通常有不同的負責人。 - 跟踪在您的產品 SLA 內長時間保持非終端的非同步任務。
- 跟踪同一用戶工作 ID 的重複創建嘗試。
- 抽樣已完成的任務，並驗證用戶可見資產、使用記錄和存儲的任務記錄是否一致。
API 參考
| 主題 | 參考 |
|---|---|
| 錯誤處理 | 錯誤處理 |
| 速率限制 | 速率限制 |
| 計費與定價 | 計費與定價 |
| 獲取 API 鍵使用情況 | 獲取 API 鍵使用情況 |
| 獲取任務狀態 | 獲取任務狀態 |