Scene Swap

place a model or product photo into any new background or setting (beach, studio, street, cafe) without building a set. Use when the user wants to change or replace a photo's background, create lifestyle scene shots, or put a product in context.

Overview

Item	Value
Command	`tufty background-swap`
Type	Image
Required inputs	`--model` model image (pet, person or subject), at least 1
Optional inputs	`--product` product image
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 background-swap always shows the current ones, and --dry-run prints the exact estimate. See Credits.

Examples

Move a studio model shot to a sunset beach, portrait 3:4

tufty background-swap --model ./model-white-bg.jpg --notes "sunset beach, warm backlight" --ratio 3:4

Model and handbag together in one scene, with prompt enhancement, two variants

tufty background-swap --model ./model.jpg --product ./handbag.jpg --notes "minimal marble studio" --enhance --count 2

Output example

{
  "ok": true,
  "result": {
    "tool": "background-swap",
    "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

--notes describes the new scene: be concrete about place, light and mood.
--product is optional for this tool; add it when the product should appear together with the model.

On this page