Dress to Design
td_dress_to_designExtract the print from a garment, mockup, or outfit photo and turn it into a flat, printable 2D design saved to disk.
Instructions
Dress to Design: extract the print from a garment photo as a flat design. Modes: advanced_extraction (recommended), fine_detail, inspired_pattern, all_modes (one output per mode). 1-4 outputs. Best for: getting a flat, printable 2D design from a photo of a garment, mockup or outfit (worn by a person, on a mannequin or flat-lay). Result files are saved to disk and their paths returned.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| wait | No | Wait for the job and save the outputs (default true). false returns the task_id right after submit. | |
| image | Yes | Source image: a local file path or an http(s) URL. PNG, JPEG or WebP, up to 80 MB and 5000 px per side. | |
| model_type | No | Extraction Model: advanced_extraction (Advanced, Recommended), fine_detail (Fine Detail), inspired_pattern (Inspired), all_modes (All Modes). Required: pass the mode the user named. If the user did not name one, omit it and the tool returns the modes to show them; never choose for the user. Call describe_tool for what each option does. | |
| output_dir | No | Folder to save results in. Default: the folder of the input image (or the current directory for URL inputs). Files are never overwritten. | |
| num_outputs | No | Number of outputs (1-4, default 1). Number of Outputs. Ignored for all_modes. On a Truly Unlimited plan single modes make one image per run. | |
| estimate_only | No | Only return the credit estimate; nothing is uploaded or charged. | |
| review_settings | No | Omit it and the tool first asks whether to use the recommended settings or adjust them (unless the call already sets some). true: ask each setting one by one. false: run with the given or recommended settings without asking; pass it only after the user chose that. | |
| timeout_seconds | No | How long to wait for the job before returning its task_id (default 240). | |
| unlimited_bundle | No | Request the Unlimited bundle for this run (only has effect on Unlimited plans; the server decides). | |
| advanced_remove_work | No | Remove work (advanced_extraction only): also strip embroidery, zari, sequins and other surface work, reproducing only the base printed textile. Default false. |