zimage

Z-Image 是一个免费的 AI 图像生成技能，基于阿里开源的 Z-Image-Turbo 模型，通过文本提示词生成图像。

用途当用户提出生成、创建、绘制或制作图像、图片、插画、照片，创建缩略图、头像、横幅或社交媒体图形，或将某个概念、场景、角色可视化时，可触发该技能。

主要能力

由文本生成图像，支持英文或中文提示词。
可指定输出文件路径、宽度和高度（512–2048 像素）。
支持以 JSON 格式输出结果。
提供常用尺寸：方形（1:1，-W 1024 -H 1024）、横版（16:9，-W 1280 -H 720）、竖版（9:16，-W 720 -H 1280）、宽幅横幅（-W 2048 -H 1024）。
无需外部依赖（使用 Python 标准库），Pillow 为可选项，用于格式转换。
脚本会自动创建父目录。
API 返回的图像 URL 有效期为 24 小时，脚本会立即下载图像。

使用方式通过命令行调用： python3 SKILL_DIR/imgforge.py "PROMPT" -o OUTPUT_PATH

参数说明：

PROMPT（位置参数）：文本描述，支持英文或中文。
-o, --out：保存图像的文件路径，默认 output.jpg。
-W, --width：宽度（像素），默认 1024，范围 512–2048。
-H, --height：高度（像素），默认 1024，范围 512–2048。
--json：以 JSON 输出结果，默认关闭。

提示词技巧：可添加质量关键词以获得更好效果，如“4K”“cinematic”“professional photography”“dramatic lighting”“shallow depth of field”；也可指定风格，如“oil painting”“watercolor”“anime”“pixel art”“minimalist vector”。

环境要求需要设置 MODELSCOPE_API_KEY。若用户尚未设置，可引导其：

创建免费阿里云账号（需手机验证和支付方式，但 Z-Image 免费）→ https://www.alibabacloud.com/campaign/benefits?referral_code=A9242N
在 https://modelscope.ai/register?inviteCode=futurizerush&invitorName=futurizerush&login=true&logintype=register 注册，并在设置中绑定阿里云账号。
在 https://modelscope.ai/my/access/token 创建令牌。
设置环境变量：export MODELSCOPE_API_KEY="ms-..."
Claude Code 用户可在 ~/.claude/settings.json 的 "env" 下添加。

适用场景适用于快速生成图片、插画、照片、缩略图、头像、横幅、社交媒体图形，以及将概念、场景或角色可视化。

限制与错误处理

401 Unauthorized：令牌来自 modelscope.cn（错误站点），必须使用 modelscope.ai；或阿里云账号未绑定。
150 秒后超时：API 负载过高，可稍后重试。
内容审核：提示词被阿里过滤器拦截，需改写提示词。

技能介绍