mcpField
M
meitu-upscale

meitu-upscale

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

meitu-upscale について

meitu-upscaleは、meitu-cliで画像の解像度と鮮明さを高めるスキルです。画像内容の説明に応じて超解像の処理経路を選び、画面の内容は変更しません。

主な機能

  1. 01解像度と鮮明さの向上
  2. 02ノイズと圧縮アーティファクトの低減
  3. 03内容説明に基づく処理経路の選択
  4. 04画像内容の保持

活用シーン

  1. 01低解像度のポートレート写真の補正
  2. 02商品画像の鮮明さの向上
  3. 03文字画像やUIスクリーンショットの視認性改善

インストール

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

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

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

詳細

Meitu Upscale

概要

ワンクリックで画像を超解像化します。解像度と鮮明さを向上させ、ノイズや圧縮アーティファクトを除去します。meitu image-superres-enhance を呼び出し、内容の説明に基づいて CLI が最適な超解像パスを自動で選択します。

依存関係

  • 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 がある場合はプロジェクトモード、ない場合は単発モードです $VISUAL ディレクトリを確認して、利用可能な機能を特定します
  4. output_dir の解決（事前確認内で必ず完了）： output_dir を解決します：openclaw.yaml → ./output/ | それ以外 → $VISUAL/output/meitu-upscale/ mkdir -p {output_dir}
実行

入力の取得

ユーザーから画像を受け取ります。以下の形式に対応しています：

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

ユーザーが画像を提供していない場合は、「超解像化する画像（ファイルパスまたは URL）を指定してください。」と尋ねます。

内容の説明を選択

画像の主な内容に基づいて --prompt を作成し、image-superres-enhance が適切な超解像パスを選択できるようにします：

主な内容--prompt の例判断基準
人物が中心portrait photo顔が視覚的な焦点（証明写真、自撮り、人物のクローズアップ）
商品・物品e-commerce product image商品、食品、実物のクローズアップ、商業写真
図形・スクリーンショットtext document or UI screenshotUI スクリーンショット、文字画像、イラスト、アイコン、デザイン案
不明general image明確に分類できない場合の既定の説明

選択方法：

  • ユーザーが主な内容を明示している場合 → 上の表に従って説明を選択します
  • ユーザーが説明していない場合 → Read ツールで画像を読み込み、目視で主な内容を判断します
  • 判断できない場合（URL をプレビューできない場合など）→ general image を使用します

コマンドの呼び出し

meitu image-superres-enhance \
  --skill_name skill_meitu-upscale \
  --image_url <url_or_path> \
  --prompt "<content_description>" \
  --json \
  --download-dir {output_dir}

注意: このコマンドは鮮明さの向上と目標解像度への拡大を目的としており、旧版の model_type には対応していません。ユーザーが 2x/4x/8x の等比による幾何学的な拡大を希望する場合は、image-transform を使用してください。

結果の処理

  • ok: true → downloaded_files[0].saved_path からローカルファイルのパスを取得し、Deliver に進みます
  • ok: false → エラー時のフォールバックに進みます

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

レベル方針操作
L1内容の説明を簡略化text document or UI screenshot / e-commerce product image などの具体的な説明で失敗した場合は、general image に切り替えます
L2画像の形式・内容を確認JPG/PNG/WEBP であることを確認します。GIF/BMP/SVG などの非対応形式は使用できません。INVALID_RESOURCES (10025) はコンテンツ審査による拒否の可能性もあります → ユーザーに「画像がコンテンツ審査に通過しませんでした。別の画像をお試しください」と伝えます
L3画像の取得元を確認URL にアクセスできない場合は /tmp/meitu-upscale-input.{ext} にダウンロードしてから、ローカルパスで再試行します
L4認証情報・残高の問題ORDER_REQUIRED → チャージするよう案内し、action_url を表示します
L5エラーを報告して停止2 回連続で失敗した場合は code + hint を報告し、再試行を停止します

一時ファイルの処理が完了したら、rm -f /tmp/meitu-upscale-input.* で削除します。

Deliver

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

mv {path} {output_dir}/{date}_upscale.{ext}

拡張子: {ext} は downloaded_files[0].saved_path の実際の拡張子から取得します（サーバーから .jpg ではなく .jpeg が返されることがあります）。.jpeg → .jpg のように、すべて .jpg に統一します。

命名例：2026-03-23_upscale.jpg、2026-03-23_upscale_portrait.png

出力

項目仕様
形式元画像と同じ（JPG→JPG、PNG→PNG、WEBP→WEBP）
数量1 枚
命名{date}_upscale[_{context}].{ext}
場所Deliver 手順で解決

対応範囲

このスキルは超解像化のみを行います。解像度と鮮明さを向上させ、画像の内容は変更しません。

対応しない処理引き継ぎ先
美顔・肌のなめらか処理meitu-beauty
透かし・通行人の除去、画像の修復meitu-image-fix
スタイル変換image-style-transfer（または meitu-tools から直接呼び出し）
背景の除去meitu-cutout
総合的な画像編集（ぼかし＋透かし＋美顔）meitu-image-fix（パイプライン内で upscale を自動的に呼び出します）

コメント

Markdown 対応