AdsTurbo 视频改造

概述

换掉视频里的某个元素：人物、动作、语言。

什么时候用这个 skill

用户说「换角色」「换个人」「换脸」「视频翻译」「翻译成英文」「动作控制」「让这张照片动起来」时用它。

只是画质、水印、字幕的问题用 adsturbo-video-enhance——那是清理，这里是改内容。

前置条件

• Python 3.8+（脚本只用标准库，不需要安装依赖）
• AdsTurbo API Key，放在环境变量 ADSTURBO_API_KEY 里，获取方法见下
• 可选 ADSTURBO_BASE_URL，默认 https://adsturbo.ai/klian/novartapi

获取 API Key

1. 在 https://adsturbo.ai?channel=skillhub 注册或登录
2. 打开 https://adsturbo.ai/iris/api（工作台 → API），点「创建 API 密钥」，复制生成的 Key
3. export ADSTURBO_API_KEY=<你的 Key>

任何套餐都能用 API Key 调用，按用量扣积分；积分不够时到 https://adsturbo.ai/pricing 充值或升级。1080p 及以上视频、4K 图片需要订阅（只买积分包不算），创建自定义数字人需要 Pro 套餐。

用户还没有 Key 时：ADSTURBO_API_KEY 没设置、脚本报 Key 缺失或 401 时，不要反复重试。先把不需要调接口就能做的部分做完（理清需求，写好文案或提示词，定好画幅、时长、模型等参数，拼好要执行的完整命令），再告诉用户需要 AdsTurbo API Key，把上面三步发给他；拿到 Key 后直接执行准备好的命令。脚本缺 Key 时会在 stdout 输出 "error": "api_key_required" 和获取步骤。Key 只放在环境变量里，回复里不要回显。

命令怎么选

用户要换掉什么？
├─ 出镜的人（保留动作场景）  → character-swap
├─ 让静态人像做出参考动作    → motion-control
└─ 语言（重新配音对口型）    → translate

python3 scripts/video_transform.py character-swap 
  --video-url https://.../original.mp4 --image-url https://.../new-person.jpg

python3 scripts/video_transform.py motion-control 
  --video-url https://.../dance.mp4 --image-url https://.../portrait.jpg

python3 scripts/video_transform.py translate 
  --video-url https://.../clip.mp4 --target-lang en

character-swap 和 motion-control 参数长得一样但含义相反，别搞混：

完整参数见 [references/video_transform.md](references/video_transform.md)。

硬约束：素材只收公网 URL

--video-url --image-url 不接受本地文件路径：

python3 scripts/upload.py file ./clip.mp4
python3 scripts/upload.py image ./person.jpg

也可以用 --workspace-id 接上一个任务的产物。详见 [references/upload.md](references/upload.md)。

异步任务怎么处理

全部异步，脚本默认提交后自动轮询到出结果。

• 超时了：query --workspace-id <id> 接着等，不要重新提交——任务还在跑，重交会重复扣费
• 只想提交不等：--no-wait

详见 [references/work.md](references/work.md)。

回复用户时

• 直接给视频链接，不要提脚本名、命令行、JSON 或退出码
• 提交后说一句预计时长：换角色和动作控制 3–5 分钟，翻译 5–10 分钟
• 换角色遇到多镜头、同一人换装出现的素材，后段镜头可能换不干净——这时建议用户把视频裁成单镜头分别处理，比重跑整条更有效
• 用户说「翻译视频」时确认要的是重新配音（这里）还是只加外语字幕（adsturbo-video-enhance 的 subtitle）

能力边界