mcpField
Z
zimage-generation

zimage-generation

github.com/toolsai创意与媒体12868 次安装40 周前更新
代码仓库

关于 zimage-generation

zimage-generation 是通过 ModelScope Inference API 使用 Z-Image 模型生成图像的技能，提供 Python 脚本，并支持设置提示词、输出文件和模型。

主要功能

  1. 01使用 Z-Image 生成图像
  2. 02调用 ModelScope Inference API
  3. 03通过 Python 脚本发送请求
  4. 04支持提示词、输出和模型选项
  5. 05提供多种 API 密钥配置方式

适用场景

  1. 01根据文本提示词生成图像
  2. 02将生成图像保存为指定文件名
  3. 03使用已配置的 ModelScope 密钥生成图像

安装

复制下面的命令，在终端中运行。

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

安装后在 Claude Code 中输入/zimage-generation确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

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

详细介绍

Z-Image 图像生成技能

此技能可让你通过 ModelScope Inference API 使用 Z-Image 模型生成图像。

使用时机

在以下情况下使用此技能：

  • 用户请求使用“Zimage”“zimage:”或“ModelScope”生成图像。
  • 用户输入类似 zimage: <prompt> 或 zimage <prompt> 的命令。
  • 用户希望使用已配置的 ModelScope API 密钥生成图像。

用法

此技能提供了一个 Python 脚本 scripts/generate_zimage.py，用于处理 API 交互。

前置条件
  • 安装了 requests 的 Python 3。
  • API 密钥设置（任选一种）：
    • 方法 A（新手最简单）： 打开 scripts/generate_zimage.py，将密钥粘贴到顶部的 DEFAULT_API_KEY 变量中。
    • 方法 B（临时使用）： 通过命令行传入：--api-key your_token
    • 方法 C（推荐的项目设置）： 在与脚本相同的文件夹中（scripts/）新建一个名为 .env 的文本文件。
      • 文件内容应为：MODELSCOPE_API_TOKEN="your_key_here"
命令

生成图像：

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

参数：

  • prompt：图像的文字描述（必填）。
  • --output、-o：指定输出文件名（可选）。
  • --model：指定其他模型 ID（可选）。
  • --api-key：API 密钥（若未在文件或环境中设置）。
API 验证说明

如果脚本返回 401 错误，并提示“bind your Alibaba Cloud account”，请告知用户必须登录 ModelScope（https://modelscope.cn/my/account）并绑定其 Alibaba Cloud 账户，以启用 API 访问。这是平台要求的一次性设置。

示例

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

评论

支持 Markdown