工具
图转视频
把任意一张图变成可分享的短视频。
把一张时尚、宠物或商品图片变成可分享的短视频（5 或 10 秒；9:16、1:1、16:9）。适用于让照片动起来、图片生成视频、制作社媒短视频。
概览
| 项目 | 说明 |
|---|---|
| 命令 | tufty image-to-video |
| 类型 | 视频 |
| 必填输入 | --still 静帧图，恰好 1 张 |
| 可选输入 | 无 |
| 输出 | 视频：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 |
--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 image-to-video 始终显示当前价格，--dry-run 打印准确预估。见 积分。
示例
用一张 lookbook 图生成 5 秒竖版短视频
tufty image-to-video --still ./lookbook.jpg --duration 5 --ratio 9:1610 秒方形视频并描述动作；提交后立即返回，稍后再查
tufty image-to-video --still ./cat-in-sweater.png --duration 10 --ratio 1:1 --notes "猫咪转头眨眼" --no-wait等待用 --no-wait 提交的任务
tufty status <runId> --wait输出示例
{
"ok": true,
"result": {
"tool": "image-to-video",
"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 为空。见 输出模式。
提示
- 视频生成需要几分钟。用了
--no-wait的话，之后用tufty status <runId> --wait取结果。 - 用
--notes描述想要的动作。