> ## 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.
# 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 | 是 | 任意文本（长度至少为 1 个字符） |
| `aspect_ratio` | 输出的宽高比。图像以约 2.5 兆像素渲染（1:1 为 1600x1600，16:9 为 2048x1152）；"auto" 保持输入的宽高比。 | COMBO | 是 | "auto"
"1:1"
"3:2"
"2:3"
"4:3"
"3:4"
"5:4"
"4:5"
"16:9"
"9:16"
"21:9"
"9:21"
"2:1"
"1:2" |
| `reasoning_strength` | 模型在渲染前进行思考、规划和自我修正的程度。 | COMBO | 是 | "high"
"low" |
| `enable_web_search` | 允许模型在规划图像时搜索网络以获取事实和实时信息。默认：true。 | BOOLEAN | 是 | true 或 false（默认：true） |
| `enable_image_search` | 允许模型在规划图像时搜索参考图像。默认：true。 | BOOLEAN | 是 | true 或 false（默认：true） |
| `enable_shell` | 允许模型在规划时运行代码，以实现精确的布局、图表和示意图；关闭时，数量和排列对齐将被近似处理。默认：true。 | BOOLEAN | 是 | true 或 false（默认：true） |
| `seed` | 用于确定节点是否应重新运行的种子；该 API 没有种子概念，因此无论此值如何，实际结果都是不确定的。默认：42。 | INT | 是 | 0 到 2147483647（步长 1） |
### 参考输入
| 参数 | 描述 | 数据类型 | 必填 | 范围 |
| -------- | ------------------------------------------------------------------------------------------------------------------------ | ----- | -- | ------------ |
| `images` | 可增长的输入槽：连接 1 到 10 张参考图像（`image_1` 至 `image_10`）以进行编辑或合并。可在提示词中以 `@Image1`、`@Image2`…… 的形式引用它们，编号与输入顺序一致；批处理输入中的每张图像分别计数。 | IMAGE | 是 | 1 到 10 张参考图像 |
注意：提示词不能为空，且其中包含的每个 `@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`