mcpField
M
modelscope-zimage-generator

modelscope-zimage-generator

github.com/haiyuan-aiクリエイティブ・メディア172 回インストール33 週間前に更新
リポジトリ

modelscope-zimage-generator について

ModelScope の Z-Image モデルで画像を生成するスキルです。エージェントによるモデル選択、LoRA の指定、バッチ生成、非同期スクリプトの実行を案内します。

主な機能

  1. 01Z-Image モデルの選択
  2. 02LoRA を使った画像生成
  3. 03画像のバッチ生成ガイド
  4. 04非同期ポーリングの利用

活用シーン

  1. 01テキストプロンプトから画像を生成
  2. 02指定した LoRA で画像を生成
  3. 03複数の画像バリエーションを生成

インストール

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

$npx skills add https://github.com/haiyuan-ai/agent-skills --skill modelscope-zimage-generator

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

同梱ファイル

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

README-zh.md
README.md
evals/
evals.json
references/
api-reference.md
lora-config.md
troubleshooting.md
scripts/
generate_image.py

詳細

ModelScope Z-Image 生成スキル

非同期ポーリングフローを使用して、ModelScope の Z-Image シリーズモデルで画像を生成します。

このスキルを使用する場面

ユーザーから次のような依頼があった場合に、このスキルを使用します。

  • 画像やイラストを生成する
  • アート作品やカバー画像を作成する
  • ModelScope Z-Image または Z-Image-Turbo を明示的に使用する
  • 複数の画像バリエーションを生成する
  • 生成時に LoRA を適用する

よくあるトリガーフレーズ：

  • 英語：generate an image、create artwork、make a cover、use Z-Image
  • 中国語：生成图片、画一张图、创建封面图、用 Z-Image

基本的なワークフロー

1. 依頼内容を解析する

生成モードを特定します。

  • テキストから画像を生成
  • LoRA を使用した生成
  • 複数画像またはバッチ生成
2. モデルを選択する

ユーザーの依頼に基づいてモデルを選択します。

  • Z-Image-Turbo が明示されている場合 -> Tongyi-MAI/Z-Image-Turbo
  • Z-Image が明示されている場合 -> Tongyi-MAI/Z-Image
  • デフォルト -> Tongyi-MAI/Z-Image-Turbo
3. 生成スクリプトを実行する
cd /path/to/modelscope-zimage-generator
python scripts/generate_image.py "prompt" output.jpg
4. 結果を返す

実行結果をユーザーに伝えます。

  • 成功：出力パスを返します
  • 失敗：エラーを明確に説明します

前提条件

実行する前に、次の項目を確認します。

  1. ModelScope API キー：https://modelscope.cn/my/myaccesstoken から取得します
  2. Python 環境：requests と PIL が必要です
  3. 有効なスクリプトパス：generate_image.py が存在することを確認します

コマンドの簡易対応表

ユーザーの依頼コマンド
「画像を生成」python scripts/generate_image.py "prompt" output.jpg
「Z-Image を使用」python scripts/generate_image.py "prompt" output.jpg --model "Tongyi-MAI/Z-Image"
「LoRA を使用」python scripts/generate_image.py "prompt" output.jpg --lora "lora-id"

よくあるワークフロー

テキストから画像を生成
python scripts/generate_image.py "A golden cat in sunset" golden_cat.jpg
モデルを指定
python scripts/generate_image.py "A cat" output.jpg --model "Tongyi-MAI/Z-Image"
LoRA を使用
# Single LoRA
python scripts/generate_image.py "A cat" output.jpg --lora "liuhaotian/llava-lora"

# Multiple LoRAs (weights sum to 1.0)
python scripts/generate_image.py "A cat" output.jpg --loras '{"lora1": 0.6, "lora2": 0.4}'
バッチ生成
# Generate multiple images in parallel
python scripts/generate_image.py "A cat" cat1.jpg &
python scripts/generate_image.py "A dog" dog1.jpg &
wait

リソース

必要な場合にのみ、次のリファレンスを参照します。

  • references/api-reference.md - API の全パラメーター
  • references/lora-config.md - LoRA 設定ガイド
  • references/troubleshooting.md - トラブルシューティング

トラブルシューティング

API キーが見つからない
# Option 1: Environment variable
export MODELSCOPE_API_KEY="ms-your-key"

# Option 2: Config file
mkdir -p ~/.config/modelscope
cat > ~/.config/modelscope/config.json << EOF
{"api_key": "ms-your-key"}
EOF
タスクがタイムアウトする
  • デフォルトのタイムアウトは 5 分です（ポーリング 60 回）
  • ポーリング回数を増やすか、タスクのステータスを確認します
LoRA が機能しない
  • LoRA ID が有効かどうかを確認します
  • 複数の LoRA の重みの合計が 1.0 になるようにします
  • --lora と --loras を同時に使用しないでください

コメント

Markdown 対応