工具
运镜控制
逐帧掌控镜头与主体的运动。
让一张静图按参考视频的运镜和主体动作动起来。适用于模仿运镜、动作迁移、用参考视频控制镜头与主体的运动。
概览
| 项目 | 说明 |
|---|---|
| 命令 | tufty motion-control |
| 类型 | 视频 |
| 必填输入 | --still 静帧图，恰好 1 张 |
| 可选输入 | --motion-video 参考运镜视频 |
| 输出 | 视频：5 或 10 秒 |
参数
| 参数 | 说明 | 可选值 | 默认值 |
|---|---|---|---|
--still <file|url...> | 视频用的静帧图：本地路径、data: URL 或 http(s) 地址 | 恰好 1 张 | — |
--duration <seconds> | 视频时长（秒） | 5、10 | 5 |
--ratio <id> | 视频画面比例 | 9:16、1:1、16:9 | 9:16 |
--resolution <id> | 输出分辨率，价格见下方 | 720P | 720P |
--motion-video <file|url> | 要跟随的参考运镜视频；原样上传，不做抠图 | 本地路径或 http(s) 地址 | — |
--notes <text> | 本次生成的补充说明，自由文本，最多 2000 字 | — | — |
--no-cutout | 跳过输入图片的自动抠图（每张省 1 积分） | 开关 | 默认抠图 |
--dry-run | 只校验并打印请求载荷和积分预估，不上传、不扣费 | 开关 | — |
--no-wait | 提交后立即返回 runId | 开关 | 默认等待 |
--timeout <seconds> | 等待任务完成的最大秒数 | 正数 | 900 |
--save <dir> | 把成品下载到这个目录 | — | — |
--format <mode> | 标准输出格式：完整信封，或每行一个成品地址 | json、url | json |
价格
| 分辨率 | 每秒积分 | 5 秒 | 10 秒 |
|---|---|---|---|
720P | 19.05 | 95 | 191 |
总价 = round(每秒单价 × --duration)，另加每张静帧 1 积分的自动抠图费用。
价格取自 2026 年 9 月 15 日的工具清单，可能调整。tufty tools describe motion-control 始终显示当前价格，--dry-run 打印准确预估。见 积分。
示例
跟随一段推镜参考视频，5 秒，竖版
tufty motion-control --still ./model.jpg --motion-video ./dolly-in.mp4 --duration 5 --ratio 9:16参考视频用网络地址，10 秒，下载到本地
tufty motion-control --still ./corgi.jpg --motion-video https://example.com/walk-cycle.mp4 --duration 10 --save ./out输出示例
{
"ok": true,
"result": {
"tool": "motion-control",
"runId": "3f6c2a1e-8b4d-4e7a-9c55-0d2b7e1f4a90",
"status": "completed",
"outputs": [
{
"type": "video",
"url": "https://static.tufty.ai/.../result.mp4"
}
]
}
}配合 --save <dir> 时每个成品额外带 path；配合 --no-wait 时 status 为 running、outputs 为空。见 输出模式。
提示
- 参考视频原样上传、不抠图；尽量短，时长接近所选
--duration。 - 静图的主体和构图尽量和参考视频相近。