skill-tiktok-video-pipeline v2

TikTok产品广告的完整端到端流水线。接收一个productid + scripttext，输出一个带字幕、可选Logo水印和背景音乐的、可直接发布的竖屏短视频。

架构

scripttext + productid
│
▼
步骤1：Veo 3基础视频生成（9:16，约8秒）
│
▼
步骤2：字幕叠加 + Logo水印
└── tiktokoverlayengine_v3.py（ffmpeg drawtext）
│
▼
步骤3：背景音频混音（20%音量，ffmpeg amix）
│
▼
output/tiktok/id>_final.mp4

环境要求

• - GEMINIAPIKEY 环境变量（用于Veo生成）
• ffmpeg 已加入PATH
• uv 已加入PATH（用于Python脚本）
• veo3-video-gen 技能已安装在 skills/veo3-video-gen/ 目录

使用方法

bash
node scripts/generate.js \
--product-id rain_cloud \
--script-text Stop dry air!|Ultrasonic mist|Whisper-quiet|Get yours today \
--lang EN

带Logo和自定义音频

bash
node scripts/generate.js \
--product-id hydro_bottle \
--script-text Hydrogen water|Boosts energy|Pure & clean|Shop now \
--lang EN \
--logo /path/to/brand_logo.png \
--audio /path/to/bgm.mp3

阿拉伯语（AR）字幕

bash
node scripts/generate.js \
--product-id mini_cam \
--script-text صوّر كل لحظة|دقة عالية|خفيف وصغير|اطلب الآن \
--lang AR

空运行（不调用API，生成虚拟视频用于测试叠加）

bash
node scripts/generate.js \
--product-id test \
--script-text Line 1|Line 2|Line 3 \
--dry-run

输入参数

输出文件

脚本

字幕格式

字幕通过 | 分割，并在视频时长内均匀分配时间。

示例： Hook line!|Feature 1|Feature 2|CTA here → 4个标签，每个在8秒视频中显示约2秒。

标签样式：深色半透明背景框，白色文字，居中位于75%高度。

默认音频

在此技能文件夹的 assets/bgm_default.mp3 路径放置免版税BGM文件，可在所有运行中自动混音。如果未找到音频文件，则输出无BGM的视频。

流水线步骤详情

步骤1 Veo 3生成9:16基础MP4文件 约60–120秒
步骤2 Python叠加定时字幕标签 约5秒
步骤3 ffmpeg以20%音量混入BGM 约5秒
─────────────────────────────────────────────────────────
输出 最终带品牌的MP4文件，可直接发布

pipeline.py（v2.0.0 — Python编排器）

通过子进程直接连接到叠加引擎的Python流水线。

bash
uv run scripts/pipeline.py \
--product rain_cloud \
--image product.jpg \
--output final.mp4 \
--audio /path/to/music.mp3 \
--slowmo

新增标志（v2.0.0）

环境变量