mcpField
A
alicloud-ai-image-qwen-image-edit

alicloud-ai-image-qwen-image-edit

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

alicloud-ai-image-qwen-image-edit について

DashScope SDK 経由で Qwen Image Edit モデルに画像編集を依頼するスキルです。入力画像と任意のマスクを受け取り、標準化された編集リクエストを準備します。

主な機能

  1. 01指示に基づく画像編集
  2. 02任意のインペイントマスク
  3. 03画像 URL、パス、バイト列入力
  4. 04標準化されたリクエストの準備

活用シーン

  1. 01対象を保ったまま画像の背景を変更
  2. 02マスクを使った部分編集

インストール

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

$npx skills add https://github.com/cinience/alicloud-skills --skill alicloud-ai-image-qwen-image-edit

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
references/
sources.md
scripts/
prepare_edit_request.py

詳細

Category: provider

Model Studio Qwen Image Edit

検証

mkdir -p output/alicloud-ai-image-qwen-image-edit
python -m py_compile skills/ai/image/alicloud-ai-image-qwen-image-edit/scripts/prepare_edit_request.py && echo "py_compile_ok" > output/alicloud-ai-image-qwen-image-edit/validate.txt

合格基準：コマンドが終了コード 0 で終了し、output/alicloud-ai-image-qwen-image-edit/validate.txt が生成されます。

出力と証跡

  • 編集リクエストのペイロード、結果の URL、モデルパラメーターを output/alicloud-ai-image-qwen-image-edit/ に保存します。
  • 再現性を確保するため、リクエストとレスポンスのペアを 1 組保存します。

テキストから画像を生成する代わりに、Qwen Image Edit モデルを使用して、指示に基づく画像編集を行います。

重要なモデル名

次のいずれかのモデル文字列をそのまま使用します。

  • qwen-image-edit
  • qwen-image-edit-plus
  • qwen-image-edit-max
  • qwen-image-2.0
  • qwen-image-2.0-pro
  • qwen-image-2.0-2026-03-03
  • qwen-image-2.0-pro-2026-03-03
  • qwen-image-edit-plus-2025-12-15
  • qwen-image-edit-max-2026-01-16

前提条件

  • 仮想環境に SDK をインストールします。
python3 -m venv .venv
. .venv/bin/activate
python -m pip install dashscope
  • 環境に DASHSCOPE_API_KEY を設定するか、~/.alibabacloud/credentials に dashscope_api_key を追加します。

正規化されたインターフェース（image.edit）

リクエスト
  • prompt（string、必須）
  • image（string | bytes、必須）元画像の URL／パス／バイト列
  • mask（string | bytes、任意）インペイント領域のマスク
  • size（string、任意）例：1024*1024
  • seed（int、任意）
レスポンス
  • image_url（string）
  • seed（int）
  • request_id（string）

運用ガイダンス

  • プロンプトはタスクに即したものにし、変更する内容と維持する内容を記述します。
  • 決定論的な局所編集にはマスクを使用します。
  • 出力アセットはオブジェクトストレージに保存し、URL のみを保持します。
  • 被写体の一貫性を保つには、プロンプトに明示的な制約を指定します。

ローカルヘルパースクリプト

正規化されたリクエスト JSON を用意し、レスポンスのスキーマを検証します。

.venv/bin/python skills/ai/image/alicloud-ai-image-qwen-image-edit/scripts/prepare_edit_request.py \
  --prompt "Replace the sky with sunset, keep buildings unchanged" \
  --image "https://example.com/input.png"

出力先

  • デフォルトの出力先：output/alicloud-ai-image-qwen-image-edit/images/
  • OUTPUT_DIR でベースディレクトリを上書きします。

ワークフロー

  1. ユーザーの意図、リージョン、識別子、および操作が読み取り専用か変更を伴うものかを確認します。
  2. 接続と権限を確認するため、まず最小限の読み取り専用クエリを 1 つ実行します。
  3. 対象の操作を、明示的なパラメーターと限定された範囲で実行します。
  4. 結果を確認し、出力ファイルと証跡ファイルを保存します。

参考資料

  • references/sources.md

コメント

Markdown 対応