Image Cutout

图片抠图（image-cutout）

Overview

对已有图片做前景主体与背景的精准分离。标准四类主体（人物/宠物/商品/图形印章）走 api_v1_sod_async 输出透明底 PNG；非标准主体（建筑/植物/车辆/食物/家具等）或用户明确要求白底的场景走 image_praline_edit_v2 输出白底图（RGB 255,255,255）。任何涉及"透明背景/透明底"的需求都归本工具。

API Mapping

• 标准四类主体抠图（透明底 PNG）：api_v1_sod_async
• 非标准主体白底抠图（主）：image_praline_edit_v2
• 非标准主体白底抠图（降级）：image_praline_edit_2
• 非标准主体白底抠图（兜底）：image_mint_edit

model 映射：auto（默认按路由）/praline_pro→v2/praline_lite→2/mint_edit→mint

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-cutout/；mkdir -p

Execute

触发信号 / 路由规则

核心判断维度：Agent 画面识别的主体类型。

| 场景 | 判定关键词 | 路由 | 输出 | |------|----------|------|------| | 标准四类主体 | 人物/宠物/商品/图形印章 | api_v1_sod_async | 透明底 PNG | | 非标准主体 | 建筑/植物/车辆/食物/家具/其他 | image_praline_edit_v2 | 白底 RGB(255,255,255) | | 用户明确要求白底 | 白底、纯白背景 | image_praline_edit_v2 | 白底 | | 主体类型无法判断 | Agent 识别失败 | api_v1_sod_async 默认 | 透明底 |

决策顺序：

1. Agent 先识别图片主体类型，生成 prompt 描述
2. 按主体类型分 2 路（并行判断，非串联降级）
3. 用户要白底 + 主体是人物 → 仍走 image_praline_edit_v2（白底优先级更高）

参数定义

| 参数 | 类型 | 必填 | 默认值 | 说明 | |------|------|------|--------|------| | image_url | STRING | 是 | -- | 图片地址。缺失 → 提示"请提供需要抠图的图片" | | prompt | STRING | 是 | -- | Agent 对图片主体的描述（如"白底商品图，主体为运动鞋"） |

image_praline_edit_v2 内部 prompt（系统自动追加，不暴露给用户）： > 结合图片分析，根据指令锁定图像主体（保持原貌不形变），将背景重置为纯白（RGB 255, 255, 255）

工具调用

meitu image-cutout \
  --skill_name skill_image-cutout \
  --image_url  \
  --prompt "" \
  --json \
  --download-dir {output_dir}

错误降级

| 场景 | 处理方式 | |------|------| | image_url 缺失 | 提示"请提供需要抠图的图片"，不调用 | | image_url 不可访问 | 返回图片链接无效错误，不重试 | | prompt 为空 | Agent 识别主体生成 prompt；无法判断默认走 api_v1_sod_async | | 未检测到前景主体（标准路径）| 返回错误，提示需包含清晰前景主体 | | api_v1_sod_async 失败 | 重试 1 次，仍失败返回错误 | | image_praline_edit_v2 失败 | 重试 1 次 → 降级 image_praline_edit_2 | | image_praline_edit_2 失败 | 降级 image_mint_edit | | image_mint_edit 失败 | 返回错误 | | 内容合规拦截 | 返回合规提示，不重试、不降级 | | 用户说"替换为透明背景" | 虽含"替换"但目标是透明 → 走本工具，不走背景替换 | | 视频输入 | 拒绝，仅支持图片 |

Deliver

• 直接使用 Preflight 解析的 output_dir
• 从 downloaded_files[0].saved_path 读取已下载文件路径
• mv {downloaded_files[0].saved_path} {output_dir}/{YYYY-MM-DD}_{descriptive}_image-cutout.png

Output

• 格式：PNG（标准四类透明底 / 非标准主体白底）
• 命名：{YYYY-MM-DD}_{descriptive}_image-cutout.png
• 位置：项目 → ./output/，一次性 → $VISUAL/output/image-cutout/

基线 Task ID

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

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: meitu
• Source: meitu/meitu-skills
• License: MIT

Install and usage instructions live in the source repository linked above.