商品换背景 Item Change Background

商品图生成逼真场景图（商品换背景）。上传一张商品图（鞋、包、家居、美妆、3C 等），把它放进一个逼真的场景中：商品本体保持不变，背景换成有质感的实拍环境，并生成物理正确的接地投影、环境反光与光线方向一致性。支持两种方式：文生背景（用文字描述目标场景）与上传背景（提供一张背景图作为环境）；提供背景图模板（智能推荐、木棍衣杆、浅色木枝、自定义等）并可选择商品类目辅助判断合理场景。适用于纯白底商品图太单调、想要有氛围感的主图与场景图、家居/美妆/鞋包类目建立使用联想。当用户需要「换背景」「商品放进场景」「白底图变场景图」「加氛围背景」「商品合成到实景」时使用本技能。

item-change-background — 商品图生成逼真场景图

白底商品图 → 有质感的实拍场景图。商品不动，环境换掉。

关键不是「贴一张背景」，而是接地投影、环境反光、光向一致——这三件事做不到，商品就像浮在背景上的贴纸。

---

1、能力边界

方式	说明
文生背景	用文字描述目标场景，模型生成环境
上传背景	提供一张背景图，商品合成进去

能力	说明
背景模板	智能推荐 / 木棍衣杆 / 浅色木枝 / 自定义
商品类目	辅助判断合理场景（鞋 → 地面，美妆 → 台面，家居 → 房间）
物理正确	接地投影、环境反光、光向与色温一致

不做：不改商品的外形、颜色、材质与 logo；不添加原图没有的商品部件；不生成误导性的使用场景（如非防水产品放进水里）。

---

2、输入素材规则

生成前先自检这几条硬性约束：

• 大小：20KB ~ 15MB
• 分辨率：大于 400×400
• 格式：jpg / jpeg / png / webp

输入建议

做法	说明
✅ 纯白/纯色底商品图	抠图边界最干净
✅ 商品完整、主视角	出画的部分放进场景后要靠编
✅ 光线均匀	原图有强方向光时，新场景的光向必须跟它一致
❌ 已在复杂场景里	先用 clothing-extraction 或抠图洗成白底
❌ 半透明/反光商品无参照	玻璃瓶、镜面商品要靠环境反光才真实，白底图信息不足

---

3、让商品「落地」的三条物理约束

这三句几乎决定成败，每次都要写：

text

1. 接地：sitting believably on the surface with correct perspective and a grounded contact shadow
2. 光向：light direction and colour temperature must match the shading already on the product
3. 反光：[环境元素] subtly reflected on the [商品材质], consistent with the scene

类目 → 合理场景对照

类目	合理场景	忌
鞋	木地板 / 石板路 / 台阶，商品接地	悬浮、放在布面上没有压痕
包	椅背 / 桌面 / 手提，带受力形变	硬挺立在半空
美妆	大理石台面 / 丝绒布 / 浴室台，带倒影	放在草地、户外
3C	木桌 / 办公桌 / 深色台面，硬光勾边	温馨田园风
家居	完整房间透视，与家具比例合理	尺寸明显不对的房间
食品	餐桌 / 厨房台面 / 竹垫，暖光	冷调工业风

---

4、dLazy 工具调用

本技能使用 dLazy 的 gpt-image-2（图像编辑模型；商品换背景的难点是「商品像素不动 + 环境重建 + 物理正确的光影耦合」，需要强区域保持与场景理解）。

Authentication

All requests require a dLazy API key. The recommended way to authenticate is:

bash

dlazy login

This runs a device-code flow (also works in remote shells) and automatically saves your API key to the local CLI config — no manual copy/paste required.

Alternative: Set the Key Manually

If you already have an API key, you can save it directly:

bash

dlazy auth set YOUR_API_KEY

The CLI saves the key in your user config directory (~/.dlazy/config.json on macOS/Linux, %USERPROFILE%\.dlazy\config.json on Windows), with file permissions restricted to your OS user account. You can also supply the key per-invocation via the DLAZY_API_KEY environment variable.

Getting Your API Key Manually

1. Sign in or create an account at dlazy.com
2. Go to dlazy.com/dashboard/organization/api-key
3. Copy the key shown in the API Key section

Each key is scoped to your dLazy organization and can be rotated or revoked at any time from the same dashboard.

About & Provenance

