用途:该技能用于调用 ModelScope 的 Z-Image 系列模型生成图像,适合生成图片、插画、封面图,以及使用 LoRA 生成变体或批量生成多张图片。触发场景包括用户要求生成图片、画一张图、创建封面图,或明确指定使用 Z-Image、Z-Image-Turbo。
主要能力:支持文生图、LoRA 辅助生成、多图或批量生成,并采用异步轮询流程。模型选择规则为:明确指定 Z-Image-Turbo 时使用 Tongyi-MAI/Z-Image-Turbo;明确指定 Z-Image 时使用 Tongyi-MAI/Z-Image;未指定时默认使用 Tongyi-MAI/Z-Image-Turbo。
使用方式:先解析请求并确定生成模式,再选择模型,然后运行生成脚本。基本命令为:cd /path/to/modelscope-zimage-generator 后执行 python scripts/generate_image.py "prompt" output.jpg。指定模型时加 --model "Tongyi-MAI/Z-Image";使用单个 LoRA 时加 --lora "lora-id";使用多个 LoRA 时用 --loras '{"lora1": 0.6, "lora2": 0.4}',权重之和需为 1.0。批量生成可并行运行多个脚本命令并用 wait 等待。成功后返回输出路径,失败时说明错误。
前提条件:需要 ModelScope API key,可从 https://modelscope.cn/my/myaccesstoken 获取;需要 Python 环境并安装 requests 和 PIL;需确保 generate_image.py 脚本路径有效。API key 可通过环境变量 export MODELSCOPE_API_KEY="ms-your-key" 设置,或写入 ~/.config/modelscope/config.json。
限制与排查:默认超时为 5 分钟(60 次轮询),可增加轮询次数或检查任务状态。LoRA 不生效时需检查 LoRA ID 是否有效,并确保多个 LoRA 权重之和为 1.0;不要同时使用 --lora 和 --loras。更多参数、LoRA 配置与故障排查可参考 references 目录下的 api-reference.md、lora-config.md 和 troubleshooting.md。其他收费、价格、平台支持等细节暂未提供。