meitu-cutout

Meitu Cutout

概要

meitu image-cutout を呼び出して、画像から前景の被写体を切り抜き、透明背景の PNG を出力します。人物、ペット、商品、アイコン、印章の 5 種類の被写体のみ対応しています。人物、商品、グラフィックの 3 種類のモデルを選択できます。モデルパラメーターを省略すると、自動検出されます。

依存関係

• meitu-cli: npm install -g meitu-cli@latest
• 認証情報: MEITU_OPENAPI_ACCESS_KEY / MEITU_OPENAPI_SECRET_KEY 環境変数を優先するか、~/.meitu/credentials.json を事前に設定します。ユーザーがローカル認証情報への書き込みを明示的に求めた場合に限り、meitu config set-ak --value "..." / meitu config set-sk --value "..." を実行します

パスの別名： 以下では、$VISUAL = {OPENCLAW_HOME}/workspace/visual/ とします

基本的なワークフロー

Preflight → [Context: 跳过（工具型抠图，无创意自由度）] → Execute → Deliver

事前確認

1. meitu --version → インストールされていない場合は npm install -g meitu-cli@latest を案内します
2. meitu auth verify --json → 認証情報が無効な場合は、設定を案内します
3. モードを検出します：カレントディレクトリに openclaw.yaml がある場合はプロジェクトモード、ない場合は単発モードです $VISUAL ディレクトリを確認し、機能を判定します
4. output_dir の解決（事前確認中に必ず完了してください）： output_dir を解決します：openclaw.yaml がある場合は ./output/、それ以外は $VISUAL/output/meitu-cutout/ mkdir -p {output_dir}

実行

入力の解析

ユーザーは画像を指定します。次の 2 種類の形式に対応しています。

• ローカルファイルパス（例：./photo.jpg）
• 画像 URL（例：https://example.com/photo.jpg）

ユーザーが画像を指定せずに「画像を切り抜いて」とだけ依頼した場合は、「切り抜く画像を指定してください（ローカルパスまたは URL）」と尋ねます。

モデルの選択

画像の被写体	model_type	出力
人物、証明写真、上半身の写真	0	透明背景 PNG。髪の毛の細部を保持
商品、製品、EC 用画像	1	透明背景 PNG。製品の輪郭を最適化
デザイン素材、アイコン、印章	2	透明背景 PNG
ペット、または種類が不明な被写体	省略	サーバー側でモデルを自動選択し、透明背景 PNG を出力

model_type に指定できる値は 0、1、2 のみです。建物、植物、車両、食品、家具など、5 種類以外の被写体や白背景への切り抜きには対応していません。prompt や代替 API を使用して制限を回避してはいけません。白背景が必要な場合は image-edit を使用してください。

ツール呼び出し

単一画像の切り抜き：

meitu image-cutout --image_url {image_url_or_path} --json --download-dir {output_dir} --skill_name skill_meitu-cutout

モデルを明示的に指定する場合は、--model_type 0、--model_type 1、または --model_type 2 を追加します。省略した場合は、モデルが自動選択されます。

一括処理

ディレクトリ全体を一括処理します：

meitu batch image-cutout --input-dir {input_dir} --output-dir {output_dir} --skill_name skill_meitu-cutout

バッチ全体で固定モデルを使用する場合は、--model-type 0、--model-type 1、または --model-type 2 を追加します。項目ごとに指定する場合は、JSON/YAML 設定を使用し、項目のフィールド modelType（model_type にも対応）を単一コマンドの model_type に対応付けます。一括処理のデフォルトの並列数は 3 で、出力形式は .png です。

注意：単一コマンドでは --image_list はサポートされていません。入力パラメーターには --image_url（別名 --image）のみ使用できます。

結果の確認

--json の出力を解析します。

• ok: true → 成功です。downloaded_files[0].saved_path は、ローカルにダウンロード済みの結果 PNG（透明背景）のパスです。--download-dir を使用していない場合は、media_urls[0] を使用します
• ok: false → code と hint を確認します

エラー時のフォールバック

レベル	アクション	説明
L1	モデル選択を調整	自動検出が不正確な場合は、被写体に応じて --model_type 0、1、または 2 に変更します
L2	画像形式とサイズを確認	画像にアクセスでき、破損していないことを確認します
L3	停止してエラーを報告	2 回連続で失敗した場合は、code と hint を出力します

5 種類以外の被写体や白背景への切り抜きの場合は、非対応であることを直接返します。呼び出しや再試行は行いません。

特別なエラー：

• ORDER_REQUIRED → ユーザーにチャージを案内し、action_url を表示します
• CREDENTIALS_MISSING → AK/SK の設定を案内します

出力先への配置

事前確認で解決した output_dir をそのまま使用します。

mv {file} {output_dir}/{date}_{name}_cutout.png

出力

• 形式: PNG（透明背景）
• ファイル名: {YYYY-MM-DD}_{descriptive-name}_cutout.png
  • 例：2026-03-23_product-photo_cutout.png
• 場所: Deliver の手順に従って決定します（プロジェクト → ./output/、単発 → $VISUAL/output/meitu-cutout/）