README

🎬 Pixelle-Video —— AI 全自动短视频引擎

English | 中文


  
  
  
  
  
  
  


https://github.com/user-attachments/assets/a42e7457-fcc8-40da-83fc-784c45a8b95d



只需输入一个 主题，Pixelle-Video 就能自动完成：
- ✍️ 撰写视频文案  
- 🎨 生成 AI 配图/视频  
- 🗣️ 合成语音解说  
- 🎵 添加背景音乐  
- 🎬 一键合成视频  

零门槛，零剪辑经验，让视频创作成为一句话的事！


 🖥️ Web 界面预览

!Web UI界面


 📋 最近更新

- ✅ 2026-06-01: 新增直连 API 媒体模型配置，支持在 WebUI 中配置图像/视频模型供应商、Base URL 与代理开关
- ✅ 2026-01-26: 新增「动作迁移」模块，上传参考视频和图片进行动作迁移
- ✅ 2026-01-14: 新增「数字人口播」和「图生视频」流水线，新增多语言 TTS 音色支持
- ✅ 2026-01-06: 新增 RunningHub 48G 显存机器调用支持
- ✅ 2025-12-28: 支持 RunningHub 并发限制可配置，优化 LLM 返回结构化数据的逻辑
- ✅ 2025-12-17: 支持 ComfyUI API Key 配置，支持 Nano Banana 模型调用，API 接口支持模板自定义参数
- ✅ 2025-12-10: 侧边栏内置 FAQ，锁定 edge-tts 版本修复 TTS 服务不稳定问题
- ✅ 2025-12-08: 支持固定脚本多种分割方式(段落/行/句子)，优化模板选择交互逻辑支持直接预览选择
- ✅ 2025-12-06: 修复视频生成 API 返回 URL 路径处理，支持跨平台兼容
- ✅ 2025-12-05: 新增 Windows 整合包下载，优化图片与视频反推工作流
- ✅ 2025-12-04: 新增「自定义素材」功能，支持用户上传自己的照片和视频，AI 智能分析生成脚本
- ✅ 2025-11-18: 优化 RunningHub 服务调用支持并行处理，新增历史记录页面，支持批量创建视频任务


 ✨ 功能亮点

- ✅ 全自动生成 - 输入主题，自动生成完整视频
- ✅ AI 智能文案 - 根据主题智能创作解说词，无需自己写脚本
- ✅ AI 生成配图 - 每句话都配上精美的 AI 插图
- ✅ AI 生成视频 - 支持使用 AI 视频生成模型（如 WAN 2.1）创建动态视频内容
- ✅ 直连模型 API - 可直接调用 DashScope、OpenAI、Seedream、Seedance、Kling 等图像/视频生成服务
- ✅ AI 生成语音 - 支持 Edge-TTS、Index-TTS 等众多主流 TTS 方案
- ✅ 背景音乐 - 支持添加 BGM，让视频更有氛围
- ✅ 视觉风格 - 多种模板可选，打造独特视频风格
- ✅ 灵活尺寸 - 支持竖屏、横屏等多种视频尺寸
- ✅ 多种 AI 模型 - 支持 GPT、通义千问、DeepSeek、Ollama 等
- ✅ 原子能力灵活组合 - 支持 ComfyUI / RunningHub 工作流，也支持直连 API 模型，可按需替换图像、视频、TTS、VLM 等能力


 📊 视频生成流程

Pixelle-Video 采用模块化设计，整个视频生成流程清晰简洁：

!视频生成流程图

从输入文本到最终视频输出，整个流程简洁清晰：文案生成 → 配图规划 → 逐帧处理 → 视频合成

每个环节都支持灵活定制，可选择不同的 AI 模型、音频引擎、视觉风格等，满足个性化创作需求。


 🎬 视频示例

以下是使用 Pixelle-Video 生成的实际案例，展示了不同主题和风格的视频效果：

 📱 扩展模块视频展示




👤 数字人口播

韩语数字人口播


🖼️ 图生视频

卡通视频


💃 动作迁移

跳舞小猫





 📱 竖屏视频展示




🌄 人文纪实类 - 视频默认模版

旅行路上的风景让人流连忘返


🔍 文化解构类 - 视频默认模版

Santa ID


🔭 科学思辨类 - 视频默认模版

为什么我们还没有找到外星文明？




🌱 个人成长类 - 克隆音色

如何提升自己


🧠 深度思考类 - 默认模板

如何理解反脆弱


🏯 历史文化类 - 固定画面

资治通鉴




☀️ 情感类 - 克隆音色

冬日暖阳


📜 小说解说类 - 自创脚本

斗破苍穹


🧬 知识科普类 - Qwen生图

养生知识




 🖥️ 横屏视频展示




💰 副业赚钱 - 电影模板

副业赚钱


🏛️ 历史解说 - 自定义模板

资治通鉴启示录




 💡 提示: 这些视频都是通过输入一个主题关键词，由 AI 全自动生成的，无需任何视频剪辑经验！





 🚀 快速开始

 🪟 Windows 一键整合包（推荐 Windows 用户使用）

无需安装 Python、uv 或 ffmpeg，一键开箱即用！

👉 下载 Windows 一键整合包

1. 下载最新的 Windows 一键整合包并解压
2. 双击运行 start.bat 启动 Web 界面
3. 浏览器会自动打开 http://localhost:8501
4. 在「⚙️ 系统配置」中配置 LLM API 和图像生成服务
5. 开始生成视频！

 💡 提示: 整合包已包含所有依赖，无需手动安装任何环境。首次使用只需配置 API 密钥即可。


 从源码安装（适合 macOS / Linux 用户或需要自定义的用户）

 前置环境依赖

在开始之前，需要先安装 Python 包管理器 uv 和视频处理工具 ffmpeg：

 安装 uv

请访问 uv 官方文档查看适合你系统的安装方法：  
👉 uv 安装指南

安装完成后，在终端中运行 uv --version 验证安装成功。

 安装 ffmpeg

macOS
bash
brew install ffmpeg


Ubuntu / Debian
bash
sudo apt update
sudo apt install ffmpeg


Windows
- 下载地址：https://ffmpeg.org/download.html
- 下载后解压，将 bin 目录添加到系统环境变量 PATH 中

安装完成后，在终端中运行 ffmpeg -version 验证安装成功。


 第一步：下载项目

bash
git clone https://github.com/AIDC-AI/Pixelle-Video.git
cd Pixelle-Video


 第二步：启动 Web 界面

bash
 使用 uv 运行（推荐，会自动安装依赖）
uv run streamlit run web/app.py


浏览器会自动打开 http://localhost:8501