image-cutout

name	image-cutout
description	图片前景主体与背景精准分离，仅支持人物、宠物、商品、图标、印章五类主体并输出透明底 PNG。用户明确要求抠图、去背景、透明背景/透明底或提取上述主体时触发；非五类主体和白底隔离不支持。
version	1.0.0
metadata	{"openclaw":{"requires":{"bins":"[Truncated]","env":"[Truncated]","paths":"[Truncated]"},"primaryEnv":"MEITU_OPENAPI_ACCESS_KEY","security":{"dataFlow":"Input images and optional model_type values are sent to Meitu OpenAPI when used by the workflow.","credentials":"Credentials are used only for CLI authentication and must not be disclosed."}}}
security	{"credential_use":"Uses Meitu OpenAPI credentials from env or ~/.meitu/credentials.json for CLI calls; credentials must not be echoed, logged, or placed in user-controlled parameters.","remote_processing":"Input images and optional model_type values are sent to Meitu OpenAPI.","persistence":"Generated cutout images are written to the resolved output directory."}
requirements	{"credentials":[{"name":"MEITU_OPENAPI_ACCESS_KEY","source":"env | ~/.meitu/credentials.json"},{"name":"MEITU_OPENAPI_SECRET_KEY","source":"env | ~/.meitu/credentials.json"}],"env":{"MEITU_OPENAPI_TOOL_TASK_MODE":"command"},"permissions":[{"type":"file_read","paths":"[Truncated]"},{"type":"file_write","paths":"[Truncated]"},{"type":"exec","commands":"[Truncated]"}]}

图片抠图（image-cutout）

Overview

对已有图片做前景主体与背景的精准分离。仅人物、宠物、商品、图标、印章五类主体可调用 SOD，并输出透明底 PNG；非五类主体和白底隔离不调用替代 API。

DAG / API Mapping

• DAG 路由定位：这是 dag_existing_tool_routes 中的现有 Meitu 工具路由，不是新建的 dag_native 命令；参数与执行契约以 tools[].cli 为准。
• CLI 入口：meitu image-cutout；image_url 必填，model_type 可选。
• MCP 入口：image_cutout，api_path=/v1/hydra_async，api_task_type=mtlab。
• MCP 对外参数：image_url 必填；model_type 可选（0=人像、1=商品、2=图形），不传由模型自动判断。
• MCP 内部固定请求：request_payload.parameter.api_path=/v1/sod_2c_async、function_path=image-cutout、use_fe_rgba=true。use_fe_rgba 不是用户参数，不得暴露为 CLI 选项或要求用户提供。
• CLI 与 MCP 的用户参数保持一致；prompt、target_subject、exclude_subjects 均不是对外参数。

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 画面识别的主体类型。

场景	判定关键词	路由