Stable Diffusion WebUI Forge中Hi-Res修复功能的API调用详解

在使用Stable Diffusion WebUI Forge进行AI图像生成时，Hi-Res修复(高分辨率修复)是一个非常有用的功能，它能够显著提升生成图像的质量和细节。然而，许多开发者在通过API调用这一功能时遇到了问题。本文将详细介绍如何正确通过API使用Hi-Res修复功能。

Hi-Res修复功能简介

Hi-Res修复是Stable Diffusion中的一项增强功能，它通过两阶段处理来提升图像质量：

1. 首先生成一个基础分辨率图像
2. 然后对图像进行放大并添加更多细节

这种处理方式比直接生成高分辨率图像更节省显存，同时能获得更好的细节表现。

常见API调用错误

许多开发者在使用API调用Hi-Res修复功能时，会错误地使用"hires_fix": true参数。实际上，正确的参数名是"enable_hr": true。这个命名差异是导致API调用失败的主要原因。

正确的API调用参数

以下是完整的Hi-Res修复API调用参数示例：

{
    "prompt": "输入提示词",
    "negative_prompt": "负面提示词",
    "sampler_name": "DPM++ 2M SDE",
    "scheduler_name": "karras",
    "steps": 15,
    "cfg_scale": 5,
    "seed": 6302954713490123530,
    "width": 768,
    "height": 768,
    "clip_skip": 2,
    "enable_hr": true,
    "hr_scale": 2,
    "denoising_strength": 0.7,
    "hr_upscaler": "R-ESRGAN 4x+",
    "hr_second_pass_steps": 5,
    "hr_additional_modules": ["Use same choices"]
}

关键参数说明

1. enable_hr: 必须设置为true才能启用Hi-Res修复功能
2. hr_scale: 放大倍数，例如2表示将图像放大2倍
3. denoising_strength: 去噪强度，控制第二阶段的修改程度，建议值0.5-0.7
4. hr_upscaler: 使用的放大算法，常见的有"R-ESRGAN 4x+"等
5. hr_second_pass_steps: 第二阶段处理的步数
6. hr_additional_modules: 必须包含的附加模块设置

注意事项

1. 避免在参数中使用Unicode字符引用，直接使用标准字符
2. 确保所有参数名称拼写正确
3. 分辨率设置要合理，过高的分辨率可能导致显存不足
4. 去噪强度不宜过高，否则可能导致图像内容发生较大变化

通过正确设置这些参数，开发者可以充分利用Stable Diffusion WebUI Forge的Hi-Res修复功能，通过API生成更高质量的图像。