疑難排解與請求恢復
根據可觀察的回應恢復任務、處理報價衝突、上傳失敗和串流中斷。
先保留定位資訊
記錄發生時間、介面、HTTP 狀態、業務 code、request_id 和已收到的 taskId。區分伺服器端明確拒絕、網路沒有回傳回應，以及任務受理後才失敗這三種情況。不要在工單或日誌中附 API Key、完整提示詞或原始檔案。
模型找不到或暫不可用
重新讀取已認證的模型目錄，同時檢查 enabled、available 和精確任務 ID。公開模型頁存在，不等於帳號目前可呼叫。50301 持續出現時重新檢查可用性，設定重試次數上限；反覆重試不能解決模型尚未開放的問題。
參數錯誤或報價衝突
400：對照目前 inputSchema 的欄位、型別、列舉、條件必填項檢查，刪除不支援的參數。40901：完整請求、報價有效期或價格發生變化，重新報價並確認。一般的 409 要按具體操作判斷：同一冪等鍵對應到不同請求時，應修正業務關聯，不能不斷重試。
提交逾時，沒有收到任務 ID
不要立刻換一個 Idempotency-Key。保留原請求和原鍵，在有效時間窗內恢復同一次提交；確認是否已受理後再決定下一步。收到 taskId 後查 recordInfo。用戶端逾時、串流中斷或關閉網頁都不會取消任務，最終費用以任務狀態、cost 和 settled 為準。
上傳成功但任務不接受檔案
PUT 成功後仍須呼叫 files/{fileId}/commit。把 commit 回傳的 spicy:// URI 放進模型支援的輸入欄位，不要使用 uploadUrl。檢查簽章時指定的 Content-Type、檔案大小、格式、所屬帳號和有效期。上傳素材保留一天；任務重試前可能需要重新上傳並更新輸入。
沒有回呼或下載連結失效
檢查 HTTPS 回呼端點、是否以原始請求本文驗證簽章，以及是否快速回傳成功。用 recordInfo 補查，避免重複回呼造成重複出貨。下載 URL 過期但生成結果仍在保留期內時，重新申請連結；pending 時稍後再試，unavailable 或生成結果已過期不能靠重新整理舊連結恢復。
串流內容提前結束
先檢查 HTTP 狀態和 Content-Type，再按所選協定解析 SSE。TCP 分片不是完整事件；連線關閉也不是成功標誌。檢查協定結束事件、錯誤事件和應用逾時。斷開後不要假設退款或無成本重發；儲存已收到的 request_id 並查核使用記錄。
餘額、限額與求助
40201 檢查可用餘額，40202 檢查帳號和金鑰消費上限，429 遵循 Retry-After 並降低提交頻率。不要向支援人員傳送金鑰。提供重現步驟、時間、請求 ID 和已去除敏感值的欄位形狀，說明預期結果與實際結果。