> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-mintlify-b90d3c69.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.

# Magnific Image Relight 节点

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

## 输入

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

**高级设置说明：** 当 `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 |

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

***

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