zimage-generation

Generate high-quality images using ModelScope's Z-Image API. Use this skill when the user wants to generate images using the specific Z-Image model or ModelScope API they provided. Trigger words: 'Zimage', 'ModelScope', 'generate zimage'.

Jump to install

Repository: Toolsai/Free-Zimage-Skills
Last source activity: January 25, 2026 at 01:41
Detected SKILL.md language: English
Stars: 12
Forks: 3

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

Back to search Back to installation

name	zimage-generation
description	Generate high-quality images using ModelScope's Z-Image API. Use this skill when the user wants to generate images using the specific Z-Image model or ModelScope API they provided. Trigger words: 'Zimage', 'ModelScope', 'generate zimage'.

Z-Image Generation Skill

This skill allows you to generate images using the Z-Image model via the ModelScope Inference API.

When to Use

Use this skill when:

The user requests to generate an image using "Zimage", "zimage:", or "ModelScope".
The user inputs a command like zimage: <prompt> or zimage <prompt>.
The user wants to use their configured ModelScope API key for image generation.

Usage

The skill provides a Python script scripts/generate_zimage.py to handle the API interaction.

Prerequisites

Python 3 with requests installed.
API Key Setup (Choose one):
- Method A (Easiest for beginners): Open scripts/generate_zimage.py and paste your key into the DEFAULT_API_KEY variable at the top.
- Method B (Temporary): Pass via command line: --api-key your_token
- Method C (Recommended Project Setup): Create a new text file named .env in the same folder as the script (scripts/).
  - Content of the file should be: MODELSCOPE_API_TOKEN="your_key_here"

Commands

To generate an image:

# 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"

Arguments:

prompt: The text description of the image (required).
--output, -o: Specify output filename (optional).
--model: Specify a different model ID (optional).
--api-key: API key (if not set in file or environment).

API Verification Note

If the script returns a 401 error mentioning "bind your Alibaba Cloud account", notify the user that they must log in to ModelScope (https://modelscope.cn/my/account) and bind their Alibaba Cloud account to enable API access. This is a one-time setup required by the platform.

Example

# 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"