AI短视频出片失败怎么排查？生成日志字段与5类失败码（2026）

本文回答：AI短视频出片失败后怎么排查——每次生成记一条日志要写哪些字段（JSON 模板与字段依据），人物走样、动作崩、镜头不连、冒字或冒 Logo、时长不足 5 个失败码怎么判、各按什么顺序查、下一次改哪一项，以及同一个码连续不过时怎么换办法。

这篇ai短视频制作教程讲出片失败后怎么排查：每生成一次记一条日志，写清输入、参数、失败码、这次只改了哪一项、结果。失败归成 5 个码：P 人物走样、M 动作崩、C 镜头不连、T 冒字或冒 Logo、D 时长不足。各码首查：提示词和参考图有没有打架、动作幅度、前后两镜的模型版本、参考图上的字、时长参数。逐镜生成、调接口还是用产线，判废和归类都要人做。

出片失败日志是按生成请求逐条记的排错台账：一次生成一条记录，写明喂进去的参考与提示词、生成参数、看片判定和相对上一次改了什么。

ai短视频制作教程里的排错，为什么先记日志再重抽？

「不行就再来一次」时，人往往顺手改几个词、换张图、调时长，成了也说不清是哪一处起的作用。日志的三条规则（本文建议）：

1. 一次只改一个变量，change 只许填一项。
2. 参数和提示词分开记。sd25-pe（火山方舟 Seedance 2.5 提示词规范）写明画幅、总时长、分辨率、帧率和声音开关不写进 Prompt，由页面或接口设置。
3. 时长记实际值。方舟《创建视频生成任务》写明 duration 为 -1 时，实际时长通过查询任务 API 返回的 duration 字段获取，要回填。

一条生成记录写哪些字段？JSON 模板

字段名为本文自拟，内容是示例：

{
   
  "run_id": "ep03-s05-r04",
  "parent_run": "ep03-s05-r03",
  "model_version": "2.5",
  "input_mode": "reference",
  "refs": [{
   "slot": "图片1", "role": "人物A，只采用五官、发型和服装"},
           {
   "slot": "图片2", "role": "场景A，不采用图中人物"}],
  "prompt": "<人物A>对应@图片1，只采用五官、发型和服装。<人物A>推门进屋，在桌边坐下。不要字幕。",
  "prompt_chars": 45,
  "params": {
   "ratio": "9:16", "duration_requested": -1, "duration_actual": null,
             "watermark": false, "return_last_frame": true},
  "constraints": ["不要字幕"],
  "change": {
   "field": "prompt", "to": "删去外观描写，只留指代"},
  "verdict": "reject",
  "fail_codes": ["T"],
  "symptom": "下方冒出一行字，和图片2上的店招文字一样"
}

下一条 r05 只改 refs[1]（换成去掉店招文字的同一张图），其余字段照 parent_run 继承。

谁来填这些字段，看做法：网页端逐镜生成再剪，只能手记；直接调模型接口，可让程序在提交和查询时自动落库；画布 / 节点工作流记到哪一层，取决于你搭的流程。按场留版本这件事也可以交给产线，比如猫斯卡（AI 视频生产系统）里每场有独立提示词、独立参考图、独立成片与历史版本，改了词再点生成才算新的一版；它解决的是每场的提示词、参考图和多版成片放在一处、可回看择优，但没有成片自动打分，哪一版能用、算哪类失败仍要人判断，日志里的改动和判定仍要人记。

5 类失败码怎么判？看片判定表

现象与排除项为本文整理：

一条记录可挂多个码，下一次仍只改一项。建议先处理单镜就能验证的 P、M、T、D，C 最后，因为它要两条记录对照。

每个码按什么顺序查？下一次改哪一项

依据是火山方舟公开的 Seedance 2.0 / 2.5 提示词指南、sd2-pe / sd25-pe 两份规范和接口文档，两版写法不同处分开写。

P 人物走样

1. 提示词是否在重写外观：2.0 指南要求描述避免语义冲突；2.5 指南写参考素材已足够精准时只做「指代」、减少画面复述。
2. 是否用了多视图：2.0 指南说人物参考用大头照 + 全身照即可，多视图易被识别为多个主体；sd25-pe 则要求同一主体的多视角参考写成逐图职责、共同定义同一个实体，并明确实体数量。
3. 映射是否只写在图上：2.5 指南说图上写名字、提示词直接用名字，容易导致多人混淆或重复角色；角色错位时按首次出场顺序上传素材、同步改编号。
4. 一次挂了多少：2.0 指南说参考人物超过 4 人稳定性下降，素材推荐总计 4-5 个；2.5 指南说主体图 1-8 个效果较好。
5. 多出同款分身：2.0 指南的固定约束「视频全程禁止出现外形、着装、配饰完全一致的人物，禁止生成同款分身、双胞胎效果」，sd2-pe 多人场景必挂；sd25-pe 规定不得自动添加用户未要求的分身约束。