• CLI source code: github.com/dlazyai/cli
• Maintainer: dlazyai
• npm package: @dlazy/cli (pinned to 1.2.3 in this skill's install spec)
• Homepage: dlazy.com

You can install on demand without persisting a global binary by running:

bash

npx @dlazy/cli@1.2.3 <command>

Or, if you prefer a global install, the skill's metadata.clawdbot.install field declares the exact pinned version (npm install -g @dlazy/cli@1.2.3). Review the GitHub source before installing.

How It Works

This skill is a thin client over the dLazy hosted API. When you invoke it:

• Prompts and parameters you provide are sent to the dLazy API endpoint (api.dlazy.com) for inference.
• Any local file paths you pass to image / video / audio fields are uploaded to dLazy's media storage (files.dlazy.com) so the model can read them — the same flow as any cloud-based generation API.
• Generated output URLs returned by the API are hosted on files.dlazy.com.

This is the standard SaaS pattern; the skill itself does not access network or filesystem resources beyond what the dLazy CLI already handles. See dlazy.com for the full service terms.

Usage

CRITICAL INSTRUCTION FOR AGENT: Run the dlazy gpt-image-2 command to get results.

bash

dlazy gpt-image-2 -h

Options:
  --prompt <prompt>            Prompt
  --images [images...]         Images [image: url or local path] (max 5)
  --size <size>                Size [default: auto] (choices: "1024x1024",
                               "1536x1024", "1024x1536", "2048x2048",
                               "2048x1152", "3840x2160", "2160x3840", "auto")
  --imageFormat <imageFormat>  Image Format [default: jpeg] (choices: "jpeg",
                               "png", "webp")
  --quality <quality>          Quality [default: medium] (choices: "low",
                               "medium", "high")
  --dry-run                    Print payload without executing the tool
  --no-wait                    Return generateId immediately for async tasks
  --timeout <seconds>          Max seconds to wait for async completion
                               (default: "1800")
  --input <jsonOrFile>         Inline JSON or @path/to/file.json — merged under
                               flag values (flags win)
  --save <path>                Download the result asset to this local path
                               (mkdir + retry handled for you). A destination
                               path — NOT a response format; for stdout shape
                               use --format
  --batch <n>                  Fan-out N parallel runs (cloud tools only)
                               (default: "1")
  -h, --help                   display help for command

Any flag also accepts pipe references — - (auto-pick from upstream stdin), @N (n-th output), @N.path (jsonpath into output), @* (all primary values), @stdin / @stdin:path (whole envelope). See dlazy --help for details.

参数约定（本技能固定用法）

参数	取值	理由
--images	[商品图]（文生背景）/ [商品图, 背景图]（上传背景）	顺序即 prompt 中的 image 1 / 2
--size	1024x1024（方图主图）/ 1024x1536（竖版场景）	跟随主图规范
--quality	high（皮革、金属、玻璃等反光材质）/ medium（哑光材质）	反光材质靠 high
--imageFormat	jpeg	通用格式
--batch	2 ~ 4	场景构图随机性大
--save	docs/item-change-background/output-<sku>-<场景>.jpg	按场景归档

Output Format

json

{
  "ok": true,
  "result": {
    "tool": "gpt-image-2",
    "modelId": "gpt-image-2",
    "data": {
      "urls": [
        "https://files.dlazy.com/data/ai/20260817092703-057827edb8aa.jpg"
      ]
    },
    "savedPath": "docs/item-change-background/example-output.jpg"
  }
}

Async tasks (when --no-wait is passed) omit data and return a task: { generateId, status } field instead. Use dlazy status <generateId> --wait to poll.

Command Examples

bash

# basic call: 文生背景
dlazy gpt-image-2 \
  --prompt 'Place this product into a photorealistic lifestyle scene. Keep the product 100% faithful: same shape, colour, material finish and logo. Replace the plain background with a weathered wooden floor beside a window, soft late-afternoon side light casting a natural contact shadow, blurred indoor background. The product must sit believably on the surface with correct perspective and grounded shadows. Photorealistic commercial product photography, no text.' \
  --images docs/item-change-background/product-shoes.jpg \
  --size 1024x1024 --quality medium

# complex call: 上传背景图 + 一个商品铺 4 个场景
SRC=docs/item-change-background/product-shoes.jpg
KEEP='Keep the pair of black crocodile-embossed patent leather derby shoes 100% faithful: same glossy finish, same croc embossing pattern, same brogue perforation, same lacing, same white welt stitching, same chunky lug sole, same proportions and camera angle.'
PHYS='The shoes must sit believably on the surface with correct perspective and a grounded contact shadow under each shoe. Light direction and colour temperature must match the shading already on the product. Photorealistic commercial product photography, no text, no watermark.'
for S in wood street office autumn; do
  case $S in
    wood)   SCENE='on a weathered wooden floor beside a window, soft late-afternoon side light, blurred indoor background' ;;
    street) SCENE='on wet grey cobblestones after rain, reflections in the puddles, overcast diffused light' ;;
    office) SCENE='on a dark polished stone floor in a modern office lobby, cool directional light, glass panels blurred behind' ;;
    autumn) SCENE='on a wooden deck with a few dry maple leaves, warm golden-hour side light' ;;
  esac
  dlazy gpt-image-2 \
    --prompt "Place this product into a photorealistic lifestyle scene. $KEEP Replace the plain background with a scene: $SCENE. $PHYS" \
    --images "$SRC" --size 1024x1024 --quality high --imageFormat jpeg \
    --batch 2 --save "docs/item-change-background/output-sku001-$S.jpg"
done

