Pixelle-Video 配置指南从 LLM、ComfyUI 到 RunningHub 的完整初始化【免费下载链接】Pixelle-Video AI 全自动短视频引擎 | AI Fully Automated Short Video Engine项目地址: https://gitcode.com/GitHub_Trending/pi/Pixelle-Video本篇技术指南系统讲解 AI 全自动短视频引擎 Pixelle-Video 的安装后配置流程如何选择并接入大语言模型LLM用于生成视频文案如何通过本地 ComfyUI 或云端 RunningHub 搭建图像/视频生成能力以及配置最终如何写入config.yaml并被程序加载生效。读完本文你将掌握 Pixelle-Video 全部核心配置项的语义、取值与验证方式能够独立完成从零到可生成第一个视频的初始化。一、配置体系总览config.yaml 与配置管理架构Pixelle-Video 的全部配置都集中在仓库根目录下的config.yaml文件中。项目没有提供现成的config.yaml而是附带了一份带详细注释的模板 config.example.yaml顶部注释明确要求将config.example.yaml复制为config.yaml填入自己的服务凭证API Key 等切勿将config.yaml提交到 Git以免泄露密钥。配置文件的顶层结构包含四大块配置块作用llm大语言模型接入生成视频脚本含api_key/base_url/modelapi_providers直连图像/视频/VLM 模型厂商的密钥配置OpenAI、DashScope、ARK、Kling 等无需 ComfyUI 工作流comfyuiComfyUI 与 RunningHub 服务配置以及 TTS/图像/视频各自的默认工作流与提示词前缀template默认视频模板决定画幅比例与版式风格从源码看配置的读取、校验与持久化由pixelle_video/config包统一负责分三层实现pixelle_video/config/schema.py用 Pydantic 定义全部配置模型LLMConfig、ComfyUIConfig、ImageSubConfig、VideoSubConfig、TemplateConfig、PixelleVideoConfig等是所有默认值与校验规则的唯一事实来源pixelle_video/config/loader.py纯 YAML 的读写实现load_config_dict在文件缺失时仅告警并返回空字典使用默认配置save_config_dict以 UTF-8 编码写回 YAMLpixelle_video/config/manager.py单例ConfigManager对外提供类型安全的统一访问入口config_manager.config.llm.api_key、深度合并的update()、validate()以及save()。web/components/settings.py 中的 Web 界面正是通过config_manager这一单例完成读写因此在 Web 界面填写的配置与直接编辑config.yaml是等价的二者任选其一即可。二、LLM 配置为视频脚本生成接入大模型2.1 LLM 在项目中的角色Pixelle-Video 使用大语言模型生成视频文案脚本它是整条自动化流水线的起点。在 pixelle_video/config/schema.py 中is_llm_configured()要求api_key、base_url、model三者全部非空才算配置完成这也是validate_required()判定系统是否可用的唯一标准——可见 LLM 是项目的硬性必需项。2.2 快速预设选择推荐项目为常用模型厂商内置了预设Web 界面的「⚙️ System Configuration → LLM」面板下拉菜单中可直接选择选择后系统会自动填充base_url与model两个字段。完整预设定义见 pixelle_video/llm_presets.py预设名称base_urlmodel说明Qwen通义千问推荐https://dashscope.aliyuncs.com/compatible-mode/v1qwen-max文档标注性价比高OpenAIhttps://api.openai.com/v1gpt-4o通用能力均衡Claudehttps://api.anthropic.com/v1/claude-sonnet-4-5源码内置Web 下拉中可用DeepSeekhttps://api.deepseek.comdeepseek-chat中文场景表现良好Ollama本地完全免费http://localhost:11434/v1llama3.2本地运行、无需联网与付费预设内置默认 API KeyollamaOpenAI SDK 要求必填但 Ollama 会忽略它Moonshothttps://api.moonshot.cn/v1moonshot-v1-8k源码内置每个预设还附带对应的官方 API Key 申请入口api_key_url。在 Web 界面选中预设后点击「 Get API Key」即可跳转到对应厂商的密钥管理页面注册并获取凭证然后填入 API Key 输入框。值得注意的是Web 面板还会根据当前已保存的base_urlmodel自动匹配预设find_preset_by_base_url_and_model见 pixelle_video/llm_presets.py若匹配不上则自动切换到 Custom 选项方便接入任意兼容 OpenAI SDK 协议的服务。2.3 手动填写与 YAML 示例如果不想用预设也可以直接编辑config.yaml中的llm块。项目支持任何兼容 OpenAI SDK 协议的 API 服务config.example.yaml中给出了四组可直接套用的经典取值llm: api_key: sk-xxxx base_url: https://dashscope.aliyuncs.com/compatible-mode/v1 model: qwen-max常用参考Qwen Maxbase_url: https://dashscope.aliyuncs.com/compatible-mode/v1model: qwen-maxOpenAI GPT-4obase_url: https://api.openai.com/v1model: gpt-4oDeepSeekbase_url: https://api.deepseek.commodel: deepseek-chatOllama本地base_url: http://localhost:11434/v1model: llama3.22.4 连接测试与模型列表加载为避免配错地址或密钥Web 面板提供了两个实用工具按钮实现见 pixelle_video/utils/llm_util.py Load Models调用fetch_available_models()请求 OpenAI 兼容的/models端点拉取该服务可用模型列表并填入下拉框 Test Connection调用test_llm_connection()实际发起一次鉴权请求对 401API Key 无效、403权限不足、404Base URL 错误、连接失败、超时等场景给出明确的中文/英文错误提示。底层实现还做了两处容错设计值得一提_build_models_url()会自动补全 models 端点若 base_url 以/v1结尾则拼接/models否则拼接/v1/modelsnormalize_openai_base_url()会自动剥离用户误粘贴的具体端点后缀如/chat/completions、/models只保留 SDK 需要的 API 根路径。ConfigManager.set_llm_config()在保存前也会调用该规范化函数见 pixelle_video/config/manager.py。三、图像/视频生成配置本地 ComfyUI 或云端 RunningHub图像与视频的生成支持两种方式二选一即可官方文档推荐云端方案。3.1 本地部署自建 ComfyUI 服务适合已有 GPU 或有自托管工作流需求的用户步骤自行安装并启动 ComfyUI在配置中填写 ComfyUI 服务地址默认http://127.0.0.1:8188点击「Test Connection」验证连通性——Web 面板的实现是请求{comfyui_url}/system_stats返回 200 即判定连接成功见 web/components/settings.py可选填写 ComfyUI API Key。一个容易被忽略的坑config.example.yaml中有专门注释Docker 用户部署本项目时容器内无法用127.0.0.1访问宿主机上的 ComfyUIMac/Windows 应改用host.docker.internal:8188Linux 则应改用宿主机 IP 地址。3.2 云端部署推荐RunningHub无需本地 GPU所有图像/视频生成都在云端完成注册 RunningHub 账号获取 API Key在配置中填入runninghub_api_key可选配置高级选项高级选项取值范围默认值说明并发限制Concurrent Limit1–101同时执行的任务数普通会员默认 1Web 界面为数值输入框Pydantic 层也以ge1, le10做了约束见 pixelle_video/config/schema.py实例类型Instance Type24GB / 48GB 显存24GB48GB 适合大尺寸视频生成Web 界面选择 48GB 时底层保存为字符串plus见 web/components/settings.py3.3 关键进阶配置默认工作流与提示词前缀无论是本地还是云端图像/视频/TTS 都通过ComfyUI 工作流workflow执行这也是comfyui配置块的核心。config.example.yaml中给出了完整结构comfyui: comfyui_url: http://127.0.0.1:8188 # 自托管工作流必需 comfyui_api_key: # 可选 runninghub_api_key: # RunningHub 工作流必需 runninghub_concurrent_limit: 1 # 并发限制 1-10普通会员默认 1 tts: default_workflow: selfhost/tts_edge.json image: default_workflow: runninghub/image_flux.json # 必需无回退 prompt_prefix: Minimalist black-and-white matchstick figure style illustration, clean lines, simple sketch style video: default_workflow: runninghub/video_wan2.1_fusionx.json # 必需无回退 prompt_prefix: Minimalist black-and-white matchstick figure style illustration, clean lines, simple sketch style三个要点工作流路径前缀即执行后端runninghub/xxx.json走云端 RunningHubselfhost/xxx.json走本地 ComfyUI。仓库中两类工作流分别存放在 workflows/runninghub含image_flux.json、image_flux2.json、video_wan2.1_fusionx.json、video_wan2.2.json、tts_edge.json、tts_index2.json、tts_spark.json等与 workflows/selfhost含image_flux.json、image_nano_banana.json、video_wan2.1_fusionx.json、tts_edge.json等default_workflow是必需的没有回退注释明确标注 Required: Default workflow to use (no fallback)且推荐零本地搭建的runninghub/image_flux.json图像与runninghub/video_wan2.1_fusionx.json视频TTS 默认走本地 Edge TTS 工作流selfhost/tts_edge.jsonprompt_prefix是全局风格统一的关键图像与视频各自维护一个提示词前缀会拼接到每次生成的 prompt 头部默认值即为示例中的黑白火柴人极简线条风格。想换整体视觉风格如赛博朋克、水彩、3D 渲染改这里即可一键生效。四、可选进阶直连模型厂商 API绕过 ComfyUIconfig.example.yaml还提供了api_providers块用于不经 ComfyUI 工作流、直接调用厂商图像/视频/VLM 接口与上面的 LLM、ComfyUI 配置互不影响。支持common全局项print_model_input调试时在终端打印发送给模型的 prompt、模型名与输入文件路径、local_proxy本地 HTTP 代理部分厂商如图像模型需要openaiOpenAI 图像模型base_url默认https://api.openai.com/v1dashscope阿里云百炼Wan/万相、HappyHorse 等base_url默认https://dashscope.aliyuncs.com/api/v1ark火山方舟Seedream、Seedancebase_url默认https://ark.cn-beijing.volces.com/api/v3kling可灵 Kling AI采用access_keysecret_key双凭证base_url默认https://api-beijing.klingai.com。每个厂商都有独立的use_proxy开关决定请求是否走common.local_proxy。对应配置模型在 pixelle_video/config/schema.py 中定义API Key 型与 Access/Secret 型两种凭证模式Web 界面「API Media Models」区域可分别填写。五、模板配置决定画幅比例与版式template.default_template指定视频默认使用的 HTML 框架模板在未显式指定时生效并决定视频画幅比例与版式风格。命名规范见config.example.yaml注释static_*.html静态风格模板不含 AI 生成媒体image_*.html需要 AI 生成图像的模板video_*.html需要 AI 生成视频的模板。template: default_template: 1080x1920/image_default.html按画幅分类的可用模板全部位于 templates 目录1080x1920竖屏/人像image_default.html、image_modern.html、image_elegant.html、static_default.html、video_healing.html等1080x1080方形image_minimal_framed.html等1920x1080横屏/风景image_film.html、image_full.html、image_wide_darktech.html等。配置校验上有个值得一提的细节ConfigManager._load()会在加载时调用resolve_template_path校验模板是否存在若配置的模板缺失仅告警并回退不会导致启动失败见 pixelle_video/config/manager.py。六、保存配置与验证生效6.1 通过 Web 界面保存在「⚙️ System Configuration」面板填完所有必填项后点击「Save Configuration」按钮配置即写入config.yaml。保存逻辑见 web/components/settings.py会依次执行校验 LLM 三项API Key、Base URL、Model均非空否则拒绝保存并提示通过config_manager.set_llm_config()规范化并写入 LLM 配置通过config_manager.set_comfyui_config()写入 ComfyUI/RunningHub 配置通过set_api_provider_config()写入直连厂商配置调用config_manager.save()落盘到config.yaml。面板还提供「Reset Configuration」按钮可将配置重置为全默认值。配置未完成时该面板默认展开、完成后默认折叠方便判断当前系统是否可用。6.2 配置文件的读写细节直接编辑config.yaml同样有效程序启动时会自动加载。加载逻辑在 pixelle_video/config/loader.py文件不存在仅告警使用全部默认配置继续运行文件存在yaml.safe_load解析然后由 Pydantic 模型校验并填充默认值解析失败记录错误并回退为空配置默认值。若运行中修改了config.yaml也可调用config_manager.reload()热加载见 pixelle_video/config/manager.py无需重启 Web 服务。6.3 判断配置是否完成程序内部以validate()即is_llm_configured()判断系统是否可开始生成视频LLM 三要素齐全即为有效这也是 Web 界面是否展开配置面板的依据。七、下一步配置完成后即可进入视频生成环节快速开始Quick Start —— 创建你的第一个视频覆盖启动 Web 界面、输入主题、配置语音与画面、一键生成并预览的完整流程。附录一份最小可运行的 config.yaml 参考将以下内容保存为仓库根目录config.yamlLLM 与 RunningHub 的密钥请替换为真实值即可满足LLM 云端生成的最小可用配置project_name: Pixelle-Video llm: api_key: sk-your-llm-key base_url: https://dashscope.aliyuncs.com/compatible-mode/v1 model: qwen-max comfyui: comfyui_url: http://127.0.0.1:8188 runninghub_api_key: rhk-your-runninghub-key runninghub_concurrent_limit: 1 tts: default_workflow: selfhost/tts_edge.json image: default_workflow: runninghub/image_flux.json video: default_workflow: runninghub/video_wan2.1_fusionx.json template: default_template: 1080x1920/image_default.html安全提醒config.yaml内含真实密钥务必加入.gitignore切勿随仓库提交或公开分享。【免费下载链接】Pixelle-Video AI 全自动短视频引擎 | AI Fully Automated Short Video Engine项目地址: https://gitcode.com/GitHub_Trending/pi/Pixelle-Video创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考