mcpField
I
image-background-replace

image-background-replace

github.com/meitu创意与媒体36123 次安装9 周前更新
代码仓库

关于 image-background-replace

image-background-replace 是基于 meitu-cli 的图片换背景技能，适用于商品、人像、宠物和证件照等场景。它保留前景主体并按提示词生成新背景，但不支持透明背景或视频。

主要功能

  1. 01替换图片整体背景或场景
  2. 02保留可识别的前景主体
  3. 03支持提示词描述目标背景
  4. 04未指定时默认白色背景
  5. 05输出非透明 PNG

适用场景

  1. 01为商品图片更换展示场景
  2. 02为人像或宠物更换背景
  3. 03制作白底电商图或证件照底色

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/meitu/meitu-skills --skill image-background-replace

安装后在 Claude Code 中输入/image-background-replace确认已加载。

详细介绍

来自项目 README

图片换背景（image-background-replace）

Overview

对已有图片做整体背景替换/换场景，保留前景主体不变。覆盖商品换场景、人像换背景、宠物换场景、电商白底图、证件照换底色（白/蓝/红）、文字描述任意目标场景的 AI 生成。本工具不能输出透明背景。

API Mapping

  • 背景替换：image_gummy_generate_v45

Dependencies

  • meitu-cli: >=2.0.6（npm install -g meitu-cli@latest）
  • 凭证：CONFIG AKSK → meitu tools update；EXEC AKSK → 实际执行（见根 CONFIG.md）
  • 环境变量：MEITU_OPENAPI_TOOL_TASK_MODE=command

路径别名：$VISUAL = {OPENCLAW_HOME}/workspace/visual/

Core Workflow

Preflight → Execute → Deliver
Preflight
  1. meitu --version ≥ 2.0.6（否则 npm install -g meitu-cli@latest）
  2. 确认已跑过 meitu tools update（用 CONFIG AKSK）
  3. 当前 AKSK = EXEC，且 MEITU_OPENAPI_TOOL_TASK_MODE=command
  4. 解析 output_dir：openclaw.yaml → ./output/ ｜else → $VISUAL/output/image-background-replace/；mkdir -p
Execute

触发信号 / 路由规则

场景判定关键词路由
整体背景替换换背景、换场景、换底色、证件照换底image_gummy_generate_v45

决策顺序： 0. 前置拦截：prompt 含"透明"/"透明底"/"透明背景" → 不调用本工具，提示走抠图

  1. 参数齐全判断：image_url 缺失 → 追问；prompt 缺失 → 用默认"白色背景"
  2. 唯一路由：调用 image_gummy_generate_v45

单 API 工具：参数齐全即调用，失败重试 1 次后返回错误；不做跨工具兜底。

参数定义

参数类型必填范围默认值说明
image_urlSTRING是----图片地址。缺失 → 提示"请提供需要换背景的图片"
promptSTRING是--白色背景目标背景描述。用户未指定 → 默认"白色背景"并告知可描述具体场景

工具调用

meitu image-background-replace \
  --skill_name skill_image-background-replace \
  --image_url <image_url> \
  --prompt "<target_background_description>" \
  --json \
  --download-dir {output_dir}

错误降级

场景处理方式
image_url 缺失提示"请提供需要换背景的图片"，不调用 API
image_url 不可访问直接返回图片链接无效错误，不重试
prompt 缺失使用默认值"白色背景"
未检测到前景主体返回错误，提示需包含可识别的前景主体，不重试
image_gummy_generate_v45 调用失败重试 1 次，仍失败返回错误
内容合规拦截直接返回合规提示，不重试
生成背景与前景不协调建议用户调整 prompt 后重试
用户同时说"换背景"和"透明底"本工具不能输出透明背景，不调用
视频换背景拒绝，本工具不支持视频
Deliver
  • 直接使用 Preflight 解析的 output_dir
  • 从 downloaded_files[0].saved_path 读取已下载文件路径
  • mv {downloaded_files[0].saved_path} {output_dir}/{YYYY-MM-DD}_{descriptive}_image-background-replace.png

Output

  • 格式：PNG（非透明）
  • 命名：{YYYY-MM-DD}_{descriptive}_image-background-replace.png
  • 位置：项目 → ./output/，一次性 → $VISUAL/output/image-background-replace/

基线 Task ID

见 references/task-id-baseline.md 中对应行。

评论

支持 Markdown