📖 自助测试指南

本指南基于本次实测编写，已在本机配置好 DeepSeek API Key，你可以直接在本机运行以下命令进行测试。

1 确认环境已就绪 ✅ 已完成

本机已装好全部依赖，DeepSeek API Key 已写入 config.toml：

cd /home/halo/MoneyPrinterTurbo
uv run python -c "from app.config import config; print('✅ config loaded')"

2 测试 1：AI 自动写文案（最快） 约 5 秒

只让 AI 生成文案，不生成视频——这是最快的验证方式：

env -u ALL_PROXY -u HTTPS_PROXY uv run python cli.py \
  --video-subject "你的主题" \
  --stop-at script

--stop-at script 让流水线停在第一步，只看 AI 生成的文案。

3 测试 2：文案 + TTS 配音 约 10 秒

加入免费 TTS 语音合成：

env -u ALL_PROXY -u HTTPS_PROXY uv run python cli.py \
  --video-subject "你的主题" \
  --voice-name "zh-CN-XiaoxiaoNeural-Female" \
  --stop-at audio

产出：storage/tasks/<任务ID>/audio.mp3

4 测试 3：完整视频（本地素材） 约 5-8 分钟

跑完整流水线，用本地 mp4 作为画面素材：

env -u ALL_PROXY -u HTTPS_PROXY uv run python cli.py \
  --video-subject "人工智能如何改变中小企业营销" \
  --video-source local \
  --video-materials "test1.mp4,test2.mp4,test3.mp4" \
  --voice-name "zh-CN-XiaoxiaoNeural-Female"

产出：storage/tasks/<任务ID>/final-1.mp4

5 测试 4：完整视频（在线素材 — 需额外 API Key）

如果你去 pexels.com/api 免费注册获取 API Key，修改 config.toml：

pexels_api_keys = ["你的Pexels Key"]

然后去掉 --video-source local 和 --video-materials，让 AI 自动从 Pexels 搜索下载素材：

env -u ALL_PROXY -u HTTPS_PROXY uv run python cli.py \
  --video-subject "人工智能如何改变中小企业营销"

🔧 常用命令速查

参数	作用	示例
`--video-subject`	视频主题（AI 据此写文案）	"金钱的作用"
`--video-script`	自定义文案（跳过 AI）	"你的完整文案..."
`--voice-name`	TTS 语音	zh-CN-XiaoxiaoNeural-Female
`--video-aspect`	画幅比例	9:16 或 16:9
`--video-count`	一次生成几个版本	3
`--video-source`	素材来源	local / pexels / pixabay
`--stop-at`	流水线停在哪个阶段	script / audio / materials / video
`--no-subtitle-enabled`	不加字幕	—

🎙️ 可用中文语音

zh-CN-XiaoxiaoNeural-Female    (女声·通用)
zh-CN-XiaoyiNeural-Female       (女声·温柔)
zh-CN-YunxiNeural-Male          (男声·新闻)
zh-CN-YunjianNeural-Male        (男声·沉稳)
zh-CN-YunyangNeural-Male        (男声·播音)
zh-CN-YunxiaNeural-Male         (男声·综艺)
zh-CN-XiaochenNeural-Female     (女声·活力)
zh-CN-XiaohanNeural-Female      (女声·可爱)
zh-CN-liaoning-XiaobeiNeural    (东北话)
zh-CN-shaanxi-XiaoniNeural      (陕西话)
zh-TW-HsiaoChenNeural-Female    (台湾女声)
zh-TW-YunJheNeural-Male         (台湾男声)
zh-HK-HiuMaanNeural-Female      (香港粤语女声)
zh-HK-WanLungNeural-Male        (香港粤语男声)

⚠️ 自己测试前要准备的

你要做的	说明
1. 获取 API Key	至少需要一个 LLM Key（DeepSeek/OpenAI/等）来让 AI 自动写文案；要自动找素材还需要 Pexels Key
2. 编辑 config.toml	填 Key + 选择 llm_provider
3. 准备素材	不配 Pexels Key 就用 `--video-source local --video-materials "xxx.mp4"`
4. 清除代理	本机有 SOCKS 代理，跑外网服务前加 `env -u ALL_PROXY -u HTTPS_PROXY`

📂 产出文件在哪里

每次运行后，产物在：

storage/tasks/<UUID>/
├── script.json       # 文案+参数
├── audio.mp3         # TTS 配音
├── subtitle.srt      # SRT 字幕
├── combined-1.mp4    # 素材拼接（无字幕）
└── final-1.mp4       # 最终视频（带字幕）

本机环境：/home/halo/MoneyPrinterTurbo | Python 3.12.3 | DeepSeek API Key 已配置 | Pexels Key 未配置

完整测试报告 | 实测视频 | 口播稿