MoneyPrinterTurbo 深度解析从关键词到成片AI 短视频自动化生产的工程实践一、短视频生产的人力瓶颈与一个开源项目的回答一条 60 秒的短视频标准生产流程是写脚本 → 找素材 → 配音 → 剪辑 → 加字幕 → 配音乐 → 导出。即便是熟练的剪辑师这套流程走下来也需要 1 到 2 个小时。如果日更三条一天光在生产上就要花掉 4 到 6 个小时。这个瓶颈催生了一个朴素的问题能不能把整条流水线自动化MoneyPrinterTurbo 正是对这个问题的工程化回答。它是一个开源的 AI 短视频自动生成工具输入一个主题关键词系统自动调用 LLM 撰写脚本、搜索免费视频素材、生成 TTS 配音、对齐字幕、添加背景音乐最终合成一条可直接发布的高清短视频。全程无需人工介入。项目在 GitHub 上已获得超过 72,000 颗星是目前最受关注的 AI 内容自动化项目之一。它的名字叫“印钞机”暗示的商业模式很直接批量生成短视频铺号矩阵通过平台分成或带货变现。这个模式在短视频圈并不新鲜但以前需要人工团队操作现在一台普通电脑就能跑起来。本文将从架构设计、核心模块、部署实践、配置指南和进阶用法五个维度对这个项目做一次完整的工程拆解。二、五步 Pipeline每一步都是独立的 AI 或工具调用MoneyPrinterTurbo 的核心是一个五阶段顺序流水线。每个阶段产生工件artifact供下一阶段消费。任务编排服务负责管理这个流程并通过状态更新跟踪进度同时支持stop_at参数实现部分执行。第一步文案生成。用户输入的关键词被发送给 LLM按短视频脚本格式生成文案。文案包含两个关键部分画面描述用于后续搜索素材和配音文稿用于 TTS 合成。LLM 提供商通过 LiteLLM 统一接入支持 100 模型包括 DeepSeek、Moonshot、GPT、Claude 等。LLM 服务的核心函数_generate_response()充当所有提供商请求的路由器_normalize_text_response()负责清理和验证 LLM 的原始输出。特别值得一提的是系统内置了逻辑来剥离 DeepSeek R1 等模型的“思考块”think blocks确保最终文案的干净和直接可用。第二步素材获取。根据文案中的画面描述系统自动在 Pexels 和 Pixabay 上搜索匹配的视频片段并下载。素材匹配的具体逻辑是先把文案中的画面描述翻译成英文关键词这两个平台的搜索接口主要支持英文然后调 API 按关键词搜索取前 N 条结果按相关度排序后下载。素材匹配的精度完全取决于关键词的质量。如果 LLM 生成的画面描述过于抽象比如“感受自由的气息”搜出来的素材就会很泛。如果画面描述足够具体比如“日落时分海滩上奔跑的金毛犬”匹配度会高很多。这也是为什么文案质量是整条 pipeline 的决定性变量。第三步语音合成。配音文稿被送入 TTS 引擎生成语音。系统支持多种 TTS 方案Azure TTS V1基于 Edge TTS免费且无需 API Key、Azure TTS V2、SiliconFlow TTS、Google Gemini TTS、小米 MiMo TTS、MiniMax TTS、ElevenLabs TTS、自托管Chatterbox TTS、自托管Kokoro TTS、Fish Audio TTS、ModelBestVoxCPM TTS以及无配音模式。用户可以直接在 WebUI 中选择 Provider 和音色并按照界面提示填写所需凭据。第四步字幕对齐。字幕生成走的是 TTS 引擎的时间戳输出而不是后期做音频强制对齐。Edge TTS 在生成语音时同时输出每个词的起止时间SSML bookmarkMoneyPrinterTurbo 直接用这个时间信息生成.srt字幕文件。这种方式的精度比 Whisper 事后对齐更高因为时间戳是在生成时确定的不是事后猜的。第五步视频合成。所有素材、配音、字幕和背景音乐被送入最终合成阶段。系统使用 ffmpeg 完成剪辑、拼接、字幕叠加和音频混合。视频合成支持多种高清尺寸规格并可选择视频转场效果和拼接模式。三、架构拆解MVC 模式下的服务化设计MoneyPrinterTurbo 采用完整的 MVC 架构代码结构清晰易于维护。核心服务模块组织在app/services/目录下每个服务暴露一组函数由任务管理器进行编排。核心服务模块任务编排服务。任务编排服务app/services/task.py是整条流水线的指挥中心。它管理 5 阶段顺序流程处理stop_at参数以实现部分执行并通过状态服务更新任务状态。同时它还使用专用的ThreadPoolExecutor管理跨平台发布任务。LLM 集成服务。LLM 服务app/services/llm.py提供对 13 提供商的统一访问处理脚本生成和关键词提取。提供商注册表和默认模型维护在app/models/llm_provider.py中。语音合成服务。语音服务app/services/voice.py处理文本到语音的转换支持 edge-tts、Azure、OpenAI、SiliconFlow、Gemini、MiMo、Chatterbox 等多种引擎。数据流与存储策略系统采用分层存储策略在静态资源和动态生成内容之间保持清晰分离。每个阶段的输出工件被写入特定目录后续阶段从这些目录读取。这种设计使得 pipeline 的每个阶段都可以独立调试和替换也支持通过stop_at参数在任意阶段停止只生成部分结果。多提供商适配器架构MoneyPrinterTurbo 的多提供商架构支持三种类型的提供商集成。对于 LLM 提供商系统使用标准化的命名约定一个名为moonshot的提供商会在config.toml的[app]部分查找moonshot_api_key、moonshot_base_url和moonshot_model_name三个配置项。这种约定式设计使得添加新提供商只需要在代码中添加一个适配器类而不需要修改配置解析逻辑。任务状态管理视频生成是异步执行的。任务编排服务通过状态服务跟踪每个任务的进度支持查询、列出和删除任务。状态更新贯穿整个 pipeline用户可以通过 API 或 WebUI 实时查看任务进展。四、三种运行模式WebUI、API 与 CLIMoneyPrinterTurbo 提供了三种运行模式覆盖从快速体验到自动化集成的全部场景。WebUI 模式StreamlitWebUI 是大多数用户的首选。启动方式非常简单# Windows.\webui.bat# macOS / Linuxshwebui.shwebui.bat会优先使用项目.venv或一键包内置 Python如果没有找到项目 Python 但已安装uv会自动切换为uv run streamlit。如需允许局域网内其他设备访问可以先执行set MPT_WEBUI_HOST0.0.0.0再运行启动脚本。启动后浏览器会自动打开。如果页面空白建议换用 Chrome 或 Edge 浏览器。WebUI 提供了完整的参数控制面板包括视频主题、语言、素材来源、视频比例、片段时长、配音引擎和音色等设置。API 模式FastAPI对于需要集成到自动化流程或第三方系统的场景MoneyPrinterTurbo 提供了 REST APIuv run python main.py所有端点以http://localhost:8080为前缀。API 提供了视频生成、任务管理和媒体管理三类接口。视频生成是异步执行的通过任务管理端点GET /api/v1/tasks可以跟踪进度和获取输出文件。媒体管理端点支持上传和列出背景音乐文件GET /api/v1/musics以及本地视频素材。API 默认仅允许同源网页访问。只有独立网页前端需要从其他来源直接调用 API 时才应通过环境变量CORS_ALLOWED_ORIGINS配置可信来源例如http://localhost:3000,https://frontend.example.com。curl、Postman、n8n 和其他服务端调用不受 CORS 限制。API 文档可以在http://127.0.0.1:8080/docsSwagger或http://127.0.0.1:8080/redocReDoc在线调试快速体验接口。CLI 模式纯命令行对于无法使用浏览器或端口转发的环境可以直接在命令行生成视频uv run python cli.py --video-subject人工智能如何改变日常生活字幕样式和配音参数按以下优先级取值命令行显式参数 config.toml中[ui]保存的 WebUI 设置 内置默认值。其余生成设置如背景音乐、视频数量、段落数量等不会自动沿用 WebUI 的保存值。若 WebUI 中选择了上传自备音频命令行需要显式传入--custom-audio-file因为音频路径不会被保存。CLI 还支持批量任务执行uv run python cli.py --batch-file ./tasks.json --stop-at video清单最多包含 100 个任务且不超过 1 MiB。所有条目会在第一个任务启动前完成参数与本地文件预检单个任务运行失败不会阻止后续条目结束后会输出统一的 JSON 汇总。清单中的相对自定义音频与本地素材路径以清单目录为基准。五、部署实战从 Docker 到手动安装Docker Compose 部署推荐Docker 是运行 MoneyPrinterTurbo 的推荐方式。它自动处理所有系统依赖——包括 ImageMagick 和 ffmpeg——并在 Windows、macOS 和 Linux 上保持一致的行为。前置条件Docker DesktopWindows 用户需要 WSL2和 Git。部署步骤# 1. 克隆仓库gitclone https://github.com/harry0703/MoneyPrinterTurbo.gitcdMoneyPrinterTurbo# 2. 复制配置文件必须在启动容器前编辑cpconfig.example.toml config.toml# 3. 编辑 config.toml填入 API Key# 4. 启动容器docker-composeup# 或新版 Dockerdockercompose up首次运行需要几分钟来构建镜像和安装 Python 依赖。启动后可以访问Web UIhttp://localhost:8501API 文档http://localhost:8080/docs。docker-compose.yml定义了两个服务都从同一个 Dockerfile 构建webui服务运行 Streamlit 界面api服务运行 FastAPI 后端。两个服务都将当前目录挂载到容器中便于开发时实时修改代码。手动部署如果你需要更精细的控制或者 Docker 环境不可用可以选择手动部署。① 创建虚拟环境推荐使用uv项目支持 Python 3.11gitclone https://github.com/harry0703/MoneyPrinterTurbo.gitcdMoneyPrinterTurbo uv pythoninstall3.11uvsync--frozen如果不使用uv也可以用传统的venv pippython3.11-mvenv .venvsource.venv/bin/activate pipinstall-rrequirements.txtpyproject.toml是主依赖定义文件uv.lock是锁文件建议默认执行uv sync --frozen。requirements.txt仅保留给旧的pip安装方式兼容使用。② 启动 WebUI在项目根目录下执行# Windows.\webui.bat# macOS / Linuxshwebui.sh③ 启动 API 服务uv run python main.py# 或已激活虚拟环境python main.py六、配置指南config.toml 完全解析config.toml是 MoneyPrinterTurbo 的核心配置文件位于项目根目录。首次启动时如果文件不存在应用会自动从config.example.toml复制一份你可以立即开始编辑。建议将config.toml排除在版本控制之外因为它可能包含 API Key。LLM 提供商配置系统通过llm_provider字段选择用于生成视频脚本和搜索词的语言模型。支持的提供商包括openai、moonshot、azure、qwen、deepseek、gemini、ollama、g4f、oneapi、cloudflare、ernie、modelscope等。以 OpenAI 兼容接口为例[app] llm_provider openai openai_api_key sk-... openai_base_url https://api.openai.com/v1 openai_model_name gpt-4o-mini如果你没有 OpenAI API Key可以使用g4f代替无需 API Key或者使用国内的 Moonshot API。对于本地部署可以配置 Ollama。推荐起步方案OpenAI 的gpt-4o-mini是官方推荐的入门选择——速度快、成本低。免费替代方案包括 Pollinations、g4f 和 Ollama 本地模型。只需修改config.toml中的llm_provider即可切换提供商。视频素材源配置video_source字段控制素材来源支持pexels、pixabay、coverr、wavespeed、volcengine_seedance、ofox、metaso_minimax、loomloom、openai_image和local本地素材。Pexels 和 Pixabay 都需要免费的 API Key。注册 Pexels API 的流程是进入网站注册登录点击右上角选择“图片和视频 API”获取 API Key。两个平台都支持配置多个 Key 以避免速率限制pexels_api_keys [key1, key2, key3] pixabay_api_keys [key1, key2]系统会自动轮换使用多个 Key有效规避单 Key 的速率限制。TTS 配音配置Edge TTSAzure TTS V1是最常用的配音方案——免费、无需 API Key、支持中英文音色。如需更高质量的音色可以配置 Azure TTS V2、ElevenLabs 或 SiliconFlow 等付费方案。TTS 的voice_name参数决定了使用的音色。完整的命名规范由提供商前缀和音色标识组成例如siliconflow:FunAudioLLM/CosyVoice2-0.5B:alex-Male。ElevenLabs 的集成会从 API 获取用户收藏的音色列表需要提供 API Key 并筛选“favorite”音色来填充选择列表。字幕与背景音乐字幕提供商通过subtitle_provider配置可选edge、whisper或留空禁用。Whisper 方案使用本地faster-whisper转写音频适用于需要更准确字幕时间轴的场景但首次使用需要下载模型。下载解压后将整个目录放到.\MoneyPrinterTurbo\models最终路径应为.\MoneyPrinterTurbo\models\whisper-large-v3。背景音乐库位于resource/songs/目录可以通过 APIGET /api/v1/musics列出所有可用的 MP3 文件。系统还集成了 AI 背景音乐服务如 Sonilo 和 ElevenLabs。API 安全与 CORSapi_key字段为 API 路由和任务文件提供可选保护。默认仅允许同源网页访问 API。如果需要跨域调用通过环境变量配置CORS_ALLOWED_ORIGINShttp://localhost:3000,https://frontend.example.com七、接入自定义 API多提供商架构的灵活扩展MoneyPrinterTurbo 的多提供商架构是其最实用的设计之一。只要你的 API 兼容其支持的接口标准就可以通过修改config.toml接入。接入 OpenAI 兼容 API大多数第三方 API 中转服务、自部署模型和兼容 OpenAI 格式的国产模型都可以通过openai提供商接入[app] llm_provider openai openai_api_key your-custom-api-key openai_base_url https://your-custom-api.com/v1 openai_model_name your-model-name接入原生提供商系统对 DeepSeek、Moonshot、Qwen、Gemini、Ollama 等主流提供商有原生支持只需填写对应提供商的专用配置字段。接入本地 Ollamallm_provider ollama ollama_base_url http://localhost:11434 ollama_model_name llama3接入 AI/ML API聚合平台llm_provider aimlapi aimlapi_api_key your_key aimlapi_base_url https://api.aimlapi.com/v1 aimlapi_model_name openai/gpt-4o-mini这种多提供商架构不仅支持 LLM也扩展到视频素材、TTS 和背景音乐服务。你可以混合使用不同提供商——用 DeepSeek 生成脚本、用 Edge TTS 配音、用 Pexels 获取素材——在质量和成本之间找到最佳平衡。八、进阶玩法与社区生态批量生成与任务编排CLI 的--batch-file支持批量任务执行清单最多包含 100 个任务。每个任务可以覆盖全局默认参数。单个任务失败不会阻止后续条目执行结束后输出统一的 JSON 汇总。本地素材模式如果你有自己的视频素材库可以将video_source设为local系统会从本地目录读取 MP4、MOV 等格式的文件。这适合需要精确控制画面内容的场景。社区扩展版本社区已经出现了多个 MoneyPrinterTurbo 的增强版本。MoneyPrinterTurbo-Extended在字幕高亮和 TTS 能力上做了显著改进增加了逐词高亮功能并集成了 Chatterbox TTS 语音克隆能力——只需 10 到 60 秒的参考音频即可克隆任意声音。MoneyPrinterTurbo2025是一个活跃的 fork后期计划包括 GPT-SoVITS 配音支持、优化语音合成使其更加自然和情绪丰富、增加视频转场效果、以及增加更多视频素材来源以提高素材和文案的匹配度。云部署方案华为云提供了基于 MoneyPrinterTurbo 的解决方案实践帮助用户在弹性云服务器 ECS 上快速构建短视频生成器 WebUI 应用。阿里云开发者社区也发布了深度解析与部署指南。多语言支持系统支持多语言视频脚本处理包括中英文双语优化。中文字幕的显示效果和中文语音合成效果都经过了专门优化支持多种中文语音合成引擎。九、成本、局限与适用场景成本结构MoneyPrinterTurbo 本身是 MIT 许可证下的开源项目核心引擎完全免费。实际运行成本主要来自三个方面LLM API 调用费用使用 GPT-4o-mini 生成一条短视频脚本的成本通常在几分钱以内。使用免费的 g4f 或 Ollama 本地模型可以将这部分成本降为零。TTS 费用Edge TTS 完全免费。ElevenLabs 和 Azure TTS V2 等高质量方案需要付费但成本可控。视频素材 APIPexels 和 Pixabay 的 API 对大多数用例免费。注意部分素材有 editorial-only 限制批量使用场景下应自行确认合规性。核心局限素材匹配精度素材匹配完全依赖 LLM 生成的画面描述质量。抽象的描述会导致素材泛化这是当前 pipeline 的主要瓶颈。成品质量与专业剪辑师的手工作品相比仍有明显差距。但对于日更量产的短视频账号来说完成度已经足够。中文字幕排版部分用户反馈中文字幕的断句和显示效果仍有优化空间。离线场景虽然支持 Ollama 本地模型但完整的离线视频生成需要所有服务LLM、TTS、素材源都支持本地部署。适用场景批量内容生产适合需要日更多条短视频的矩阵账号运营者。内容创作辅助作为视频生产的“第一稿”工具生成初稿后再人工精修。自动化集成通过 API 接入现有内容管理系统或自动化工作流如 n8n。学习与实验项目代码结构清晰是学习 AI Agent 编排和视频处理流水线的优秀参考。十、总结MoneyPrinterTurbo 用一个五步顺序流水线把短视频生产中重复性最高的六个环节——写脚本、找素材、配音、配字幕、配音乐、合成——全部自动化了。它的技术选择务实而清晰用 LiteLLM 统一接入 100 LLM用多提供商适配器架构覆盖 TTS、素材和背景音乐的每一个环节用 MVC 架构保证代码的可维护性。它的价值不在于生成“完美”的视频而在于把视频生产的边际成本降到接近零。对于需要批量内容输出的场景这个价值是巨大的。项目的活跃度也值得关注。持续的功能迭代、活跃的社区 fork、以及云平台官方部署方案的推出都说明这个项目正在从“个人工具”向“生产级基础设施”演进。如果你正在寻找一个可以真正跑起来的 AI 视频自动化方案MoneyPrinterTurbo 是目前开源生态中最值得深入研究的项目之一。项目地址https://github.com/harry0703/MoneyPrinterTurbo许可证MIT技术栈Python 3.11 / Streamlit / FastAPI / ffmpeg / LiteLLM 
长河君 · 2026/10/13 10:29:18 · 阅读 1.2k MoneyPrinterTurbo 深度解析：从关键词到成片，AI 短视频自动化生产的工程实践
MoneyPrinterTurbo 深度解析从关键词到成片AI 短视频自动化生产的工程实践一、短视频生产的人力瓶颈与一个开源项目的回答一条 60 秒的短视频标准生产流程是写脚本 → 找素材 → 配音 → 剪辑 → 加字幕 → 配音乐 → 导出。即便是熟练的剪辑师这套流程走下来也需要 1 到 2 个小时。如果日更三条一天光在生产上就要花掉 4 到 6 个小时。这个瓶颈催生了一个朴素的问题能不能把整条流水线自动化MoneyPrinterTurbo 正是对这个问题的工程化回答。它是一个开源的 AI 短视频自动生成工具输入一个主题关键词系统自动调用 LLM 撰写脚本、搜索免费视频素材、生成 TTS 配音、对齐字幕、添加背景音乐最终合成一条可直接发布的高清短视频。全程无需人工介入。项目在 GitHub 上已获得超过 72,000 颗星是目前最受关注的 AI 内容自动化项目之一。它的名字叫“印钞机”暗示的商业模式很直接批量生成短视频铺号矩阵通过平台分成或带货变现。这个模式在短视频圈并不新鲜但以前需要人工团队操作现在一台普通电脑就能跑起来。本文将从架构设计、核心模块、部署实践、配置指南和进阶用法五个维度对这个项目做一次完整的工程拆解。二、五步 Pipeline每一步都是独立的 AI 或工具调用MoneyPrinterTurbo 的核心是一个五阶段顺序流水线。每个阶段产生工件artifact供下一阶段消费。任务编排服务负责管理这个流程并通过状态更新跟踪进度同时支持stop_at参数实现部分执行。第一步文案生成。用户输入的关键词被发送给 LLM按短视频脚本格式生成文案。文案包含两个关键部分画面描述用于后续搜索素材和配音文稿用于 TTS 合成。LLM 提供商通过 LiteLLM 统一接入支持 100 模型包括 DeepSeek、Moonshot、GPT、Claude 等。LLM 服务的核心函数_generate_response()充当所有提供商请求的路由器_normalize_text_response()负责清理和验证 LLM 的原始输出。特别值得一提的是系统内置了逻辑来剥离 DeepSeek R1 等模型的“思考块”think blocks确保最终文案的干净和直接可用。第二步素材获取。根据文案中的画面描述系统自动在 Pexels 和 Pixabay 上搜索匹配的视频片段并下载。素材匹配的具体逻辑是先把文案中的画面描述翻译成英文关键词这两个平台的搜索接口主要支持英文然后调 API 按关键词搜索取前 N 条结果按相关度排序后下载。素材匹配的精度完全取决于关键词的质量。如果 LLM 生成的画面描述过于抽象比如“感受自由的气息”搜出来的素材就会很泛。如果画面描述足够具体比如“日落时分海滩上奔跑的金毛犬”匹配度会高很多。这也是为什么文案质量是整条 pipeline 的决定性变量。第三步语音合成。配音文稿被送入 TTS 引擎生成语音。系统支持多种 TTS 方案Azure TTS V1基于 Edge TTS免费且无需 API Key、Azure TTS V2、SiliconFlow TTS、Google Gemini TTS、小米 MiMo TTS、MiniMax TTS、ElevenLabs TTS、自托管Chatterbox TTS、自托管Kokoro TTS、Fish Audio TTS、ModelBestVoxCPM TTS以及无配音模式。用户可以直接在 WebUI 中选择 Provider 和音色并按照界面提示填写所需凭据。第四步字幕对齐。字幕生成走的是 TTS 引擎的时间戳输出而不是后期做音频强制对齐。Edge TTS 在生成语音时同时输出每个词的起止时间SSML bookmarkMoneyPrinterTurbo 直接用这个时间信息生成.srt字幕文件。这种方式的精度比 Whisper 事后对齐更高因为时间戳是在生成时确定的不是事后猜的。第五步视频合成。所有素材、配音、字幕和背景音乐被送入最终合成阶段。系统使用 ffmpeg 完成剪辑、拼接、字幕叠加和音频混合。视频合成支持多种高清尺寸规格并可选择视频转场效果和拼接模式。三、架构拆解MVC 模式下的服务化设计MoneyPrinterTurbo 采用完整的 MVC 架构代码结构清晰易于维护。核心服务模块组织在app/services/目录下每个服务暴露一组函数由任务管理器进行编排。核心服务模块任务编排服务。任务编排服务app/services/task.py是整条流水线的指挥中心。它管理 5 阶段顺序流程处理stop_at参数以实现部分执行并通过状态服务更新任务状态。同时它还使用专用的ThreadPoolExecutor管理跨平台发布任务。LLM 集成服务。LLM 服务app/services/llm.py提供对 13 提供商的统一访问处理脚本生成和关键词提取。提供商注册表和默认模型维护在app/models/llm_provider.py中。语音合成服务。语音服务app/services/voice.py处理文本到语音的转换支持 edge-tts、Azure、OpenAI、SiliconFlow、Gemini、MiMo、Chatterbox 等多种引擎。数据流与存储策略系统采用分层存储策略在静态资源和动态生成内容之间保持清晰分离。每个阶段的输出工件被写入特定目录后续阶段从这些目录读取。这种设计使得 pipeline 的每个阶段都可以独立调试和替换也支持通过stop_at参数在任意阶段停止只生成部分结果。多提供商适配器架构MoneyPrinterTurbo 的多提供商架构支持三种类型的提供商集成。对于 LLM 提供商系统使用标准化的命名约定一个名为moonshot的提供商会在config.toml的[app]部分查找moonshot_api_key、moonshot_base_url和moonshot_model_name三个配置项。这种约定式设计使得添加新提供商只需要在代码中添加一个适配器类而不需要修改配置解析逻辑。任务状态管理视频生成是异步执行的。任务编排服务通过状态服务跟踪每个任务的进度支持查询、列出和删除任务。状态更新贯穿整个 pipeline用户可以通过 API 或 WebUI 实时查看任务进展。四、三种运行模式WebUI、API 与 CLIMoneyPrinterTurbo 提供了三种运行模式覆盖从快速体验到自动化集成的全部场景。WebUI 模式StreamlitWebUI 是大多数用户的首选。启动方式非常简单# Windows.\webui.bat# macOS / Linuxshwebui.shwebui.bat会优先使用项目.venv或一键包内置 Python如果没有找到项目 Python 但已安装uv会自动切换为uv run streamlit。如需允许局域网内其他设备访问可以先执行set MPT_WEBUI_HOST0.0.0.0再运行启动脚本。启动后浏览器会自动打开。如果页面空白建议换用 Chrome 或 Edge 浏览器。WebUI 提供了完整的参数控制面板包括视频主题、语言、素材来源、视频比例、片段时长、配音引擎和音色等设置。API 模式FastAPI对于需要集成到自动化流程或第三方系统的场景MoneyPrinterTurbo 提供了 REST APIuv run python main.py所有端点以http://localhost:8080为前缀。API 提供了视频生成、任务管理和媒体管理三类接口。视频生成是异步执行的通过任务管理端点GET /api/v1/tasks可以跟踪进度和获取输出文件。媒体管理端点支持上传和列出背景音乐文件GET /api/v1/musics以及本地视频素材。API 默认仅允许同源网页访问。只有独立网页前端需要从其他来源直接调用 API 时才应通过环境变量CORS_ALLOWED_ORIGINS配置可信来源例如http://localhost:3000,https://frontend.example.com。curl、Postman、n8n 和其他服务端调用不受 CORS 限制。API 文档可以在http://127.0.0.1:8080/docsSwagger或http://127.0.0.1:8080/redocReDoc在线调试快速体验接口。CLI 模式纯命令行对于无法使用浏览器或端口转发的环境可以直接在命令行生成视频uv run python cli.py --video-subject人工智能如何改变日常生活字幕样式和配音参数按以下优先级取值命令行显式参数 config.toml中[ui]保存的 WebUI 设置 内置默认值。其余生成设置如背景音乐、视频数量、段落数量等不会自动沿用 WebUI 的保存值。若 WebUI 中选择了上传自备音频命令行需要显式传入--custom-audio-file因为音频路径不会被保存。CLI 还支持批量任务执行uv run python cli.py --batch-file ./tasks.json --stop-at video清单最多包含 100 个任务且不超过 1 MiB。所有条目会在第一个任务启动前完成参数与本地文件预检单个任务运行失败不会阻止后续条目结束后会输出统一的 JSON 汇总。清单中的相对自定义音频与本地素材路径以清单目录为基准。五、部署实战从 Docker 到手动安装Docker Compose 部署推荐Docker 是运行 MoneyPrinterTurbo 的推荐方式。它自动处理所有系统依赖——包括 ImageMagick 和 ffmpeg——并在 Windows、macOS 和 Linux 上保持一致的行为。前置条件Docker DesktopWindows 用户需要 WSL2和 Git。部署步骤# 1. 克隆仓库gitclone https://github.com/harry0703/MoneyPrinterTurbo.gitcdMoneyPrinterTurbo# 2. 复制配置文件必须在启动容器前编辑cpconfig.example.toml config.toml# 3. 编辑 config.toml填入 API Key# 4. 启动容器docker-composeup# 或新版 Dockerdockercompose up首次运行需要几分钟来构建镜像和安装 Python 依赖。启动后可以访问Web UIhttp://localhost:8501API 文档http://localhost:8080/docs。docker-compose.yml定义了两个服务都从同一个 Dockerfile 构建webui服务运行 Streamlit 界面api服务运行 FastAPI 后端。两个服务都将当前目录挂载到容器中便于开发时实时修改代码。手动部署如果你需要更精细的控制或者 Docker 环境不可用可以选择手动部署。① 创建虚拟环境推荐使用uv项目支持 Python 3.11gitclone https://github.com/harry0703/MoneyPrinterTurbo.gitcdMoneyPrinterTurbo uv pythoninstall3.11uvsync--frozen如果不使用uv也可以用传统的venv pippython3.11-mvenv .venvsource.venv/bin/activate pipinstall-rrequirements.txtpyproject.toml是主依赖定义文件uv.lock是锁文件建议默认执行uv sync --frozen。requirements.txt仅保留给旧的pip安装方式兼容使用。② 启动 WebUI在项目根目录下执行# Windows.\webui.bat# macOS / Linuxshwebui.sh③ 启动 API 服务uv run python main.py# 或已激活虚拟环境python main.py六、配置指南config.toml 完全解析config.toml是 MoneyPrinterTurbo 的核心配置文件位于项目根目录。首次启动时如果文件不存在应用会自动从config.example.toml复制一份你可以立即开始编辑。建议将config.toml排除在版本控制之外因为它可能包含 API Key。LLM 提供商配置系统通过llm_provider字段选择用于生成视频脚本和搜索词的语言模型。支持的提供商包括openai、moonshot、azure、qwen、deepseek、gemini、ollama、g4f、oneapi、cloudflare、ernie、modelscope等。以 OpenAI 兼容接口为例[app] llm_provider openai openai_api_key sk-... openai_base_url https://api.openai.com/v1 openai_model_name gpt-4o-mini如果你没有 OpenAI API Key可以使用g4f代替无需 API Key或者使用国内的 Moonshot API。对于本地部署可以配置 Ollama。推荐起步方案OpenAI 的gpt-4o-mini是官方推荐的入门选择——速度快、成本低。免费替代方案包括 Pollinations、g4f 和 Ollama 本地模型。只需修改config.toml中的llm_provider即可切换提供商。视频素材源配置video_source字段控制素材来源支持pexels、pixabay、coverr、wavespeed、volcengine_seedance、ofox、metaso_minimax、loomloom、openai_image和local本地素材。Pexels 和 Pixabay 都需要免费的 API Key。注册 Pexels API 的流程是进入网站注册登录点击右上角选择“图片和视频 API”获取 API Key。两个平台都支持配置多个 Key 以避免速率限制pexels_api_keys [key1, key2, key3] pixabay_api_keys [key1, key2]系统会自动轮换使用多个 Key有效规避单 Key 的速率限制。TTS 配音配置Edge TTSAzure TTS V1是最常用的配音方案——免费、无需 API Key、支持中英文音色。如需更高质量的音色可以配置 Azure TTS V2、ElevenLabs 或 SiliconFlow 等付费方案。TTS 的voice_name参数决定了使用的音色。完整的命名规范由提供商前缀和音色标识组成例如siliconflow:FunAudioLLM/CosyVoice2-0.5B:alex-Male。ElevenLabs 的集成会从 API 获取用户收藏的音色列表需要提供 API Key 并筛选“favorite”音色来填充选择列表。字幕与背景音乐字幕提供商通过subtitle_provider配置可选edge、whisper或留空禁用。Whisper 方案使用本地faster-whisper转写音频适用于需要更准确字幕时间轴的场景但首次使用需要下载模型。下载解压后将整个目录放到.\MoneyPrinterTurbo\models最终路径应为.\MoneyPrinterTurbo\models\whisper-large-v3。背景音乐库位于resource/songs/目录可以通过 APIGET /api/v1/musics列出所有可用的 MP3 文件。系统还集成了 AI 背景音乐服务如 Sonilo 和 ElevenLabs。API 安全与 CORSapi_key字段为 API 路由和任务文件提供可选保护。默认仅允许同源网页访问 API。如果需要跨域调用通过环境变量配置CORS_ALLOWED_ORIGINShttp://localhost:3000,https://frontend.example.com七、接入自定义 API多提供商架构的灵活扩展MoneyPrinterTurbo 的多提供商架构是其最实用的设计之一。只要你的 API 兼容其支持的接口标准就可以通过修改config.toml接入。接入 OpenAI 兼容 API大多数第三方 API 中转服务、自部署模型和兼容 OpenAI 格式的国产模型都可以通过openai提供商接入[app] llm_provider openai openai_api_key your-custom-api-key openai_base_url https://your-custom-api.com/v1 openai_model_name your-model-name接入原生提供商系统对 DeepSeek、Moonshot、Qwen、Gemini、Ollama 等主流提供商有原生支持只需填写对应提供商的专用配置字段。接入本地 Ollamallm_provider ollama ollama_base_url http://localhost:11434 ollama_model_name llama3接入 AI/ML API聚合平台llm_provider aimlapi aimlapi_api_key your_key aimlapi_base_url https://api.aimlapi.com/v1 aimlapi_model_name openai/gpt-4o-mini这种多提供商架构不仅支持 LLM也扩展到视频素材、TTS 和背景音乐服务。你可以混合使用不同提供商——用 DeepSeek 生成脚本、用 Edge TTS 配音、用 Pexels 获取素材——在质量和成本之间找到最佳平衡。八、进阶玩法与社区生态批量生成与任务编排CLI 的--batch-file支持批量任务执行清单最多包含 100 个任务。每个任务可以覆盖全局默认参数。单个任务失败不会阻止后续条目执行结束后输出统一的 JSON 汇总。本地素材模式如果你有自己的视频素材库可以将video_source设为local系统会从本地目录读取 MP4、MOV 等格式的文件。这适合需要精确控制画面内容的场景。社区扩展版本社区已经出现了多个 MoneyPrinterTurbo 的增强版本。MoneyPrinterTurbo-Extended在字幕高亮和 TTS 能力上做了显著改进增加了逐词高亮功能并集成了 Chatterbox TTS 语音克隆能力——只需 10 到 60 秒的参考音频即可克隆任意声音。MoneyPrinterTurbo2025是一个活跃的 fork后期计划包括 GPT-SoVITS 配音支持、优化语音合成使其更加自然和情绪丰富、增加视频转场效果、以及增加更多视频素材来源以提高素材和文案的匹配度。云部署方案华为云提供了基于 MoneyPrinterTurbo 的解决方案实践帮助用户在弹性云服务器 ECS 上快速构建短视频生成器 WebUI 应用。阿里云开发者社区也发布了深度解析与部署指南。多语言支持系统支持多语言视频脚本处理包括中英文双语优化。中文字幕的显示效果和中文语音合成效果都经过了专门优化支持多种中文语音合成引擎。九、成本、局限与适用场景成本结构MoneyPrinterTurbo 本身是 MIT 许可证下的开源项目核心引擎完全免费。实际运行成本主要来自三个方面LLM API 调用费用使用 GPT-4o-mini 生成一条短视频脚本的成本通常在几分钱以内。使用免费的 g4f 或 Ollama 本地模型可以将这部分成本降为零。TTS 费用Edge TTS 完全免费。ElevenLabs 和 Azure TTS V2 等高质量方案需要付费但成本可控。视频素材 APIPexels 和 Pixabay 的 API 对大多数用例免费。注意部分素材有 editorial-only 限制批量使用场景下应自行确认合规性。核心局限素材匹配精度素材匹配完全依赖 LLM 生成的画面描述质量。抽象的描述会导致素材泛化这是当前 pipeline 的主要瓶颈。成品质量与专业剪辑师的手工作品相比仍有明显差距。但对于日更量产的短视频账号来说完成度已经足够。中文字幕排版部分用户反馈中文字幕的断句和显示效果仍有优化空间。离线场景虽然支持 Ollama 本地模型但完整的离线视频生成需要所有服务LLM、TTS、素材源都支持本地部署。适用场景批量内容生产适合需要日更多条短视频的矩阵账号运营者。内容创作辅助作为视频生产的“第一稿”工具生成初稿后再人工精修。自动化集成通过 API 接入现有内容管理系统或自动化工作流如 n8n。学习与实验项目代码结构清晰是学习 AI Agent 编排和视频处理流水线的优秀参考。十、总结MoneyPrinterTurbo 用一个五步顺序流水线把短视频生产中重复性最高的六个环节——写脚本、找素材、配音、配字幕、配音乐、合成——全部自动化了。它的技术选择务实而清晰用 LiteLLM 统一接入 100 LLM用多提供商适配器架构覆盖 TTS、素材和背景音乐的每一个环节用 MVC 架构保证代码的可维护性。它的价值不在于生成“完美”的视频而在于把视频生产的边际成本降到接近零。对于需要批量内容输出的场景这个价值是巨大的。项目的活跃度也值得关注。持续的功能迭代、活跃的社区 fork、以及云平台官方部署方案的推出都说明这个项目正在从“个人工具”向“生产级基础设施”演进。如果你正在寻找一个可以真正跑起来的 AI 视频自动化方案MoneyPrinterTurbo 是目前开源生态中最值得深入研究的项目之一。项目地址https://github.com/harry0703/MoneyPrinterTurbo许可证MIT技术栈Python 3.11 / Streamlit / FastAPI / ffmpeg / LiteLLM