用途:对已有图片做整体背景替换/换场景,保留前景主体不变。覆盖商品换场景、人像换背景、宠物换场景、电商白底图、证件照换底色(白/蓝/红)以及按文字描述生成任意目标场景。触发说法包括换背景、替换背景、换成 xx 背景、商品换场景、人像换背景、证件照换底色、换底。不能输出透明背景,也不支持视频换背景。
主要能力:通过单一 API 完成整体背景替换,对应 image_gummy_generate_v45;支持默认白底与自定义背景描述。
使用方式:依赖 meitu-cli >= 2.0.6(npm install -g meitu-cli@latest),需配置 AKSK(CONFIG AKSK 用于 meitu tools update,EXEC AKSK 用于实际执行),并设置环境变量 MEITU_OPENAPI_TOOL_TASK_MODE=command。输出目录:存在 openclaw.yaml 时为 ./output/,否则为 $VISUAL/output/image-background-replace/,需先 mkdir -p。
调用命令: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 必填,缺失则提示提供图片;prompt 必填,未指定时默认“白色背景”并告知可描述具体场景。
输出:PNG(非透明),命名为 {YYYY-MM-DD}_{descriptive}_image-background-replace.png,路径读取 downloaded_files[0].saved_path 后移动至输出目录。
限制与错误处理:prompt 含“透明/透明底/透明背景”时不调用本工具,提示走抠图;image_url 不可访问直接报错不重试;未检测到前景主体报错不重试;API 调用失败重试 1 次仍失败则返回错误,不做跨工具兜底;内容合规拦截直接返回提示;背景与前景不协调时建议调整 prompt 后重试。收费、价格与平台信息暂未提供。