Flat to 3D

turn a flat-lay or hanger photo of a garment into a worn-looking, three-dimensional shot (ghost mannequin style) without a model. Use when the user has flat-lay clothing photos and wants volume, fit and drape for product listings.

Overview

Item	Value
Command	`tufty flat-to-3d`
Type	Image
Required inputs	`--product` product image, at least 1
Optional inputs	`--model` model image (pet, person or subject)
Output	Images: 1–4 per product–model pair, up to 16 per run

Parameters

Flag	Description	Choices	Default
`--product <file\|url...>`	Product images: local path, data: URL or http(s) URL. Several products run one by one; join shots of one product with `+` (up to 4)	up to 8 products	—
`--model <file\|url...>`	Model images (pet, person or subject). Every model is paired with every product	up to 8 images	—
`--quality <id>`	Quality tier; see pricing below	`low`, `medium`, `high`	`low`
`--ratio <id>`	Aspect ratio; `auto` lets the model decide	`auto`, `1:1` (1024x1024), `3:4` (1024x1536), `9:16` (1024x1536)	`auto`
`--count <n>`	Images per product–model pair	`1`, `2`, `3`, `4`	`1`
`--enhance`	Turn on the tool's built-in prompt enhancement	Switch	off
`--notes <text>`	Extra instructions for this run, free text up to 2000 characters	—	—
`--no-cutout`	Skip the automatic cutout of input images (saves 1 credit per image)	Switch	cutout on
`--dry-run`	Validate and print the payload and credit estimate; no upload, no charge	Switch	—
`--no-wait`	Return the `runId` right after submitting	Switch	wait
`--timeout <seconds>`	Maximum seconds to wait for the run	positive number	`900`
`--save <dir>`	Download the outputs into this directory	—	—
`--format <mode>`	Stdout format: full envelope, or one URL per line	`json`, `url`	`json`

Pricing

Quality	Credits per image
`low`	4
`medium`	16
`high`	47

Total = quality price × (products × models) × --count, plus 1 credit per input image for the automatic cutout.

Prices as of September 15, 2026; they may change. tufty tools describe flat-to-3d always shows the current ones, and --dry-run prints the exact estimate. See Credits.

Examples

One flat-lay dress, high quality, portrait

tufty flat-to-3d --product ./flatlay-dress.jpg --quality high --ratio 3:4

A tee shot front and back as one product, plus two more garments, saved locally

tufty flat-to-3d --product ./tee-front.jpg+./tee-back.jpg ./jeans.jpg ./jacket.jpg --save ./out

Output example

{
  "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"
      }
    ]
  }
}

With --save <dir> each output also has path; with --no-wait, status is running and outputs is empty. See Output modes.

Tips

Shoot the garment flat on a plain background, fully visible and not folded.
Front and back shots of the same garment belong in one product: join them with +.

On this page