English | 简体中文

n8n-nodes-moyuai

这是一个 n8n 社区节点，允许你通过 moyuAI 使用 Google Gemini 图像模型以及 OpenAI 风格的 GPT 图像模型生成图像。

n8n 是一个 公平代码许可 的工作流自动化平台。

安装
操作
凭证
兼容性
使用说明
资源

安装

请遵循 n8n 社区节点文档中的 安装指南。

操作

• 文本生图 (Text to Image)：根据文本描述生成图像。
• 图生图 (Image to Image)：基于参考图像和文本提示词生成图像。

功能特性

• 模型：支持 Gemini 2.5 Flash、Gemini 3.1 Flash、Gemini 3 Pro、gpt-image-2、gpt-image-2-all。
• 纵横比：支持多种纵横比，如 1:1, 16:9, 4:3, 3:4, 9:16 等。
• 分辨率：所有模型均可配置分辨率 (1K, 2K, 4K)。
• GPT Image 2 参数：gpt-image-2 与 gpt-image-2-all 支持独立的 size、quality、format，图像编辑额外支持 background 与 moderation。
• 并发生成数量：可配置一次并发发起的生成请求次数。
• 请求超时：可配置每次模型请求的超时毫秒数。
• 请求诊断：可输出脱敏后的请求 URL、是否发出请求、HTTP 状态码与响应体，便于排查 GPT Image 2。
• 输出格式：
  • 二进制文件 (标准 n8n 二进制数据)
  • Base64 字符串
  • Base64 Data URL
  • 图像 URL
  • 原始响应 (Raw Response)

凭证

你需要设置 moyuAI API 凭证才能使用此节点。

1. 连接类型:
   • Official:直接连接到 Google 的 Generative Language API。
   • OpenAI Compatible:通过 OpenAI 兼容的端点连接，可用于云雾等中转站。
2. API Key:你的 Gemini API 密钥。
3. Base URL:(可选)用于 OpenAI 兼容连接的自定义 Base URL。使用云雾这类中转站时，可填写 https://yunwu.ai/v1/。
4. 请求格式(Request Format):
   • Gemini Native: 用于 Gemini 原生接口
   • OpenAI Compatible: 用于 gpt-image-2、gpt-image-2-all 以及其它 OpenAI 风格图片接口

使用说明

文本生图 (Text to Image)

1. 选择 Text to Image 操作。
2. 选择你的 模型 (Model)。
3. 输入描述性的 提示词 (Prompt)。
4. 选择所需的 纵横比 (Aspect Ratio)。
5. 执行节点以获取生成的图像。

如果选择 gpt-image-2 或 gpt-image-2-all，请使用 OpenAI Compatible 连接类型与 OpenAI Compatible 请求格式，并配置中转站的 Base URL。

图生图 (Image to Image)

1. 选择 Image to Image 操作。
2. 提供 参考图像 (Reference Images)。
3. 输入 提示词 (Prompt) 来引导生成。
4. 执行节点。

gpt-image-2 与 gpt-image-2-all 的图生图通过 OpenAI Images Edits 接口实现，最多支持 5 张参考图。
GPT Image 2 图像编辑会以 multipart/form-data 发送多个 image 字段，以兼容 OpenAI 风格的 /v1/images/edits 接口。

请求诊断

如果 GPT Image 2 执行后没有图片返回，建议临时关闭 Throw On Failure，并开启 Show Request Diagnostics。

• sent:false 且 blockedBeforeRequest:true：请求在发送前被配置校验拦截，查看 reason。
• sent:true 且 responseReceived:false：代码已尝试发出请求，但没有收到 HTTP 响应，查看 error。
• sent:true 且 responseReceived:true：请求已发出并收到响应，查看 statusCode 与 responseBody。

参考图像字段使用指南

支持的格式:

• URL: 图片的 HTTP/HTTPS 链接

  https://example.com/image.jpg
  

• Data URI: Base64 编码的图片数据

  data:image/png;base64,iVBORw0KGgoAAAANSUhEUg...
  

• 纯 Base64: 直接粘贴 Base64 字符串(自动识别为 PNG)

  iVBORw0KGgoAAAANSUhEUgAA...
  

• Binary 字段名: 从前一节点的二进制数据读取

  data
  image1
  

多个图片分隔:

使用 竖线 | 或 换行 分隔多个图片:

data|image1

或

data
image1

混合使用不同格式:

data|https://example.com/image.jpg

或

data
https://example.com/image.jpg
data:image/png;base64,iVBORw0KGgo...

数量限制:

• Gemini 2.x Flash 模型最多支持 3 张参考图
• Gemini 3.x / Pro 模型最多支持 14 张参考图
• gpt-image-2 / gpt-image-2-all 最多支持 5 张参考图

兼容性

兼容 n8n@1.0.0 或更高版本。

资源

• n8n 社区节点文档
• Gemini API 图像生成文档