M 动作崩

1. 幅度：sd2-pe「优先低缓连续小动作，规避狂奔/大跳/剧烈翻滚等高爆发动态」。
2. 运镜：2.0 指南一个镜头里尽量只指定 1 种运镜方式。
3. 写法：2.5 指南动作优先概括性描述；强烈情绪词可能导致瞳孔非自然发光，改常规情绪词并约束「人物眼睛不发光」。
4. 长度：2.0 指南「请勿直接将完整剧本作为提示词使用」；2.5 指南建议复杂任务拆成多个简单任务分次生成。

实操上比如（本文示例，2.0 镜头序号写法）：

做前：她猛地跳上桌子，转身踢飞酒杯，镜头拉远再横移。
做后：镜头1：中景，固定机位，她踩上椅子，手扶桌沿。镜头2：近景，缓推，她把酒杯拨到地上。

C 镜头不连

1. 两条记录 model_version 是否一致。2.5 指南同节办法：要在 2.5 任务里保留 2.0 风格，把 2.0 生成的视频作为延长任务的输入，输出格式选 MOV。
2. 方位锚点：sd25-pe 要求围绕门、桌子、车辆、柜台等稳定物体写内外、前后、朝向、距离，不要只写屏幕左右。
3. 衔接方式：return_last_frame 返回的尾帧可作下一个任务的首帧；全模态参考可用提示词指定首帧 / 尾帧间接实现，要严格保障首尾帧一致时优先用首尾帧模式。
4. 延长接缝：2.0 指南说前段末尾删 6 帧、后段开头删 1 帧；多次续写叠加劣化，要控制次数。

T 冒字冒 Logo

1. 参考图上的字：2.0 指南建议去掉参考素材中不必要的文字。
2. 约束：2.0 指南出字幕加「保持无字幕」，出现其他平台 Logo / 水印加「不要生成水印」「不要生成Logo」；2.5 指南负向控制写「不要字幕」。默认挂不挂几份写法不同：sd2-pe 要求最终输出必须包含画质包 + 稳定包 + 水印 / Logo 兜底，非文字生成任务还必挂字幕兜底；sd25-pe 规定不得自动添加用户未要求的水印、Logo、字幕等约束。
3. 画幅：2.0 指南说横屏出字幕的概率明显低于竖屏，业务允许时先横屏再裁竖屏。
4. 边界：两版指南都写字幕目前无法完全避免；sd25-pe 说精确字幕需结合素材或后期处理。

D 时长不足

1. 范围：duration 取值见上表，文档提醒「视频时长与计费相关，请谨慎设置」；Seed 官网写 Seedance 2.5 单段视频时长提升至 30 秒，并支持两次视频延长。按接口这个范围，一分钟一次请求出不来；页面端如另有生成模式，以页面说明为准。
2. 时长写进了提示词：sd25-pe 说总时长不写进 Prompt；2.0 指南说模型对精确时间（如 0–3 秒）支持不稳定，强行限制时长可能导致结果异常。
3. 内容与长度不匹配：2.5 指南说剧情少模型会自由发挥，内容过多导致过度剪切或剧情遗漏。
4. 片尾截断杂音：sd2-pe 说含旁白的视频可能出现，建议后期做淡出。

ai视频制作教程常漏的收口：同一个码连续不过怎么办？

实操上建议：同一镜头、同一个码，连续 3 次单变量修改仍不过（阈值按预算调），就别在这一镜上重抽，换办法：

一集日志里 P 码占大头时，多半该回头重做参考图，而不是继续改提示词。

常见问题

一段同时人物走样又冒字，记哪个码？

两个都记，fail_codes 是数组；但下一次只改一项，先改好验证的那处（比如去掉图上的字），再看 P 码还在不在。

判废的片段要不要删？

建议留到这一集定稿。下一条的 parent_run 指向它，判断改动有没有用要靠它对照。

日志用表格记还是写程序记？

网页端手记，表格列名和上面字段一致就够；调接口的可在提交和查询时自动落库。verdict 和 fail_codes 都要看完片由人填。