SD-WebUI-Regional-Prompter插件API调用指南

概述

SD-WebUI-Regional-Prompter是一款功能强大的Stable Diffusion WebUI插件，它允许用户通过区域划分的方式对图像生成进行更精细的控制。本文将详细介绍如何通过API调用该插件的各项功能。

API调用基础

要使用API调用Regional Prompter插件，需要在请求体中包含特定的参数结构。基本调用格式如下：

{
  "prompt": "主提示词",
  "alwayson_scripts": {
    "Regional Prompter": {
      "args": [
        {
          "active": true
        }
      ]
    }
  }
}

高级参数配置

除了基本的激活状态，API还支持配置插件的各项参数：

{
  "prompt": "区域1提示词 BREAK 区域2提示词 BREAK 区域3提示词",
  "alwayson_scripts": {
    "Regional Prompter": {
      "args": [
        {
          "active": true,
          "use_base_prompt": false,
          "divide_mode": "Vertical",
          "divide_ratio": [1, 1, 1],
          "base_ratio": 0.5
        }
      ]
    }
  }
}

参数详解

1. active：布尔值，控制插件是否启用
2. use_base_prompt：布尔值，决定是否使用基础提示词
3. divide_mode：字符串，区域划分模式，可选"Vertical"(垂直)或"Horizontal"(水平)
4. divide_ratio：数组，定义各区域的相对比例
5. base_ratio：浮点数，基础提示词的影响权重

提示词分割语法

在prompt字段中，使用"BREAK"关键字来分隔不同区域的提示词：

"prompt": "天空 BREAK 山脉 BREAK 湖泊"

这表示将图像分为三个区域，分别应用"天空"、"山脉"和"湖泊"的提示词。

实际应用建议

1. 区域比例调整：通过调整divide_ratio数组中的数值，可以控制各区域在图像中的占比
2. 混合模式：结合use_base_prompt和base_ratio参数，可以实现全局提示词与区域提示词的混合效果
3. 多区域控制：理论上可以通过增加BREAK分隔符和divide_ratio元素来创建任意数量的区域

注意事项

1. 确保BREAK关键字全部大写
2. divide_ratio数组的长度应与BREAK分隔的区域数量一致
3. 某些参数组合可能会产生意外结果，建议先在WebUI界面测试后再通过API调用

通过合理配置这些参数，开发者可以精确控制图像生成的各个区域，实现更复杂的创意效果。