mcpField
Z
zimage-generation

zimage-generation

github.com/toolsaiCreative & media12868 installsUpdated 40w ago
Repository

About zimage-generation

zimage-generation is a skill for generating images with the Z-Image model through the ModelScope Inference API. It provides a Python script with prompt, output, model, and API-key options.

Key features

  1. 01Z-Image image generation
  2. 02ModelScope Inference API access
  3. 03Python script for API requests
  4. 04Prompt, output, and model options
  5. 05Several API-key configuration methods

Use cases

  1. 01Generating an image from a text prompt
  2. 02Saving generated images to a chosen filename
  3. 03Running image generation with a configured ModelScope key

Install

Copy the command and run it in a terminal.

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

After installing, type/zimage-generationin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

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

Details

From the project README

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"

Comments

Markdown supported