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

# MetaMuseImageEditApi - ComfyUI Built-in Node Documentation

> 使用文本提示和 Meta 的 Muse Image 模型编辑或组合最多 10 张参考图像。

使用文本提示和 Meta 的 Muse Image 模型编辑或组合最多 10 张参考图像。在提示中描述所需的编辑，并在需要时通过 `@Image1`、`@Image2` 等引用参考图像。该节点会上传参考图像，调用 Meta Muse Image API，并将编辑后的结果作为图像返回。

## 输入

该节点由 `model` 选择器控制。下面描述的模型特定输入会在选择模型时出现，并且你连接的参考图像可以根据需要扩展或缩短。

### 通用输入

| 参数   | 描述      | 数据类型           | 必需 | 范围               |
| ---- | ------- | -------------- | -- | ---------------- |
| `模型` | 要使用的模型。 | DYNAMIC\_COMBO | 是  | "muse-image-1.0" |

### muse-image-1.0 输入

| 参数                    | 描述                                                                        | 数据类型    | 必需 | 范围                                                                                                                                                        |
| --------------------- | ------------------------------------------------------------------------- | ------- | -- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `prompt`              | 编辑指令。支持对输入图像使用 `@Image1` 风格的引用。默认值：空字符串。提示必须至少包含一个字符。                     | STRING  | 是  | Any text with a minimum length of 1 character                                                                                                             |
| `aspect_ratio`        | 输出的宽高比。图像渲染约为 2.5 百万像素（1:1 为 1600x1600，16:9 为 2048x1152）；"auto" 保持输入的宽高比。 | COMBO   | 是  | "auto"<br />"1:1"<br />"3:2"<br />"2:3"<br />"4:3"<br />"3:4"<br />"5:4"<br />"4:5"<br />"16:9"<br />"9:16"<br />"21:9"<br />"9:21"<br />"2:1"<br />"1:2" |
| `reasoning_strength`  | 模型在渲染前进行思考、规划和自我优化的程度。                                                    | COMBO   | 是  | "high"<br />"low"                                                                                                                                         |
| `enable_web_search`   | 允许模型在规划图像时搜索网络以获取事实和实时信息。默认值：true。                                        | BOOLEAN | 是  | true or false (default: true)                                                                                                                             |
| `enable_image_search` | 允许模型在规划图像时搜索参考图像。默认值：true。                                                | BOOLEAN | 是  | true or false (default: true)                                                                                                                             |
| `enable_shell`        | 允许模型在规划时运行代码，以实现精确的布局、图表和示意图；关闭时，数量和排列为近似值。默认值：true。                      | BOOLEAN | 是  | true or false (default: true)                                                                                                                             |
| `seed`                | 用于确定节点是否应重新运行的种子；API 没有种子，因此无论此值如何，实际结果都是不确定的。默认值：42。                     | INT     | 是  | 0 到 2147483647 （步长：1）                                                                                                                                     |

### 参考输入

| 参数       | 描述                                                                                                             | 数据类型  | 必需 | 范围                      |
| -------- | -------------------------------------------------------------------------------------------------------------- | ----- | -- | ----------------------- |
| `images` | 可扩展槽位：连接 1 到 10 张参考图像（`image_1` 到 `image_10`）进行编辑或组合。在提示中将它们引用为 `@Image1`、`@Image2`、...，按输入顺序编号；批处理输入每张图像计为一次。 | IMAGE | 是  | 1 到 10 reference images |

注意：提示不能为空，并且其中包含的每个 `@ImageN` 引用都必须按输入顺序与已连接的图像之一匹配（例如，`@Image1` 是第一个连接的参考图像）。如果提示引用了未连接的图像编号，或者连接的参考图像超过 10 张，该节点会报错。

## 输出

| 输出名称    | 描述                                                   | 数据类型  |
| ------- | ---------------------------------------------------- | ----- |
| `image` | 由 Muse Image 模型返回的编辑或组合后的图像。如果 API 返回多张图像，它们将作为批次返回。 | IMAGE |

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

***

**Source fingerprint (SHA-256):** `5c009ca45199f9c70465f12d48a46b685abebd0194c3d437121b9df0636dbea7`
