KoboldCPP项目中SDUI接口参数使用技巧解析

在KoboldCPP项目的Stable Diffusion UI(SDUI)接口使用过程中，开发者发现了一个关于负面提示词(negative prompt)参数传递的技术细节。本文将深入分析这一现象的技术背景和解决方案。

现象描述

开发者在使用SDUI接口时发现，通过URL参数传递正面提示词(prompt)能够正常工作，但直接使用negative_prompt参数却无法生效。经过代码审查发现，SDUI接口确实没有直接实现negative_prompt参数的处理逻辑。

技术背景

SDUI接口源自Stable UI项目，该项目已有一段时间未更新维护。在原始实现中，负面提示词是通过特殊分隔符与正面提示词合并传递的，而非作为独立参数。

解决方案

经过技术分析，正确的负面提示词传递方式应该是：

1. 将正面提示词和负面提示词用" ### "分隔符连接
2. 由于URL中"#"字符有特殊含义，需要进行URL编码转换
3. 最终格式为：prompt=正面提示词%20%23%23%23%20负面提示词

其中：

• %20 代表空格
• %23 代表#字符

实现示例

假设我们需要传递：

• 正面提示词："beautiful landscape"
• 负面提示词："blurry, low quality"

正确的URL参数应为： prompt=beautiful%20landscape%20%23%23%23%20blurry%2C%20low%20quality

技术建议

对于需要自动化调用SDUI接口的场景，建议：

1. 构建完整的提示词字符串时先进行本地拼接
2. 使用URL编码库对特殊字符进行转义
3. 避免手动拼接URL参数，以防编码错误

这种实现方式虽然不够直观，但遵循了原始项目的设计逻辑，确保了接口的兼容性。开发者在使用时应特别注意URL编码规范，确保参数传递的准确性。