| 1 | # 🙋♀️ Pixelle-Video 常见问题解答 (FAQ) |
| 2 | |
| 3 | |
| 4 | ### 本地自己开发的工作流如何集成使用？ |
| 5 | |
| 6 | 如果您想集成自己开发的 ComfyUI 工作流，请遵循以下规范： |
| 7 | |
| 8 | 1. **本地跑通**：首先确保工作流在您的本地 ComfyUI 中能正常运行。 |
| 9 | 2. **参数绑定**：找到需要由程序动态传入提示词的 Text 节点（CLIP Text Encode 或类似文本输入节点）。 |
| 10 | - 编辑该节点的**标题 (Title)**。 |
| 11 | - 修改标题为 `$prompt.text!` 或 `$prompt.value!`（根据节点接受的输入类型决定）。 |
| 12 | <img src="https://github.com/user-attachments/assets/ddb1962c-9272-486f-84ab-8019c3fb5bf4" width="600" alt="参数绑定示例" /> |
| 13 | |
| 14 | - *参考示例：可以查看 `workflows/selfhost/` 目录下现有 JSON 文件的编辑方式。* |
| 15 | 3. **导出格式**：将修改好的工作流导出为 **API 格式** (Save (API Format))。 |
| 16 | 4. **文件命名**：将导出的 JSON 文件放入 `workflows/` 目录，并遵守以下命名前缀： |
| 17 | - **图片类工作流**：前缀必须是 `image_` (例如 `image_my_style.json`) |
| 18 | - **视频类工作流**：前缀必须是 `video_` |
| 19 | - **语音合成类**：前缀必须是 `tts_` |
| 20 | |
| 21 | ### 如何在本地调试项目中的 RunningHub 工作流？ |
| 22 | |
| 23 | 如果您想在本地测试项目中原本用于 RunningHub 云端的工作流： |
| 24 | |
| 25 | 1. **获取 ID**：打开runninghub工作流文件，找到id |
| 26 | 2. **加载工作流**：将 ID 粘贴到 RunningHub 网站 URL 后缀上，如：https://www.runninghub.cn/workflow/1983513964837543938 进入该工作流页面。 |
| 27 | <img src="https://github.com/user-attachments/assets/e5330b3a-5475-44f2-81e4-057d33fdf71b" width="600" alt="参数绑定示例" /> |
| 28 | |
| 29 | |
| 30 | 4. **下载到本地**：在工作台中将工作流下载为 JSON 文件。 |
| 31 | 5. **本地测试**：将下载的文件拖入您本地的 ComfyUI 画布进行测试和调试。 |
| 32 | |
| 33 | |
| 34 | ### 常见的报错及解决方案 |
| 35 | |
| 36 | #### 1. TTS (语音合成) 报错 |
| 37 | - **原因**：默认的 Edge-TTS 是调用微软的免费接口，可能会受网络波动影响，导致失败频率较高。 |
| 38 | - **解决方案**： |
| 39 | - 检查网络连接。 |
| 40 | - 建议切换使用 **ComfyUI 合成 TTS** 的工作流（选择前缀为 `tts_` 的工作流），稳定性更高。 |
| 41 | |
| 42 | #### 2. LLM (大模型) 报错 |
| 43 | - **排查步骤**： |
| 44 | 1. 检查 **Base URL** 是否正确（不要多出空格或错误的后缀）。 |
| 45 | 2. 检查 **API Key** 是否有效且有余额。 |
| 46 | 3. 检查 **Model Name** 是否拼写正确。 |
| 47 | - *提示：请查阅您所使用的模型服务商（如 OpenAI、DeepSeek、阿里云等）的官方 API 文档获取准确配置。* |
| 48 | |
| 49 | #### 3. 错误提示 "Could not find a Chrome executable..." |
| 50 | - **原因**：您的电脑系统中缺少 Chrome 浏览器内核，导致部分依赖浏览器的功能无法运行。 |
| 51 | - **解决方案**：请下载并安装 Google Chrome 浏览器。 |
| 52 | |
| 53 | |
| 54 | ### 生成的视频保存在哪里？ |
| 55 | |
| 56 | 所有生成的视频自动保存到项目目录的 `output/` 文件夹中。生成完成后，界面会显示视频时长、文件大小、分镜数量及下载链接。 |
| 57 | |
| 58 | ### 有哪些社区资源？ |
| 59 | |
| 60 | - **GitHub 仓库**：https://github.com/AIDC-AI/Pixelle-Video |
| 61 | - **问题反馈**：通过 GitHub Issues 提交 bug 或功能请求 |
| 62 | - **社区支持**：加入讨论群组获取帮助和分享经验 |
| 63 | - **贡献代码**：项目在 MIT 许可证下欢迎贡献 |
| 64 | |
| 65 | 💡 **提示**：如果在此 FAQ 中找不到您需要的答案，请在 GitHub 提交 issue 或加入社区讨论。我们会根据用户反馈持续更新此 FAQ！ |
| 66 |