
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1052
使用教程
环境要求
- 开发环境推荐 macOS(其他环境可能存在兼容性问题)
- Python 3.10.12
- 必须安装 ffmpeg(用于音视频合成)
- 使用 Docker 方式需安装 Docker 与 docker-compose
- OpenAI API Key 与 Hugging Face Token 为可选,用于提升绘图质量
安装与启动步骤
-
1获取项目代码
从 GitHub 克隆仓库到本地并进入项目目录,后续所有命令都在该目录下执行。
git clone https://github.com/bravekingzhang/text2video.git cd text2video -
2检查 ffmpeg
视频合成声音依赖 ffmpeg,未安装需先自行安装,再执行命令确认已可用。
ffmpeg -version -
3配置密钥文件
在项目根目录新建 .env 文件,写入 OpenAI 与 Hugging Face 相关配置;仅用 pollinations-ai 时可不填 Token。
-
4Docker 一键启动
在项目根目录执行该命令构建并启动容器,适合不想配置本地 Python 环境的用户。
docker-compose up --build -
5本地安装依赖
采用本地开发方式时,使用 Python 3.10.12 安装 requirements.txt 中的依赖。
pip install -r requirements.txt -
6启动本地服务
在项目目录执行该命令启动应用,启动后在浏览器访问本地 5001 端口页面。
python3.10 app.py
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
OPEN_AI_API_KEY | 否 | 调用大模型生成 midjourney 类绘图提示词,提升出图质量 | sk-xxxxxxxx |
OPEN_AI_BASE_URL | 否 | OpenAI 接口地址,支持代理或第三方兼容服务 | https://api.moonshot.cn/v1 |
API_TOKEN | 否 | Hugging Face 访问令牌,用于调用文生图模型;使用 pollinations-ai 时可留空 | hf_xxxxxxxxxxxxxxxx |
如何确认成功
浏览器打开 http://127.0.0.1:5001/ 能看到页面,输入文本后能生成带画面、字幕和声音的 mp4 视频。
常见问题
Q:必须购买付费 API Key 吗?
A:不必须。README 说明若使用 pollinations-ai 模型,不填写 Hugging Face token 也可以,该模型走 ChatGPT 的 Dalle-2。
Q:Windows 或 Linux 能直接跑吗?
A:README 给出的开发环境为 macOS,并提示其他环境可能存在兼容性问题;建议优先使用 Docker 方式启动。
Q:生成的中文图片效果差怎么办?
A:项目会先用有道翻译把中文转为英文再生成图片;另外配置 OpenAI API Key 生成绘图提示词,可进一步提升出图质量。
Q:生成的视频没有声音?
A:音频合并依赖 ffmpeg,请先执行 ffmpeg -version 确认安装成功,再重新生成视频。
注意事项
- 本地开发尽量使用 README 指定的 Python 3.10.12 与 macOS 环境
- .env 内含密钥,不要提交到公开仓库
- 服务默认监听 127.0.0.1:5001,被占用时需自行调整
- 输出视频为 mp4 格式,保存在你指定的本地目录
核心亮点
- 集成 edge-tts 和 stable-diffusion,实现从文本到语音、图像、视频的全自动流程
- 代码简洁,依赖少,易于二次开发和集成到其他项目
- 支持自定义语音和图像参数,可生成个性化视频内容
不足之处
- 生成视频的分辨率和时长可能受限,不适合专业级制作
- 文档和社区支持相对薄弱,高级功能需自行探索
适用场景
- 快速制作短视频用于社交媒体或营销
- 生成教学演示或产品介绍视频
- 自动化生成视频内容用于内容农场或批量生产
替代项目
ffmpeg、moviepy、PaddleGAN
同类项目推荐
VideoLingo-OneClick
开源
一键启动,批量完成视频翻译、配音和字幕生成
VideoLingo+cosyvoice批量全自动视频翻译分角色配音加字幕软件,免安装一键启动整合包
OmniVAE
开源
让AI同时生成音视频,跨模态对齐一步到位
A unified audio-video variational autoencoder with cross-modal alignment for joint r···
Awesome-Video-World-Models-with-···
开源
一榜在手,快速掌握视频世界模型的自回归扩散全貌
A Curated List of Awesome Video World Models with AR Diffusion: Covering Algorithms,···
script-to-shootable-storyboard
开源
把剧本一键变成可拍分镜,直接对接AI视频生成
使用 Codex 开发的剧本转可拍分镜 Skill,在 Codex 中运行效果最佳,支持 Seedance、真人/···
Seedance-ShotDesign-Skills
开源
用结构化镜头设计,让文本秒变专业视频片段
Seedance 2.5 Shot Design Skills
Vidu-S
开源
边生成边改的实时空间视频创作工具
Vidu S: Real-Time Interactive, Editable, and Spatial Video Generation
keys-Wasserman-Slate-AI-Studio-p···
开源
在 Mac 上像剧组一样排片,本地生成带声 AI 视频
Imagination Studio by keys+Wasserman powered by TensorFold: an AI film studio for Ma···
Awesome-Personalized-Video-Creat···
开源
一站式收藏个性化视频生成论文与代码,快速上手研究。
This is a repository for organizing papers, codes, and other resources related to pe···
LivePortrait
开源
一张照片传上去,人就能开口说话
Bring portraits to life!