排查上传与生成问题

先定位失败阶段

记录所选账户/工作区、大致时间、可见错误码和已知任务 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、包含隐私的提示词、图片正文及签名链接。