本案例解决两个高频问题：生成了可用图片后怎样让它稳定服务后续镜头；视频或图片任务失败后怎样只重试失败项，而不是重新消耗所有资源。

第一部分：建立可复用资产

假设你已生成一张通过的角色图。将它保存并用下列规范命名：

项目缩写_资产角色_内容_版本_状态
示例：OD_角色_沈昭正面_v1_通过

资产登记卡

在资产描述中记录，而不是只靠文件名回忆：

字段	示例
用途	主角外观参考，适用于旧码头第一段。
关键特征	短黑发、墨绿风衣、右手银戒。
生成来源	IMAGE_MODEL_CODE、16:9、任务 ID。
可作为输入	角色参考、首帧参考、镜头角色资产。
不适用	白天、室内、换装镜头。

这张登记卡能避免把“某个看起来像”的旧图错误用于新镜头。

第二部分：生成候选而不覆盖正式资产

用 Agent 请求候选图：

为项目资产“沈昭”生成 4 张角色形象候选图。
模型：IMAGE_MODEL_CODE；尺寸：1024x1024；保持短黑发、深墨绿色风衣和右手银色戒指。
候选保持待审核，不覆盖已有正式资产。

审核标准：

1. 有且只有一个主体。
2. 三项关键外观特征均保留。
3. 没有文字、水印、无关道具或明显结构错误。
4. 与现有场景光线至少存在可匹配版本。

只有明确选择的候选才入正式资产库。未选候选保留来源和任务记录，后续可作为失败对照或风格参考。

第三部分：精准重试失败任务

先判断失败类别

失败类别	典型线索	首个动作
参数/模型问题	模型不存在、比例/时长不支持	修正模型代码或不支持参数。
素材引用问题	URL 不可访问、参考图格式错误	检查对象存储、公开域名和文件格式。
渠道问题	上游限流、认证失败、超时	管理员检查渠道健康与凭证。
内容质量问题	任务成功但人物/动作不对	复制提示词，只改一个变量后重新生成。

查询当前任务

在画布 Agent 中使用：

检查当前会话中所有生成任务的状态、进度、失败原因和实际积分。对于失败的视频任务，只重试失败项，不重复提交已完成任务。

执行卡会展示任务状态和失败原因。选择“重试失败项”后，系统应复用原计划的目标与参数，仅恢复失败的图片、视频或音频任务。若输入资产已被删除或失效，应先修复资产引用，不要盲目重试。

第四部分：重试前的最小检查表

• 原任务 ID、目标节点、模型代码和错误信息已经记录。
• 目标节点没有被另一个并行任务覆盖。
• 图片/视频参考链接仍然可以从上游访问；本地路径不可作为公网参考。
• 新参数只改动了一个明确问题点。
• 已完成任务未勾选为重试对象。
• 管理员确认渠道仍为启用且健康状态可用。

示例：参考视频不可访问

现象：视频任务失败，错误说明上游无法读取参考视频。

处理：

1. 在媒体节点确认视频已经上传成功，而不是浏览器临时文件路径。
2. 检查生产环境是否配置对象存储和 PUBLIC_BASE_URL。
3. 对要求公开参考 URL 的模型，确认对象存储域名可被外部访问。
4. 重新把有效媒体节点连接到目标视频节点，保留原视频任务记录。
5. 使用“重试失败项”或提交一个带新任务 ID 的最小测试，不重新批量生成所有镜头。

上一页案例 5：画布 Agent 协作

下一页案例 7：上线一个 AI 渠道