工具
平铺转 3D
平铺拍的衣服直接立起来，呈现上身后的立体效果。
把平铺或挂拍的衣服照片变成立体的上身效果（隐形模特效果），不用请模特。适用于服装平铺图转立体图、电商详情页和商品主图。
概览
| 项目 | 说明 |
|---|---|
| 命令 | tufty flat-to-3d |
| 类型 | 图片 |
| 必填输入 | --product 商品图，至少 1 件 |
| 可选输入 | --model 模特图（宠物、人物或主体） |
| 输出 | 图片：每组商品×模特配对 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 flat-to-3d 始终显示当前价格，--dry-run 打印准确预估。见 积分。
示例
一条平铺连衣裙，高画质，竖版
tufty flat-to-3d --product ./flatlay-dress.jpg --quality high --ratio 3:4T 恤正反面算一件商品，再加两件衣服，一次跑完并下载
tufty flat-to-3d --product ./tee-front.jpg+./tee-back.jpg ./jeans.jpg ./jacket.jpg --save ./out输出示例
{
"ok": true,
"result": {
"tool": "flat-to-3d",
"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 为空。见 输出模式。
提示
- 衣服平铺在纯色背景上拍，完整展开、不要折叠。
- 同一件衣服的正反面属于一件商品，用
+连接。