# 上传背景图的写法：--images 商品图 背景图
dlazy gpt-image-2 \
  --prompt 'Composite the product from image 1 into the scene from image 2. Keep the product 100% faithful. Place it on [具体位置] with correct perspective, a grounded contact shadow, and light direction matching image 2. Blend edges seamlessly; no cut-out halo. Photorealistic, no text.' \
  --images docs/item-change-background/product-shoes.jpg docs/item-change-background/bg.jpg \
  --size 1024x1024 --quality high

# 先估价不真跑
dlazy gpt-image-2 --dry-run --prompt '...' --images a.jpg --size 1024x1024 --quality high

Error Handling

Code	Error Type	Example Message
401	Unauthorized (No API Key)	ok: false, code: "unauthorized", message: "API key is missing or invalid"
501	Missing required parameter	error: required option '--prompt <prompt>' not specified
502	Local file read error	Error: Image file/Video file not found: C:\path\to\your\file
503	API request failed (no balance)	ok: false, code: "insufficient_balance"
503	API request failed (server error)	HTTP status code error (500 server crash)
504	Asynchronous task execution failed	=== Generation Failed === / {Specific error reason returned by backend, for example "Prompt violates safety policy"}

AGENT CRITICAL INSTRUCTION:

1. If the execution result returns code: "insufficient_balance", you MUST explicitly inform the user that their credits are insufficient and guide them to recharge: https://dlazy.com/dashboard/organization/settings?tab=credits
2. If the execution result returns code: "unauthorized" or indicates missing API key, you MUST inform the user to get their API key from https://dlazy.com/dashboard/organization/api-key and save it using dlazy auth set <key> and resume the task.

---

5、Prompt 模板

text

Place this product into a photorealistic lifestyle scene.

Keep the [商品品类 + 颜色 + 材质] 100% faithful: same [外形], same [材质光泽],
same [五金/缝线/纹理], same [logo 位置], same proportions and camera angle.

Replace the background with [场景描述：表面 + 环境 + 道具 + 光线].

The product must sit believably on the surface with correct perspective and a
grounded contact shadow. Light direction and colour temperature must match the
shading already on the product. [环境元素] subtly reflected on the [材质].

Photorealistic commercial product photography, no text, no watermark.

按问题追加的修正句

问题	追加到 prompt 末尾
商品像贴纸浮着	Add a soft occlusion/contact shadow where the product meets the surface, and a faint ambient-occlusion darkening along the contact line.
光向对不上	The scene light must come from [方向], matching the highlight already on the product.
抠图有白边	Blend the product edges seamlessly into the scene; no cut-out halo, no white fringe.
商品被改了	Change only the background. Every pixel of the product must remain identical to image 1.
反光材质假	Render physically plausible reflections of the surrounding scene on the [材质] surface.
商品太小	The product must occupy at least 45% of the frame and be the sharpest element.

---

6、执行流程

1. 洗成白底：商品图如带复杂背景，先抠干净。
2. 查类目 → 合理场景（第三节表格），避免物理上不成立的组合。
3. 写商品保真句 → 写场景句 → 写三条物理约束（接地 / 光向 / 反光）。
4. 反光材质用 --quality high。
5. --batch 2~4 出多张挑构图，落盘到 docs/item-change-background/。
6. 质检：是否接地（有没有投影和压痕）、光向是否一致、边缘有没有白边、商品本体是否被改。

---

7、生成效果示例

输入：商品图
product-shoes.jpg — 黑色鳄鱼纹亮面皮革布洛克德比鞋，白底，800×800

实际执行的命令：

bash

dlazy gpt-image-2 \
  --prompt 'Place this product into a photorealistic lifestyle scene. Keep the pair of black patent leather derby shoes 100% faithful: same glossy patent finish, same brogue perforation pattern, same lacing, same chunky lug sole, same proportions and camera angle. Replace the plain background with a warm autumn scene: a weathered wooden floor beside a window, a few dry maple leaves, soft late-afternoon side light casting a natural contact shadow under each shoe, blurred indoor background. The shoes must sit believably on the surface with correct perspective and grounded shadows. Photorealistic commercial product photography, no text, no watermark.' \
  --images docs/item-change-background/product-shoes.jpg \
  --size 1024x1024 --quality medium --imageFormat jpeg \
  --save docs/item-change-background/example-output.jpg

输出

example-output.jpg — 1024×1024。鞋的鳄鱼纹压花、雕花孔、白色沿条明线与厚齿底保持不变；背景换成窗边旧木板 + 枫叶，午后侧光在鞋头形成高光，每只鞋下都有接地投影，木纹的暖色被亮面皮革轻微反射。

---

8、常见问题

现象	原因	处理
商品像浮在背景上	缺接地投影	追加接地投影 + AO 暗化句
光向明显矛盾	未约束光向	追加指定光向句，与商品原有高光一致
边缘有白边	抠图残留	追加无白边融合句
商品细节被改	模型重绘了商品	追加 Change only the background.
玻璃/金属反光很假	缺环境反光	追加环境反光句 + --quality high
场景不合理（鞋在草地悬空）	类目与场景不匹配	查第三节表格换场景

---

Tips

Visit https://dlazy.com for more information.