项目简介
本项目是一个基于 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 界面主要分为四个模块：文案设置、视频参数、音频配置和字幕样式。
- 输入主题：必填项，系统将根据此内容自动检索素材并生成文案。
- 配置参数：选择视频尺寸、时长、背景音等可选参数。
- 生成预览：点击生成后，后端日志会显示素材搜索、下载、剪辑及合成的全过程。
- 下载成品：合成完成后，可在页面直接下载生成的 MP4 文件。
技术架构分析
该项目展示了如何利用现代 Web 框架与大模型结合实现自动化内容生产。
- 后端核心：FastAPI 提供了高性能的异步处理能力，适合处理 AI 推理和媒体转码任务。
- MVC 模式：分离了业务逻辑、数据访问和视图层，便于后续扩展新的模型或素材源。
- 资源调度：程序内部实现了素材的自动下载与缓存机制，减少了重复请求。
未来计划中已包含支持用户上传私有素材的功能，这将进一步增强项目的灵活性。
