# Image Cutout

> 图片前景主体与背景精准分离，输出透明底 PNG（标准四类：人物、宠物、商品、图形印章）或白底图（非标准主体或用户明确要白底）。仅在用户明确要求抠图、去背景、透明背景/透明底、提取主体，或明确要求把已有图片抠成白底时触发。执行时会使用本地 meitu CLI、Meitu OpenAPI 凭证并写入本地输出目录。

- **Type:** Skill
- **Install:** `agentstack add skill-meitu-meitu-skills-image-cutout`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [meitu](https://agentstack.voostack.com/s/meitu)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [meitu](https://github.com/meitu)
- **Source:** https://github.com/meitu/meitu-skills/tree/main/skills/image-cutout

## Install

```sh
agentstack add skill-meitu-meitu-skills-image-cutout
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 图片抠图（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）

**工具调用**

```bash
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](https://github.com/meitu)
- **Source:** [meitu/meitu-skills](https://github.com/meitu/meitu-skills)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-meitu-meitu-skills-image-cutout
- Seller: https://agentstack.voostack.com/s/meitu
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.