Stable Diffusion WebUI API请求422错误解决方案

问题背景

在使用Stable Diffusion WebUI的txt2img API接口时，开发者可能会遇到422 Unprocessable Entity错误。这种错误通常表示服务器能够理解请求的内容，但无法处理其中包含的指令。

错误现象

当通过JavaScript的fetch方法调用API时，即使请求体中的JSON数据在Postman或Swagger文档中测试正常，前端代码仍可能返回422错误。控制台会显示"ERR_ABORTED 422 (Unprocessable Entity)"的错误信息。

根本原因分析

经过技术分析，发现导致该问题的两个主要原因：

1. CORS配置问题：在fetch请求中错误地设置了mode: "no-cors"选项，这会限制请求头的内容，导致API无法正确解析请求体。

2. 参数拼写错误：常见的拼写错误如将negative_prompt误写为negative_promp，这种细微差别会导致API无法识别参数。

解决方案

1. 修正CORS配置

移除fetch请求中的mode: "no-cors"选项，并确保在启动WebUI时添加正确的CORS配置参数：

python launch.py --cors-allow-origins *

2. 检查参数拼写

仔细核对API文档中的参数名称，特别注意容易拼写错误的参数，如：

• negative_prompt（正确）
• negative_promp（错误）

3. 请求头设置

确保请求头中包含正确的Content-Type：

headers: {
    "Content-Type": "application/json"
}

4. 完整的正确示例代码

const raw = JSON.stringify({
    prompt: "Festive Christmas trees, contagious laughs, ails. Feel the happiness",
    negative_prompt: "ugly, disfigured, low quality, blurry",
    sampler_name: "Euler a",
    steps: 33,
    hr_upscaler: "Latent",
    denoising_strength: 1,
    enable_hr: true,
    hr_scale: 1,
    cfg_scale: 8.5,
    seed: 643405756
});

const requestOptions = {
    method: 'POST',
    headers: {
        "Content-Type": "application/json"
    },
    body: raw
};

fetch("http://127.0.0.1:7860/sdapi/v1/txt2img", requestOptions)
   .then(response => response.json())
   .then(data => console.log(data))
   .catch(error => console.error(error));

进阶建议

1. 使用API调试工具：在开发初期，建议先使用Postman或Swagger UI测试API，确认参数和请求格式正确后再移植到代码中。

2. 参数验证：在发送请求前，可以添加参数验证逻辑，确保所有必填参数都存在且格式正确。

3. 错误处理：完善fetch请求的错误处理逻辑，捕获并解析API返回的错误信息，便于快速定位问题。

4. 类型转换：注意JavaScript对象到JSON字符串的转换，确保数字类型的参数不会被错误地转换为字符串。

通过以上解决方案，开发者应该能够成功调用Stable Diffusion WebUI的txt2img API接口，并获取预期的图像生成结果。