Z-Image Generation Skill 允许通过 ModelScope 推理 API 使用 Z-Image 模型生成图像。
适用场景
在以下情况使用该技能:
- 用户请求使用 "Zimage"、"zimage:" 或 "ModelScope" 生成图片。
- 用户输入类似 zimage: <prompt> 或 zimage <prompt> 的命令。
- 用户希望使用其配置的 ModelScope API Key 进行图像生成。
使用方式
该技能提供一个 Python 脚本 scripts/generate_zimage.py 来处理 API 交互。
前置条件
- 安装了 requests 的 Python 3。
- API Key 设置(选择其一):
- 方法 A(对初学者最简单):打开 scripts/generate_zimage.py,将你的 key 粘贴到顶部的 DEFAULT_API_KEY 变量中。
- 方法 B(临时):通过命令行传入:--api-key your_token
- 方法 C(推荐的项目设置):在脚本所在文件夹(scripts/)中创建一个名为 .env 的新文本文件。文件内容应为:MODELSCOPE_API_TOKEN="your_key_here"
命令
生成图片:
# 如果使用了方法 A(已将 key 粘贴到文件中):
python3 /Users/promptcase/.gemini/antigravity/skills/zimage-generation/scripts/generate_zimage.py "Your descriptive prompt here"
# 如果偏好命令行(方法 B):
python3 /Users/promptcase/.gemini/antigravity/skills/zimage-generation/scripts/generate_zimage.py "Your prompt" --api-key "your_key"
参数:
- prompt:图像的文本描述(必填)。
- --output, -o:指定输出文件名(可选)。
- --model:指定不同的模型 ID(可选)。
- --api-key:API key(如果未在文件或环境中设置)。
API 验证说明
如果脚本返回 401 错误并提及 "bind your Alibaba Cloud account",请通知用户必须登录 ModelScope(https://modelscope.cn/my/account)并绑定其阿里云账号以启用 API 访问。这是平台要求的一次性设置。
示例
# 生成赛博朋克城市
python3 /Users/mattchan/.gemini/antigravity/skills/zimage-generation/scripts/generate_zimage.py "cyberpunk city, neon lights, rainy street, high detail"
限制
关于该技能支持的平台、收费、价格或具体生成效果,资料中暂未提供更多信息。