> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenRouterImageNode - ComfyUI Built-in Node Documentation

> 此节点通过 OpenRouter 使用 Microsoft 的 MAI-Image-2.6 模型生成或编辑图像。

此节点通过 OpenRouter 使用 Microsoft 的 MAI-Image-2.6 模型生成或编辑图像。它支持文本到图像生成，以及使用最多五张参考图像进行图像引导编辑，支持七种宽高比，分辨率为 1K 或 1.5K。

## 输入

### 通用输入

| 参数   | 描述                                          | 数据类型           | 必需 | 范围                                                             |
| ---- | ------------------------------------------- | -------------- | -- | -------------------------------------------------------------- |
| `模型` | 用于生成图像的 OpenRouter 图像模型。选择模型会显示下方列出的模型特定选项。 | DYNAMIC\_COMBO | 是  | `microsoft/mai-image-2.6`<br />`microsoft/mai-image-2.6-flash` |

### Mai Image 2.6 和 Mai Image 2.6 Flash 输入

两个模型选项（`microsoft/mai-image-2.6` 和 `microsoft/mai-image-2.6-flash`）共享此表，它们暴露相同的参数集。

| 参数             | 描述                                                                                                                                                  | 数据类型   | 必需 | 范围                                                                                                    |
| -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | -- | ----------------------------------------------------------------------------------------------------- |
| `prompt`       | 描述要生成的图像，或要应用于参考图像的编辑。最多 20000 个字符。默认值：`""`（空）。去除首尾空白后至少需要 1 个字符。                                                                                   | STRING | 是  | 1 到 20000 个字符                                                                                         |
| `aspect_ratio` | 生成图像的宽高比，连接参考图像时也会应用。默认值：`"1:1"`。`"auto"` 让模型为文本到图像选择比例（以 1.5K 尺寸渲染），并在编辑时保持第一张参考图像的宽高比。                                                            | COMBO  | 是  | `"1:1"`<br />`"16:9"`<br />`"9:16"`<br />`"3:2"`<br />`"2:3"`<br />`"4:3"`<br />`"3:4"`<br />`"auto"` |
| `resolution`   | 输出尺寸层级。1K 约为 1 百万像素（1:1 为 1024x1024，16:9 为 1360x768）；1.5K 约为 2.3 百万像素（1:1 为 1536x1536，16:9 为 2048x1152）。默认值：`"1K"`。当 `aspect_ratio` 为 `"auto"` 时忽略。 | COMBO  | 是  | `"1K"`<br />`"1.5K"`                                                                                  |
| `seed`         | 用于确定节点是否应重新运行的种子；API 没有种子，因此无论此值如何，实际结果都是不确定的。默认值：`42`。                                                                                             | INT    | 是  | 0 到 2147483647                                                                                        |

### 参考输入

| 参数                      | 描述                                                              | 数据类型  | 必需 | 范围        |
| ----------------------- | --------------------------------------------------------------- | ----- | -- | --------- |
| `image_1` ... `image_5` | 可增长槽位：连接 1 到 5 张参考图像以进行图像引导编辑；批量输入按每张图像计一次。槽位可选，可以留空（最少连接 0 张）。 | IMAGE | 否  | 0 到 5 张图像 |

**注意：**

* 所有连接的槽位总计最多支持 5 张参考图像；批量输入按每张图像计一次。
* `prompt` 去除首尾空白后必须至少包含 1 个字符，且不能超过 20000 个字符。
* 参考图像以 PNG 数据发送，总像素限制为 2048 x 2048。
* 即使连接了参考图像，`aspect_ratio` 设置也会应用于输出。
* 当 `aspect_ratio` 为 `"auto"` 时，`resolution` 设置会被忽略。没有参考图像时，模型为文本到图像选择比例，并以 1.5K 尺寸渲染；连接了参考图像时，保持第一张参考图像的宽高比。
* 种子值不影响 API 结果；它只决定节点是否重新运行。

## 输出

| 输出名称    | 描述                                                                  | 数据类型  |
| ------- | ------------------------------------------------------------------- | ----- |
| `IMAGE` | 生成或编辑后的图像。如果服务返回多张图像，它们会合并为单个批量 IMAGE 输出。如果没有返回图像，或返回的图像无法解码，则引发错误。 | IMAGE |

> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/OpenRouterImageNode/zh.md)

***

**Source fingerprint (SHA-256):** `d201c18deccd2523041a24427996f51127ca201dfe10fad60c6f768ab79bf852`