Z-Image Skill - AI Image Generation for Claude Code

Generate beautiful images with natural language in Claude Code!

English | 中文

What is this?

Z-Image Skill is a Claude Code skill plugin that lets you generate AI images using simple natural language descriptions.

Just say things like:
- "Generate a picture of a golden cat"
- "Draw a sunset over mountains"
- "Create a cute cartoon avatar"

And Claude Code will automatically generate the image for you!

Demo

You: Generate a cyberpunk style city at night

Claude: I'll generate that image for you...
        Task started: xxx
        Image saved to: cyberpunk_city.jpg

        Done! The image has been saved to cyberpunk_city.jpg

Installation

All steps can be completed using natural language in Claude Code - no manual commands needed!

Step 1: Get Your Free API Key

1. Visit ModelScope
2. Click "Login/Register" in the top right corner
3. After logging in, go to API Token page
4. Click "Create Token" and copy your API Key

Step 2: Install the Skill

Open Claude Code and simply say:

Install zimage-skill from https://github.com/yizhiyanhua-ai/zimage-skill

Claude will automatically:
- Download the skill to the correct directory
- Install the required Python dependencies

Step 3: Configure API Key

In Claude Code, say:

Configure MODELSCOPE_API_KEY environment variable with value ms-xxxxxxxx (replace with your API Key)

Or you can say:

Add MODELSCOPE_API_KEY environment variable to ~/.claude/settings.json with value ms-xxxxxxxx

Step 4: Verify Installation

After restarting Claude Code, simply say:

Generate a test image for me

If you see an image generated successfully, you're all set!

Usage Examples

Basic Usage

You: Generate a cute Shiba Inu picture
You: Draw an astronaut on the moon
You: Create an abstract art painting

Specify Output Path

You: Generate a beach sunset image, save as sunset.jpg
You: Draw a panda, save to ~/Pictures/panda.png

Detailed Descriptions for Better Results

You: Generate an image: an orange cat sitting on a windowsill,
     rainy city night outside, warm indoor lighting,
     cinematic composition, 4K high definition

You: Create a painting: Chinese ink wash style landscape,
     misty mountains in the distance, a small boat nearby,
     serene and peaceful atmosphere

Style Examples

Practical Use Cases

1. Create Avatars

You: Generate a cute cartoon avatar, girl with pink hair, big eyes, smiling

2. Article Illustrations

You: I'm writing an article about AI, generate a tech-themed illustration

3. Social Media Content

You: Generate a scenic landscape photo suitable for Instagram, calming vibes

4. Design Inspiration

You: Draw an app splash screen background, gradient colors, abstract, modern

5. Meme Creation

You: Generate a surprised cat face, cartoon style, exaggerated expression

FAQ

Q: Getting "MODELSCOPE_API_KEY environment variable is required"

A: You haven't configured your API Key yet. Follow Steps 1 and 2 in the Installation section.

Q: Image generation fails or times out

A: Possible reasons:
- Network connection issues - check your internet
- API service is busy - try again later
- Content may have triggered moderation - modify your description

Q: Generated image quality is not ideal

A: Try these tips:
- Use more detailed descriptions
- Add quality keywords (e.g., "high definition", "4K", "cinematic", "professional photography")
- Specify art style (e.g., "oil painting style", "watercolor", "anime style")

Q: What image formats are supported?

A: Default output is JPG format. PNG is also supported (just specify in the filename).

Technical Information

• Model: Tongyi-MAI/Z-Image-Turbo
• API Provider: ModelScope (Alibaba Cloud)
• Timeout: 120 seconds
• Supported Languages: Chinese, English

Getting Help

If you encounter issues:
1. Check the FAQ section above
2. Submit an Issue on GitHub
3. Verify your API Key is correctly configured

License

MIT License - Free to use and modify