- name
- modelscope-image
- description
- 魔搭(ModelScope)AI 图片生成。支持多种模型、LoRA 微调。触发词：生成图片、AI绘画、文生图、image generation、generate image。当用户要求生成图片、画图、AI 作画，或提到魔搭、ModelScope时使用。
ModelScope 图片生成
调用魔搭(ModelScope) API 生成 AI 图片。支持切换模型，优化AI识别模型名称不准确。
快速开始
# 设置 API Key（首次使用）
set MODELSCOPE_API_KEY=你的密钥
# 或保存到配置文件
py scripts/generate_qwen.py --save-key 你的密钥
py scripts/generate_tongyi.py --save-key 你的密钥
# 使用z-image生成图片
py scripts/generate_tongyi.py -p "A golden cat"
py scripts/generate_tongyi.py -p "一只在月光下奔跑的银狼" -o wolf.jpg使用qwen-image生成图片
py scripts/generate_qwen.py -p "A golden cat" py scripts/generate_qwen.py -p "一只在月光下奔跑的银狼" -o wolf.jpg
## 参数说明
| 参数 | 说明 | 默认值 |
|------|------|--------|
| `-p, --prompt` | 图片描述（必需） | - |
| `-m, --model` | 模型 ID | Tongyi-MAI/Z-Image |
| `-o, --output` | 输出文件路径 | result_image.jpg |
| `-l, --lora` | 单个 LoRA repo-id | - |
| `--lora-weight` | 单个 LoRA 权重 | 1.0 |
| `--lora-json` | 多 LoRA JSON 配置 | - |
| `--api-key` | API Key | 从环境变量/配置文件读取 |
## LoRA 支持
**使用qwen-image生成图片时，单个 LoRA:**py scripts/generate_qwen.py -p "动漫少女" -l your-lora-id --lora-weight 0.8
**使用z-image生成图片时，单个 LoRA:**py scripts/generate_tongyi.py -p "动漫少女" -l your-lora-id --lora-weight 0.8
**多个 LoRA（权重之和需为 1.0）:**py scripts/generate.py -p "风景画" --lora-json "{\"lora-1\": 0.6, \"lora-2\": 0.4}"
## API Key 配置
三种方式（优先级从高到低）：
1. 命令行参数: `--api-key YOUR_KEY`
2. 环境变量: `set MODELSCOPE_API_KEY=YOUR_KEY`
3. 配置文件: `~/.modelscope/api_key`
获取 API Key: https://modelscope.cn/my/myaccesstoken
## 依赖
pip install requests pillow
## 支持2种常用模型，直接使用
- `Qwen/Qwen-Image-2512` - 快速生成
- `Tongyi-MAI/Z-Image` - 快速生成（默认）
- 更多模型见 ModelScope 平台