花生AI成片失败需按四步排查：先运行【文稿诊断】修正硬性错误；再检查本地素材解析状态与路径一致性；接着通过【历史记录】定位失败阶段并针对性修复；最后用指令跳过可疑模块验证问题根源。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
花生AI文稿成片失败时，不能只盯着“重试”按钮反复点——失败提示里藏着真实卡点：可能是文稿结构触发了分镜切分逻辑崩坏，也可能是本地素材解析未完成却强行启动匹配，还可能是年号、数字等结构化字段缺失导致时间轴对齐中断。
第一步：确认文稿是否通过基础校验
打开花生AI项目编辑页，点击右上角【文稿诊断】按钮（图标为放大镜+文档），系统会自动扫描三类硬性问题：含不可见控制字符（如Word复制带的零宽空格）、单句超200字、连续标点超过3个。若出现红色报错，必须修正后才能继续——【未通过此步校验的文稿，后续所有操作都无效】。
这一步操作起来很简单，直接点击按钮就行，但很多人跳过它，结果在配音环节卡住两小时。
第二步：检查本地素材状态（仅启用本地素材时必做）
方法一：进入左侧【资产】→ 查看目标视频右侧状态栏，显示“解析完成”才可参与成片；若为“智能解析中”或“解析失败”，需等待或重新上传。
方法二：在创建项目时已勾选本地素材，但成片失败提示“未找到匹配画面”，此时要点开【创作偏好】→ 拉到最底部查看「素材可用性报告」，里面会明确列出哪几段口播因无对应画面被降级为MG动画或空白帧。
注意：解析是一次性动作，但解析完成≠随时可用——如果上传后修改过原始视频文件名或移动了本地路径，花生AI无法感知，仍会调用旧缓存，导致匹配失效。
第三步：定位失败发生的具体阶段
第一步：在项目页点击【历史记录】→ 找到最近一次失败任务 → 点击右侧【详情】。
第二步：观察失败时间戳对应的阶段名称，常见四类：
① “分镜生成中”失败 → 文稿含大量括号嵌套、Markdown表格或代码块，需手动删掉或转为纯文本再粘贴；
② “配音合成中”失败 → 文稿含未标注读音的专有名词（如“傉檀”“僣号”），需在词后加括号注音，例：“傉檀（rù tán）”；
③ “画面匹配中”失败 → 启用了本地素材但未在【创作偏好】中声明“优先使用本地素材”，AI默认混合调用云端库，而你的本地素材库里恰好缺某类镜头；
④ “时间轴对齐中”失败 → 文稿中年号、日期、数据未结构化（如写“建安十三年”而非“【年号:建安】【年数:13】”），导致TTS与字幕时间码错位超1.2秒，系统自动终止。
第四步：强制跳过可疑模块快速验证
在项目编辑页，点击右下角对话框，输入指令：“跳过分镜生成，用方案B直出初稿，MG动画占比70%”。
这条指令会绕过文稿切分与画面检索，直接调用花生AI内置MG模板库生成骨架视频。如果这步成功，说明问题一定出在文稿结构或本地素材匹配逻辑上；如果仍失败，则大概率是账号积分不足、浏览器缓存异常或当前服务器节点临时拥塞。
浏览器缓存异常的表现是：上传按钮灰显、预览窗口空白、历史记录里任务状态长期卡在“排队中”。此时需清空Chrome/Edge缓存并关闭所有花生AI相关标签页后重进。
