🎯

zimage-generation

🎯Skill

from toolsai/free-zimage-skills

VibeIndex|
What it does

Generates high-quality AI images using ModelScope's Z-Image model via command-line interface, supporting multilingual text prompts.

zimage-generation

Installation

Install skill:
npx skills add https://github.com/toolsai/free-zimage-skills --skill zimage-generation
7
Last UpdatedJan 25, 2026

Skill Details

SKILL.md

Overview

# Z-Image 圖片生成工具 (Antigravity Skill)

這是一個基於 ModelScope Z-Image 模型的圖片生成工具。它可以讓你在終端機 (Terminal) 輸入簡單的指令,即刻生成高品質的 AI 圖片。

🌟 功能特點

  • 高品質生成:使用阿里雲開發的 Z-Image 模型,支持中英文提示詞。
  • 異步處理:完美解決大模型生成時間較長的問題,自動排隊並獲取結果。
  • 多種配置方式:支持直接修改代碼、命令列參數或 .env 配置文件,靈活且安全。

🛠️ 安裝與準備

1. 安裝環境

確保你的電腦已安裝 Python 3,然後安裝必要的套件:

```bash

pip install requests python-dotenv

```

2. 獲取 API Key

  1. 註冊並登入 [ModelScope 魔搭社區](https://modelscope.cn/)。
  2. 在「個人中心」獲取你的 API Key。
  3. 重要:請確保你的 ModelScope 帳號已綁定「阿里雲帳號」,否則 API 會返回認證錯誤。

3. 設定 API Key (三選一)

  • 方法 A (最直觀):打開 scripts/generate_zimage.py,在大約第 18 行的 DEFAULT_API_KEY 處填入你的 Key。
  • 方法 B (推薦):在 scripts/ 資料夾下建立一個 .env 檔案,內容如下:

```text

MODELSCOPE_API_TOKEN="你的Key"

```

  • 方法 C (臨時用):執行指令時加上 --api-key "你的Key"

🚀 使用方法

在終端機輸入以下指令:

```bash

python3 scripts/generate_zimage.py "一隻正在宇宙中漫步的可愛金色貓咪,4k畫質,精緻細節"

```

常用參數:

  • --output-o: 指定輸出的路徑與檔名(預設為自動生成)。
  • --size-s: 指定圖片尺寸(預設 1024x1024)。
  • --api-key-k: 臨時指定 API Key。

📁 檔案結構

  • SKILL.md: 供 Antigravity AI Agent 讀取的技能說明文檔。
  • scripts/generate_zimage.py: 核心 Python 腳本。
  • scripts/.env.example: 環境變數配置文件範例。

📝 授權說明

本項目僅供學習與交流使用。模型版權歸 ModelScope/Alibaba 所有。