> ## 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.

# MagnificImageUpscalerPreciseV2Node - ComfyUI Built-in Node Documentation

> Complete documentation for the MagnificImageUpscalerPreciseV2Node 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/MagnificImageUpscalerPreciseV2Node/zh.md)

## 概述

Magnific Image Upscale (Precise V2) 节点执行高保真图像放大，可精确控制锐度、颗粒感和细节增强。它通过外部 API 处理图像，支持最大输出分辨率达 10060×10060 像素。该节点提供不同的处理风格，并且如果请求的输出尺寸超过允许的最大尺寸，可以自动对输入进行降尺度处理。

## 输入

| 参数               | 数据类型    | 必填 | 范围                                                 | 描述                                                                                     |
| ---------------- | ------- | -- | -------------------------------------------------- | -------------------------------------------------------------------------------------- |
| `image`          | IMAGE   | 是  | -                                                  | 待放大的输入图像。必须且仅能输入一张图像。最小尺寸为 160x160 像素。宽高比必须在 1:3 到 3:1 之间。                             |
| `scale_factor`   | STRING  | 是  | `"2x"`<br />`"4x"`<br />`"8x"`<br />`"16x"`        | 期望的放大倍数。                                                                               |
| `flavor`         | STRING  | 是  | `"sublime"`<br />`"photo"`<br />`"photo_denoiser"` | 处理风格。"sublime" 适用于通用场景，"photo" 针对照片优化，"photo\_denoiser" 适用于有噪点的照片。                     |
| `sharpen`        | INT     | 否  | 0 到 100                                            | 控制图像锐化强度以增强边缘清晰度和整体清晰度。值越高，结果越锐利。默认值：7。                                                |
| `smart_grain`    | INT     | 否  | 0 到 100                                            | 添加智能颗粒或纹理增强，防止放大后的图像看起来过于平滑或人工化。默认值：7。                                                 |
| `ultra_detail`   | INT     | 否  | 0 到 100                                            | 控制在放大过程中添加的精细细节、纹理和微观细节的数量。默认值：30。                                                     |
| `auto_downscale` | BOOLEAN | 否  | -                                                  | 启用后，如果计算出的输出尺寸超过允许的最大分辨率 10060x10060 像素，节点将自动对输入图像进行降尺度处理。这有助于防止错误，但可能会影响质量。默认值：False。 |

**注意：** 如果 `auto_downscale` 被禁用，且请求的输出尺寸（输入尺寸 × `scale_factor`）超过 10060x10060 像素，节点将引发错误。

## 输出

| 输出名称    | 数据类型  | 描述        |
| ------- | ----- | --------- |
| `image` | IMAGE | 放大后的结果图像。 |