项目简介
本项目是一个基于 Python 和 FastAPI 框架开发的开源工具,旨在通过简单的主题或关键词自动生成高清短视频。它支持全自动化的视频文案创作、素材搜索、字幕合成及背景音乐添加,最终输出符合主流社交媒体格式的视频文件。
功能特性
项目采用完整的 MVC 架构,代码结构清晰,易于维护,同时提供 API 接口和 Web 管理界面。
- 智能文案生成:支持根据主题自动调用 AI 大模型生成视频文案,也允许用户自定义输入。
- 多尺寸支持:兼容竖屏(9:16, 1080x1920)和横屏(16:9, 1920x1080)等多种高清视频比例。
- 批量处理:支持一次生成多个视频版本,便于对比选择最佳效果。
- 灵活配置:可设置视频片段时长以调节素材切换频率。
- 多语言与语音:支持中文和英文文案,内置多种语音合成引擎。
- 字幕美化:支持调整字体、位置、颜色、大小及描边设置。
- 音频管理:支持随机或指定背景音乐文件,并可独立调节音量。
- 无版权素材:视频素材来源高清且声明无版权风险。
- 多模型接入:支持 OpenAI、Moonshot、Azure、GPT4Free、One-API、通义千问、Google Gemini、Ollama 等多种大模型后端。

部署指南
Docker 部署
推荐使用 Docker Compose 进行快速部署,无需手动配置复杂的 Python 环境。
在项目目录下执行以下命令:
docker-compose up
常见问题处理
-
镜像源连接失败 如果遇到
Unable to connect to deb.debian.org错误,可通过修改 Dockerfile 中的镜像源解决:RUN echo "deb http://deb.debian.org/debian buster main" > /etc/apt/sources.list RUN sed -i 's/deb.debian.org/mirrors.aliyun.com/g' /etc/apt/sources.list -
中文主题生成报错 在使用中文主题时可能遇到
AttributeError: 'NoneType' object has no attribute 'get'错误,通常与网络环境有关。若需测试中文功能,请确保网络连接正常或使用代理。

使用流程
当前最新版本为 v1.1.0,Web 界面主要分为四个模块:文案设置、视频参数、音频配置和字幕样式。
- 输入主题:必填项,系统将根据此内容自动检索素材并生成文案。
- 配置参数:选择视频尺寸、时长、背景音等可选参数。
- 生成预览:点击生成后,后端日志会显示素材搜索、下载、剪辑及合成的全过程。


