排查上傳與生成問題

先定位失敗階段

記錄所選帳戶/工作空間、大致時間、可見錯誤碼和已知任務 ID。不要公開私有圖片資料、憑據或簽名 URL。

上傳失敗、建立請求被拒絕、已經接受的任務失敗，需要不同處理。發生超時後，先查任務歷史或儲存的任務 ID，再決定是否重新生成。

上傳問題

MCP 使用本地圖片時，客戶端必須在 prepare_image_upload 與 complete_image_upload 之間傳輸真實位元組，宣告大小必須與原檔案一致。不能把本地路徑當成 HTTP URL 或圖片檔案 ID。

Web 上傳與公開 API 對相似錯誤可能使用不同結構或錯誤碼，應讀取實際錯誤詳情及公開錯誤參考。

輸入或模型引數不支援

切換模式、模型、解析度或時長後，重新查詢模型能力。檢查參考圖總數、可選欄位和提示詞要求。

遇到 ALPHA_REQUIRED 時，檢查每張參與生成的圖片。Alpha 通道完全不透明的 PNG，或者畫有棋盤格的圖片，不算有效透明。首尾幀模式兩張都要符合，參考圖模式則包含全部參考。

修復引數意味著請求和報價發生變化。AI 不能悄悄移除必須的尾幀、換更貴模型，或繞過點數上限。

已接受任務看似卡住

queued、running、cancelling 都不是終態。應限頻、限時輪詢，不要連續點選生成。本地等待超時或關閉瀏覽器不會取消已接受任務。

任務到達 failed 或 cancelled 後，閱讀錯誤及現有輸出。供應商生成失敗與後續匯出失敗不同，後者可能已經有可用源影片。

取消是盡力執行，應報告實際點數記錄，不承諾失敗或取消就完全免費。

生成成功但效果不好

肢體被裁時，檢查原圖構圖和輸入畫布；外觀不一致時，簡化參考圖與提示詞；迴圈接縫差或停頓不合適時，檢查 Advanced Editor中的幀選擇。

適用時複用已有動作重新匯出。新的 AI 生成是一項新的付費決定，不應作為預設排障步驟。

用簡短安全的資訊求助

通過私密支援渠道提供錯誤碼、可用的 request ID、任務 ID、時間和失敗階段，並說明是否已有源影片或部分輸出。移除 Token、包含隱私的提示詞、圖片正文及簽名連結。