mcpField
M
meitu-beauty

meitu-beauty

github.com/meituクリエイティブ・メディア36150 回インストール9 週間前に更新
リポジトリ

meitu-beauty について

Meitu Beauty は、`meitu` CLI と `gummy_pro` モデルで一人のポートレートをレタッチするスキルです。画像の確認、自然または強めの補正、指定先への結果保存までを扱います。

主な機能

  1. 01肌と顔の細部をレタッチ
  2. 02自然または強めの補正に対応
  3. 03一人のポートレートかを確認
  4. 04結果画像1枚を出力先に保存
  5. 05CLI エラーの処理と再試行案内

活用シーン

  1. 01ポートレート写真への自然なレタッチ
  2. 02一人の写真の肌や顔の細部を補正

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/meitu/meitu-skills --skill meitu-beauty

インストール後、Claude Code で/meitu-beautyを入力して読み込まれたか確認します。

詳細

Meitu Beauty

概要

ワンクリックで AI 人像をレタッチします。肌をなめらかにし、肌色を明るくして、顔の細部を最適化します。meitu image-edit --model gummy_pro を使用して写実的な人像の修整を行います。単独の人物が写った写真のみ対応しています。

実行前に、この Skill が Meitu の認証情報を読み取り、ローカルの meitu CLI を呼び出し、ユーザーから提供された人物写真と生成プロンプトを Meitu OpenAPI に送信して処理し、結果を ./output/ または $VISUAL/output/meitu-beauty/ に書き込むことをユーザーに明確に伝えてください。人物写真は外見に関する機微な個人データであるため、処理する写真の使用および処理に関する許可をユーザーが得ていることを確認してください。

依存関係

  • meitu-cli ≥ 2.0.6 — 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. モードを検出します。cwd に openclaw.yaml がある場合は project mode、ない場合は one-off です。
    $VISUAL ディレクトリを確認し、capabilities を特定します。
  4. output_dir の解決（事前確認中に MUST 完了）： output_dir を解決します。openclaw.yaml → ./output/ | それ以外 → $VISUAL/output/meitu-beauty/ mkdir -p {output_dir}
実行

入力の取得

ユーザーから画像を提供してもらいます。次の形式に対応しています。

  • ローカルファイルパス → --image_list <path> を使用します。
  • 画像 URL → --image_list <url> を使用します。
  • 会話中に直接送信された画像 → 一時ファイルに保存してから --image_list <path> を使用します。

ユーザーが画像を提供していない場合は、「美顔処理を行う人物写真を提供してください（ファイルパスまたは URL）。」と尋ねてください。

人物写真の確認（重要な前提手順）

このツールは、単独の人物が写った写真のみ対応しています。呼び出す前に MUST 確認してください。

  1. ユーザーが提供した画像を読み込み、目視で確認します。

    • 顔が写っているか → 顔が写っていない場合は拒否します。「この画像には人物の顔が検出されませんでした。美顔ツールは顔が写った写真のみ対応しています。」
    • 1 人だけが写っているか → 複数人の場合は拒否します。「複数人が検出されました。美顔ツールは 1 人だけが写った写真のみ対応しています。1 人だけになるように切り抜いてから、再試行してください。」
    • 顔が十分に大きく、鮮明か → 顔が小さすぎる／ぼやけている場合は、警告します。「顔が小さい／ぼやけているため、美顔効果がはっきり現れない可能性があります。続行しますか？」

  2. 事前に判断できない場合（URL をプレビューできない場合など）は、ツールを直接呼び出し、返されたエラーに応じて対応します。

強度の選択

ユーザーの意図prompt に追加する文説明
「自然な美顔」、「軽く調整」、「少しきれいにする」、強度の指定なしnatural portrait retouch, keep facial structure unchanged自然な仕上がり（デフォルト）
「しっかり美顔」、「強めの肌補正」、「効果を強めに」、「思い切り美顔」strong but realistic skin smoothing, brighter complexion, keep facial structure unchanged強めの仕上がり

呼び出しコマンド

meitu image-edit \
  --skill_name skill_meitu-beauty \
  --image_list <url_or_path> \
  --prompt "<beauty_instruction>" \
  --model gummy_pro \
  --json \
  --download-dir {output_dir}

注意：2.0.6 では image-beauty-enhance は廃止されています。人物の美顔、肌質の最適化、細部の修整は、すべて image-edit --model gummy_pro で行います。

結果の処理

  • ok: true → --download-dir が指定されている場合は、downloaded_files[0].saved_path からローカルファイルのパスを取得します。--download-dir を使用していない場合は、media_urls[0] から結果画像の URL を取得します。
  • ok: false → エラー時のフォールバックに進みます。

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

まず、CLI の元のエラーフィールド code、hint、error_name、action_url を確認し、その後 meitu-tools のルールに従って error_type に分類して振り分けます。

error_type（CLI の元のフィールドから分類）対応再試行可能
CONTENT_REQUIREMENTS_UNMET（または CLI の元のエラー code=98501 / error_name=CONTENT_REQUIREMENTS_UNMET）画像に顔が写っていないか、単独の人物という要件を満たしていません。ユーザーに「この画像は美顔処理の要件を満たしていません（人物 1 人だけが写った写真が必要です）。別の画像に差し替えてください。」と直接伝えます。再試行しません。いいえ
ORDER_REQUIRED残高不足です。チャージを案内し、action_url を表示します。いいえ
CREDENTIALS_MISSINGAK/SK の設定を案内します。いいえ
その他のエラー以下のレベルに従ってフォールバックします ↓状況による

一般的なフォールバック（retryable: true または不明なエラーの場合のみ）：

レベル方針操作
L1強度を下げる強めの修整用 prompt を natural portrait retouch, keep facial structure unchanged に変更して再試行します。
L2画像の品質を確認より鮮明で、顔が大きく写った写真に差し替えるようユーザーに案内します。
L3画像形式を確認JPG/PNG/WEBP であることを確認します。GIF/BMP などの非対応形式は使用できません。
L4エラーを報告して停止連続 2 回失敗した場合は、code + hint を報告して再試行を停止します。
出力

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

mv {file} {output_dir}/{date}_beauty_{original_name}.{ext}

命名例：2026-03-23_beauty_portrait.jpg

出力

項目仕様
形式元画像と同じ（通常は JPG）
数量1 枚
命名{date}_beauty_{original_name}.{ext}
場所Deliver の手順で解決

コメント

Markdown 対応