mcpField
Z
zimage-generation

zimage-generation

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

zimage-generation について

zimage-generationは、ModelScope Inference APIを通じてZ-Imageモデルで画像を生成するスキルです。プロンプト、出力先、モデルを指定できるPythonスクリプトを提供します。

主な機能

  1. 01Z-Imageによる画像生成
  2. 02ModelScope Inference APIの利用
  3. 03APIリクエスト用Pythonスクリプト
  4. 04プロンプト、出力先、モデルの指定
  5. 05複数のAPIキー設定方法

活用シーン

  1. 01テキストプロンプトからの画像生成
  2. 02生成画像の指定ファイル名での保存
  3. 03設定済みModelScopeキーを使った画像生成

インストール

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

$npx skills add https://github.com/toolsai/free-zimage-skills --skill zimage-generation

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

同梱ファイル

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

.DS_Store
.gitignore
README.md
scripts/
.DS_Store
.env.example
generate_zimage.py

詳細

Z-Image 画像生成スキル

このスキルを使用すると、ModelScope Inference API を介して Z-Image モデルで画像を生成できます。

使用するタイミング

次の場合にこのスキルを使用します:

  • ユーザーが「Zimage」、「zimage:」、または「ModelScope」を使用して画像を生成するよう依頼した場合。
  • ユーザーが zimage: <prompt> または zimage <prompt> のようなコマンドを入力した場合。
  • ユーザーが設定済みの ModelScope API キーを画像生成に使用したい場合。

使用方法

このスキルでは、API とのやり取りを処理する Python スクリプト scripts/generate_zimage.py を使用します。

前提条件
  • requests がインストールされた Python 3。
  • API キーの設定(いずれかを選択):
    • 方法 A(初心者に最も簡単): scripts/generate_zimage.py を開き、冒頭にある DEFAULT_API_KEY 変数にキーを貼り付けます。
    • 方法 B(一時的な設定): コマンドラインから --api-key your_token を渡します。
    • 方法 C(推奨するプロジェクト設定): 新しいテキストファイル .env をスクリプトと同じフォルダー(scripts/)に作成します。
      • ファイルの内容:MODELSCOPE_API_TOKEN="your_key_here"
コマンド

画像を生成するには:

# If you used Method A (pasted key in file):
python3 /Users/promptcase/.gemini/antigravity/skills/zimage-generation/scripts/generate_zimage.py "Your descriptive prompt here"

# If you prefer command line (Method B):
python3 /Users/promptcase/.gemini/antigravity/skills/zimage-generation/scripts/generate_zimage.py "Your prompt" --api-key "your_key"

引数:

  • prompt:画像のテキスト説明(必須)。
  • --output、-o:出力ファイル名を指定します(任意)。
  • --model:別のモデル ID を指定します(任意)。
  • --api-key:API キー(ファイルまたは環境変数に設定されていない場合)。
API の確認に関する注意

スクリプトが「bind your Alibaba Cloud account」という記述を含む 401 エラーを返した場合、API アクセスを有効にするには ModelScope(https://modelscope.cn/my/account)にログインし、Alibaba Cloud アカウントを紐付ける必要があることをユーザーに伝えてください。これはプラットフォームで一度だけ必要な設定です。

例

# To generate a cyberpunk city
python3 /Users/mattchan/.gemini/antigravity/skills/zimage-generation/scripts/generate_zimage.py "cyberpunk city, neon lights, rainy street, high detail"

コメント