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