n8n community node for Modelscope Image generation API - Generate images using Modelscope AI models
npm install n8n-nodes-modelscope-imageEnglish | 简体中文
想让工作更轻松?扫码关注微信公众号 【曹工不加班】,免费获取:
- 📚 独家保姆级 n8n 实战教程
- 🧩 社区专享 VIP 节点
- 💡 高阶自动化工作流模板
---
这是一个 n8n 社区节点,用于 Modelscope 图像生成 API。它允许你在 n8n 工作流中使用 Modelscope 的 AI 模型根据文本提示词生成图像。
安装
操作
功能特性
支持的模型
支持的纵横比
凭证
节点参数
使用说明
兼容性
资源
请遵循 n8n 社区节点文档中的 安装指南。
- 生成图像 (Generate Image):根据文本提示词使用 Modelscope AI 模型生成图像。
- 文生图:使用 Modelscope AI 模型从文本提示词生成图像
- 多模型支持:支持 Z-Image-Turbo 和 Qwen-Image-2512 模型
- 灵活的纵横比:提供 12 种预设比例或输入自定义比例
- 分辨率控制:根据长边自动计算或手动指定分辨率
- 多种输出格式:二进制文件、Base64 字符串或 Base64 Data URL
- 批量处理:支持多个项目独立轮询处理
- 可配置超时:可调整轮询间隔和超时设置
| 模型名称 | 模型 ID |
|----------|---------|
| Z-Image-Turbo | Tongyi-MAI/Z-Image-Turbo |
| Qwen-Image-2512 | Qwen/Qwen-Image-2512 |
| 比例 | 描述 |
|------|------|
| 2.35:1 | 电影宽银幕 (Cinematic widescreen) |
| 21:9 | 超宽屏 (Ultra-wide) |
| 2:1 | 全景 (Panoramic) |
| 16:9 | 标准宽屏 (Standard widescreen) |
| 3:2 | 经典照片 (Classic photo) |
| 4:3 | 标准显示器 (Standard monitor) |
| 5:4 | 大画幅 (Large format) |
| 1:1 | 正方形 (Square) |
| 4:5 | 竖版 Instagram (Portrait Instagram) |
| 3:4 | 竖版显示器 (Portrait monitor) |
| 2:3 | 竖版照片 (Portrait photo) |
| 9:16 | 竖版视频 (Vertical video) |
你也可以输入自定义纵横比,格式为 宽:高(例如:16:9 或 2.35:1)。
使用此节点需要 Modelscope API Token:
1. 前往 Modelscope 并创建账户
2. 导航至 我的访问令牌
3. 创建新令牌或复制现有令牌
4. 在 n8n 中创建 "Modelscope Image API" 类型的新凭证
5. 粘贴你的 API Token
| 字段 | 描述 | 默认值 |
|------|------|--------|
| API Token | 你的 Modelscope API 令牌 | (必填) |
| Base URL | API 基础 URL | https://api-inference.modelscope.cn/ |
| 参数 | 描述 |
|------|------|
| 操作 (Operation) | 当前支持"生成图像 (Generate Image)" |
| 模型 (Model) | 选择要使用的 AI 模型 |
| 提示词 (Prompt) | 描述要生成图像的文本 |
| 纵横比 (Aspect Ratio) | 从列表选择或输入自定义比例 |
| 参数 | 描述 | 默认值 |
|------|------|--------|
| 长边 (Long Edge) | 较长边的像素长度 | 2048 |
| 分辨率 (Resolution) | 手动分辨率(覆盖比例计算) | - |
| 二进制字段名 (Binary Field Name) | 二进制数据的输出字段名 | data |
| 文件名 (File Name) | 输出文件名 | 自动生成 |
| 输出格式 (Output Format) | 二进制、Base64 或 Data URL | 二进制 (Binary) |
| 轮询间隔 (Polling Interval) | 状态检查间隔秒数 | 5 |
| 超时 (Timeout) | 最大等待时间(秒) | 300 |
1. 将 "Modelscope Image" 节点添加到工作流
2. 配置凭证
3. 选择模型(例如:"Z-Image-Turbo")
4. 输入提示词(例如:"一只金色的猫坐在天鹅绒垫子上")
5. 选择纵横比(例如:"1:1" 正方形)
6. 执行节点
节点返回:
JSON 输出:
``json`
{
"taskId": "abc123...",
"imageUrl": "https://...",
"size": "2048x2048",
"model": "Tongyi-MAI/Z-Image-Turbo"
}
二进制输出(默认): 生成的图像作为二进制文件附加到 data 字段。
使用纵横比时:
- 长边设置为指定值(默认:2048)
- 短边根据比例自动计算
- 示例:21:9 比例,长边 2048 = 2048×878 像素
使用手动分辨率时:
- 格式:宽x高(例如:1024x768`)
- 两个维度必须在 64 到 2048 之间
兼容 n8n@1.0.0 或更高版本。
- n8n 社区节点文档
- Modelscope API 文档
- Modelscope 图像模型
- 首次发布
- 支持文生图
- 支持 Z-Image-Turbo 和 Qwen-Image-2512 模型
- 可配置纵横比和分辨率
- 多种输出格式(二进制、Base64、Data URL)
- 批量处理,独立任务轮询
MIT