工具
场景替换
把商品或模特放进任意场景，不用再搭背景板。
把模特图或商品图放进任意新场景（海边、影棚、街拍、咖啡馆），不用搭背景板。适用于换背景、替换照片背景、制作商品场景图和电商生活方式图。
概览
| 项目 | 说明 |
|---|---|
| 命令 | tufty background-swap |
| 类型 | 图片 |
| 必填输入 | --model 模特图（宠物、人物或主体），至少 1 张 |
| 可选输入 | --product 商品图 |
| 输出 | 图片：每组商品×模特配对 1–4 张，一次最多 16 张 |
参数
| 参数 | 说明 | 可选值 | 默认值 |
|---|---|---|---|
--product <file|url...> | 商品图：本地路径、data: URL 或 http(s) 地址。多件商品逐件生成；同一件商品的多张图用 + 连接（最多 4 张） | 最多 8 件 | — |
--model <file|url...> | 模特图（宠物、人物或主体），每个模特和每件商品两两配对 | 最多 8 张 | — |
--quality <id> | 画质档位，价格见下方 | low、medium、high | low |
--ratio <id> | 画面比例；auto 由模型决定 | auto、1:1 (1024x1024)、3:4 (1024x1536)、9:16 (1024x1536) | auto |
--count <n> | 每组商品×模特配对生成的张数 | 1、2、3、4 | 1 |
--enhance | 启用工具自带的提示词增强 | 开关 | 关 |
--notes <text> | 本次生成的补充说明，自由文本，最多 2000 字 | — | — |
--no-cutout | 跳过输入图片的自动抠图（每张省 1 积分） | 开关 | 默认抠图 |
--dry-run | 只校验并打印请求载荷和积分预估，不上传、不扣费 | 开关 | — |
--no-wait | 提交后立即返回 runId | 开关 | 默认等待 |
--timeout <seconds> | 等待任务完成的最大秒数 | 正数 | 900 |
--save <dir> | 把成品下载到这个目录 | — | — |
--format <mode> | 标准输出格式：完整信封，或每行一个成品地址 | json、url | json |
价格
| 画质 | 每张积分 |
|---|---|
low | 4 |
medium | 16 |
high | 47 |
总价 = 画质单价 ×（商品件数 × 模特图数）× --count，另加每张输入图 1 积分的自动抠图费用。
价格取自 2026 年 9 月 15 日的工具清单，可能调整。tufty tools describe background-swap 始终显示当前价格，--dry-run 打印准确预估。见 积分。
示例
把棚拍模特图换到日落海边，竖版 3:4
tufty background-swap --model ./model-white-bg.jpg --notes "日落海边，暖色逆光" --ratio 3:4模特和手袋一起放进同一个场景，启用提示词增强，出 2 张
tufty background-swap --model ./model.jpg --product ./handbag.jpg --notes "极简大理石影棚" --enhance --count 2输出示例
{
"ok": true,
"result": {
"tool": "background-swap",
"runId": "3f6c2a1e-8b4d-4e7a-9c55-0d2b7e1f4a90",
"status": "completed",
"outputs": [
{
"type": "image",
"url": "https://static.tufty.ai/.../result.png"
}
]
}
}配合 --save <dir> 时每个成品额外带 path；配合 --no-wait 时 status 为 running、outputs 为空。见 输出模式。
提示
--notes用来描述新场景：地点、光线、氛围写得越具体越好。- 这个工具的
--product是可选的；需要商品和模特同框时再加上。