Pixelle-Video TTS 生成失败6 个报错现象定位语音合成问题【免费下载链接】Pixelle-Video AI 全自动短视频引擎 | AI Fully Automated Short Video Engine项目地址: https://gitcode.com/GitHub_Trending/pi/Pixelle-Video用 Pixelle-Video 生成视频时语音这一步卡住是最常见的失败点语音轨道生成失败后整条合成管线会停在渲染前一步前面生成的图文都白跑。报错大多长这样No default workflow configured for tts、Workflow xxx not found、401/NoAudioReceived。先别急下面按你看到的报错对号入座每个现象对应一个根因和一条修复动作。报 No default workflow configured for tts配置里没填默认工作流这是 TTS 排查里概率最高的一种因为服务层没有内置默认工作流default_workflow不填就直接抛这个 ValueError。打开你本地的config.yaml从 config.example.yaml 复制出来的那份确认comfyui下有tts段并且填了值comfyui: tts: default_workflow: selfhost/tts_edge.json保存后重启服务再跑一次。如果不再报这个错说明就是缺配置改完即解决。报 Workflow xxx not found. Available workflows: ...工作流 key 写错了这个报错其实很友好冒号后面直接列出了系统当前能扫到的所有可用 key。TTS 工作流文件必须放在 workflows/ 目录下且文件名以tts_开头配置里填的是目录/文件名格式的 key两个地方对不上就会报这个错。对照报错里列出的可用值把 key 改写成完全一致的形式comfyui: tts: default_workflow: runninghub/tts_edge.json改完后重新生成报错消失就说明 key 对上了。连不上 ComfyUIselfhost 模式的服务地址不通选了selfhost/开头的 TTS 工作流意味着要走本地 ComfyUI默认http://127.0.0.1:8188。地址不通的典型表现是超时或 connection refused。这条命令是检查本地 8188 端口是否真的在监听的正常输出应该看到Connectedcurl -I http://127.0.0.1:8188如果你是用 Docker 跑 Pixelle-Video容器里的127.0.0.1不是宿主机comfyui_url要改成http://host.docker.internal:8188Linux 宿主机则填宿主 IP。地址改成能curl通的值后超时错误就会消失。报 RunningHub 鉴权或任务创建失败云端 API key 没配或失效runninghub/开头的工作流跑在云端依赖comfyui段里的runninghub_api_key。key 为空、填错或过期任务会在创建阶段就失败。检查一下这一行的值并顺手确认环境变量有没有把 key 带进去环境变量RUNNINGHUB_API_KEY优先级更高echo $RUNNINGHUB_API_KEY如果输出是空而你期望有值说明 key 只写在了配置文件里且被覆盖或者压根没填。把正确的 key 填进config.yaml的runninghub_api_key后重试鉴权错误即消失。⚠️ 另外注意runninghub_concurrent_limit默认是 1批量任务排队时别把等待误判成失败。报 401 或 NoAudioReceivededge-tts 本地模式被限流inference_mode为local时项目会直连微软的免费 Edge TTS 接口实现见 pixelle_video/utils/tts_util.py。国内网络下这个接口偶发 401 或NoAudioReceived代码里已经内置了 5 次指数退避重试但网络太差时重试也会全挂。先单独跑一次听音命令验证连通性正常应该直接在终端听到合成语音edge-tts --text 测试语音 --voice zh-CN-YunjianNeural如果这条命令也失败基本可以确定是网络问题而不是项目配置问题。两条出路换个网络或挂代理再试或者把 TTS 切到 ComfyUI 工作流模式绕开微软接口。命令能出声服务里的 401 报错自然就不会再出现。工作流跑完了却报 No audio file generated工作流没有输出音频文件这种报错出现在 _call_comfyui_workflow 里任务状态是 completed但结果里既没有audios也没有files说明工作流本身执行了、只是没产出 mp3/wav。常见原因是工作流节点配置和你本地 ComfyUI 的模型不匹配或者该 TTS 工作流需要的自定义节点没装。先看服务日志里打印的result.audios/result.files/result.outputs三段内容判断是真没生成还是生成了但没被识别。确认是节点问题后换一个同目录下其他可用的tts_工作流比如从tts_index2.json换到tts_spark.json对比验证能出声的那个就是你的可用组合。兜底建议上面 6 个现象对不上时把完整日志拉出来看Pixelle-Video 用 loguru 打日志直接看服务进程的终端输出重点搜TTS generation、Edge TTS、workflow三个词。配置字段含义可对照 docs/zh/reference/config-schema.md工作流列表见 workflows/ 目录仍卡住的话把报错原文和config.yaml记得把 key 打码贴到项目 issue 区求助。【免费下载链接】Pixelle-Video AI 全自动短视频引擎 | AI Fully Automated Short Video Engine项目地址: https://gitcode.com/GitHub_Trending/pi/Pixelle-Video创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考