mcpField
M
modelscope-zimage-generator

modelscope-zimage-generator

github.com/haiyuan-ai创意与媒体172 次安装33 周前更新
代码仓库

关于 modelscope-zimage-generator

通过 ModelScope 的 Z-Image 模型生成图片的 Skill，指导 Agent 选择模型、配置 LoRA，并运行异步生成脚本。

主要功能

  1. 01选择 Z-Image 模型
  2. 02支持 LoRA 辅助生成
  3. 03指导批量生成图片
  4. 04使用异步轮询

适用场景

  1. 01根据文本提示生成图片
  2. 02使用指定 LoRA 生成图片
  3. 03请求生成多个图片版本

安装

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

$npx skills add https://github.com/haiyuan-ai/agent-skills --skill modelscope-zimage-generator

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

包含的文件

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

README-zh.md
README.md
evals/
evals.json
references/
api-reference.md
lora-config.md
troubleshooting.md
scripts/
generate_image.py

详细介绍

ModelScope Z-Image 图像生成技能

使用 ModelScope Z-Image 系列模型，通过异步轮询流程生成图像。

何时使用此技能

用户提出以下请求时，请使用此技能：

  • 生成图像或插画
  • 创作艺术作品或封面图
  • 明确要求使用 ModelScope Z-Image 或 Z-Image-Turbo
  • 生成多个图像变体
  • 在生成时应用 LoRA

常见触发短语：

  • 英文：generate an image、create artwork、make a cover、use Z-Image
  • 中文：生成图片、画一张图、创建封面图、用 Z-Image

核心工作流

1. 解析请求

确定生成模式：

  • 文生图
  • LoRA 辅助生成
  • 多图或批量生成
2. 选择模型

根据用户请求选择模型：

  • 明确指定 Z-Image-Turbo -> Tongyi-MAI/Z-Image-Turbo
  • 明确指定 Z-Image -> Tongyi-MAI/Z-Image
  • 默认 -> Tongyi-MAI/Z-Image-Turbo
3. 运行生成脚本
cd /path/to/modelscope-zimage-generator
python scripts/generate_image.py "prompt" output.jpg
4. 返回结果

告知用户处理结果：

  • 成功：返回输出路径
  • 失败：清晰说明错误

前置条件

运行前：

  1. ModelScope API 密钥：从 https://modelscope.cn/my/myaccesstoken 获取
  2. Python 环境：需要 requests 和 PIL
  3. 有效的脚本路径：确保 generate_image.py 存在

快速命令对照

用户请求命令
“生成图像”python scripts/generate_image.py "prompt" output.jpg
“使用 Z-Image”python scripts/generate_image.py "prompt" output.jpg --model "Tongyi-MAI/Z-Image"
“使用 LoRA”python scripts/generate_image.py "prompt" output.jpg --lora "lora-id"

常见工作流

文生图
python scripts/generate_image.py "A golden cat in sunset" golden_cat.jpg
指定模型
python scripts/generate_image.py "A cat" output.jpg --model "Tongyi-MAI/Z-Image"
使用 LoRA
# Single LoRA
python scripts/generate_image.py "A cat" output.jpg --lora "liuhaotian/llava-lora"

# Multiple LoRAs (weights sum to 1.0)
python scripts/generate_image.py "A cat" output.jpg --loras '{"lora1": 0.6, "lora2": 0.4}'
批量生成
# Generate multiple images in parallel
python scripts/generate_image.py "A cat" cat1.jpg &
python scripts/generate_image.py "A dog" dog1.jpg &
wait

资源

仅在需要时阅读参考资料：

  • references/api-reference.md - API 完整参数
  • references/lora-config.md - LoRA 配置指南
  • references/troubleshooting.md - 故障排查

故障排查

未找到 API 密钥
# Option 1: Environment variable
export MODELSCOPE_API_KEY="ms-your-key"

# Option 2: Config file
mkdir -p ~/.config/modelscope
cat > ~/.config/modelscope/config.json << EOF
{"api_key": "ms-your-key"}
EOF
任务超时
  • 默认超时时间为 5 分钟（轮询 60 次）
  • 增加轮询次数或检查任务状态
LoRA 未生效
  • 检查 LoRA ID 是否有效
  • 确保多个 LoRA 权重之和为 1.0
  • 不要同时使用 --lora 和 --loras

评论

支持 Markdown