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

# MagnificImageRelightNode - ComfyUI Built-in Node Documentation

> Complete documentation for the MagnificImageRelightNode node in ComfyUI. Learn its inputs, outputs, parameters and usage.

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

Magnific Image Relight 节点用于调整输入图像的照明效果。它可以根据文本提示应用风格化照明，或从可选的参考图像中转移照明特性。该节点提供多种控制选项，用于微调最终输出的亮度、对比度和整体氛围。

## 输入参数

| 参数                          | 数据类型         | 必填 | 范围                                                                                                                                              | 描述                                                                     |
| --------------------------- | ------------ | -- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| `image`                     | IMAGE        | 是  | N/A                                                                                                                                             | 需要重新照明的图像。必须且仅能输入一张图像。最小尺寸为 160x160 像素。宽高比必须在 1:3 到 3:1 之间。            |
| `prompt`                    | STRING       | 否  | N/A                                                                                                                                             | 用于照明的描述性引导。支持强调符号 (1-1.4)。默认为空字符串。                                     |
| `light_transfer_strength`   | INT          | 是  | 0 到 100                                                                                                                                         | 应用光线转移的强度。默认值：100。                                                     |
| `style`                     | COMBO        | 是  | `"standard"`<br />`"darker_but_realistic"`<br />`"clean"`<br />`"smooth"`<br />`"brighter"`<br />`"contrasted_n_hdr"`<br />`"just_composition"` | 风格化输出偏好。                                                               |
| `interpolate_from_original` | BOOLEAN      | 是  | N/A                                                                                                                                             | 限制生成自由度，使其更接近原始图像。默认值：False。                                           |
| `change_background`         | BOOLEAN      | 是  | N/A                                                                                                                                             | 根据提示或参考图像修改背景。默认值：True。                                                |
| `preserve_details`          | BOOLEAN      | 是  | N/A                                                                                                                                             | 保留原始图像的纹理和精细细节。默认值：True。                                               |
| `advanced_settings`         | DYNAMICCOMBO | 是  | `"disabled"`<br />`"enabled"`                                                                                                                   | 用于高级照明控制的微调选项。设置为 `"enabled"` 时，将启用额外参数。                               |
| `reference_image`           | IMAGE        | 否  | N/A                                                                                                                                             | 用于转移照明效果的可选参考图像。如果提供，必须且仅能输入一张图像。最小尺寸为 160x160 像素。宽高比必须在 1:3 到 3:1 之间。 |

**关于高级设置的说明：** 当 `advanced_settings` 设置为 `"enabled"` 时，以下嵌套参数将被激活：

* `whites`：调整图像中最亮的色调。范围：0 到 100。默认值：50。
* `blacks`：调整图像中最暗的色调。范围：0 到 100。默认值：50。
* `brightness`：整体亮度调整。范围：0 到 100。默认值：50。
* `contrast`：对比度调整。范围：0 到 100。默认值：50。
* `saturation`：色彩饱和度调整。范围：0 到 100。默认值：50。
* `engine`：处理引擎选择。选项：`"automatic"`, `"balanced"`, `"cool"`, `"real"`, `"illusio"`, `"fairy"`, `"colorful_anime"`, `"hard_transform"`, `"softy"`。
* `transfer_light_a`：光线转移的强度。选项：`"automatic"`, `"low"`, `"medium"`, `"normal"`, `"high"`, `"high_on_faces"`。
* `transfer_light_b`：同样修改光线转移强度。可与前一个控制项结合以产生不同效果。选项：`"automatic"`, `"composition"`, `"straight"`, `"smooth_in"`, `"smooth_out"`, `"smooth_both"`, `"reverse_both"`, `"soft_in"`, `"soft_out"`, `"soft_mid"`, `"style_shift"`, `"strong_shift"`。
* `fixed_generation`：确保使用相同设置时输出结果一致。默认值：True。

## 输出

| 输出名称    | 数据类型  | 描述        |
| ------- | ----- | --------- |
| `image` | IMAGE | 重新照明后的图像。 |