用途:调用 meitu image-cutout 从图片中分离前景主体,输出透明背景 PNG,适用于人物去背景、商品抠图、图标或印章提取等场景,仅支持人物、宠物、商品、图标、印章五类主体,白底隔离和其他主体类型不支持。
依赖:需安装 meitu-cli,命令为 npm install -g meitu-cli@latest。凭证优先通过环境变量 MEITU_OPENAPI_ACCESS_KEY / MEITU_OPENAPI_SECRET_KEY,或预置 ~/.meitu/credentials.json 提供;仅在用户明确要求写入本地凭证时,再执行 meitu config set-ak 与 meitu config set-sk。
主要能力:可按主体选择模型——人像用 model_type 0,商品用 1,设计素材、图标、印章用 2,宠物或类型不确定时省略该参数由服务端自动选择;也可对目录做批量处理,批处理默认并发数为 3,输出 PNG。
使用方式:先做预检,运行 meitu --version 与 meitu auth verify --json,并解析输出目录(项目模式为 ./output/,否则为 $VISUAL/output/meitu-cutout/)。单张抠图命令为 meitu image-cutout --image_url {image_url_or_path} --json --download-dir {output_dir} --skill_name skill_meitu-cutout,明确指定模型时追加 --model_type 0/1/2。批量命令为 meitu batch image-cutout --input-dir {input_dir} --output-dir {output_dir} --skill_name skill_meitu-cutout,整批固定模型时追加 --model-type。注意单次命令不支持 --image_list,输入参数只接 --image_url(别名 --image)。
结果处理:解析 --json 输出,ok 为 true 时 downloaded_files[0].saved_path 为已下载结果,未使用 --download-dir 则取 media_urls[0];ok 为 false 时检查 code 与 hint。失败时先调整模型选择,再检查图片格式或大小,连续两次失败则停止并报错;ORDER_REQUIRED 提示充值并展示 action_url,CREDENTIALS_MISSING 提示配置 AK/SK。非五类主体或白底隔离直接返回不支持,不应调用或重试。
输出与限制:输出为透明背景 PNG,命名格式如 2026-03-23_product-photo_cutout.png。建筑、植物、车辆、食物、家具等非五类主体以及白底隔离不受支持,需要白底时应改用 image-edit。