Skip to main content

🔗 URL 参数

在 Open WebUI 中，可以通过各种 URL 参数自定义聊天会话。这些参数允许您设置特定配置、启用功能，并在每个聊天基础上定义模型设置。这种方法直接从 URL 提供对单个聊天会话的灵活性和控制。

URL 参数概述​

下表列出了可用的 URL 参数、它们的功能和示例用法。

参数描述示例
models指定要使用的模型，作为逗号分隔的列表。/?models=model1,model2
model指定用于聊天会话的单个模型。/?model=model1
youtube指定要在聊天中转录的 YouTube 视频 ID。/?youtube=VIDEO_ID
load-url指定要获取并作为文档在聊天中上传的网站 URL。/?load-url=https://google.com
web-search如果设置为 true，则启用网络搜索功能。/?web-search=true
tools 或 tool-ids指定要在聊天中激活的工具 ID 的逗号分隔列表。/?tools=tool1,tool2
call如果设置为 true，则启用通话叠加。/?call=true
q为聊天设置初始查询或提示。/?q=Hello%20there
temporary-chat如果设置为 true，则将聊天标记为临时，用于一次性会话。/?temporary-chat=true
code-interpreter如果设置为 true，则启用代码解释器功能。/?code-interpreter=true
image-generation如果设置为 true，则启用图像生成功能。/?image-generation=true

1. 模型和模型选择​

  • 描述：models 和 model 参数允许您指定特定聊天会话应使用哪些语言模型。
  • 如何设置：您可以使用 models 来指定多个模型，或使用 model 来指定单个模型。
  • 示例：
    • /?models=model1,model2 – 这使用 model1 和 model2 初始化聊天。
    • /?model=model1 – 这将 model1 设置为聊天的唯一模型。

2. YouTube 转录​

  • 描述：youtube 参数接受 YouTube 视频 ID，使聊天能够转录指定的视频。
  • 如何设置：使用 YouTube 视频 ID 作为此参数的值。
  • 示例：/?youtube=VIDEO_ID
  • 行为：这会在聊天中为提供的 YouTube 视频触发转录功能。

3. 网站插入​

  • 描述：load-url 参数下载指定的网站并提取内容以将其作为文档上传到聊天中。
  • 如何设置：使用完整的网站 URL 作为此参数的值。
  • 示例：/?load-url=https://google.com
  • 行为：这会触发指定网站 URL 的插入。

4. 网络搜索​

  • 描述：启用 web-search 允许聊天会话访问网络搜索功能。
  • 如何设置：将此参数设置为 true 以启用网络搜索。
  • 示例：/?web-search=true
  • 行为：如果启用，聊天可以检索网络搜索结果作为其响应的一部分。

5. 工具选择​

  • 描述：tools 或 tool-ids 参数指定要在聊天中激活哪些工具。
  • 如何设置：提供工具 ID 的逗号分隔列表作为参数的值。
  • 示例：/?tools=tool1,tool2 或 /?tool-ids=tool1,tool2
  • 行为：每个工具 ID 都会被匹配并在会话中激活以供用户交互。

6. 通话叠加​

  • 描述：call 参数在聊天界面中启用视频或通话叠加。
  • 如何设置：将参数设置为 true 以启用通话叠加。
  • 示例：/?call=true
  • 行为：激活通话界面叠加，允许实时转录和视频输入等功能。

7. 初始查询提示​

  • 描述：q 参数允许为聊天设置初始查询或提示。
  • 如何设置：将查询或提示文本指定为参数值。
  • 示例：/?q=Hello%20there
  • 行为：聊天从指定的提示开始，自动将其作为第一条消息提交。

8. 临时聊天会话​

  • 描述：temporary-chat 参数将聊天标记为临时会话。这可能会限制保存聊天历史或应用持久设置等功能。
  • 如何设置：将此参数设置为 true 用于临时聊天会话。
  • 示例：/?temporary-chat=true
  • 行为：这启动一个一次性聊天会话，不保存历史或应用高级配置。

9. 代码解释器​

  • 描述：code-interpreter 参数启用代码解释器功能。
  • 如何设置：将此参数设置为 true 以为此新聊天会话启用代码解释器功能。
  • 示例：/?code-interpreter=true
  • 行为：激活代码解释器按钮，以在发送给 LLM 的下一个提示中执行代码解释器。

10. 图像生成​

  • 描述：image-generation 参数为提供的提示启用图像生成。
  • 如何设置：将此参数设置为 true 以为聊天启用图像生成。
  • 示例：/?image-generation=true
  • 行为：激活图像生成按钮以生成图像。
示例用例
临时聊天会话

假设用户想要启动一个快速聊天会话而不保存历史。他们可以通过在 URL 中设置 temporary-chat=true 来实现。这提供了一个适合一次性交互的一次性聊天环境。

同时使用多个参数​

这些 URL 参数可以组合使用以创建高度自定义的聊天会话。例如：

/?models=model1,model2&youtube=VIDEO_ID&web-search=true&tools=tool1,tool2&call=true&q=Hello%20there&temporary-chat=true

此 URL 将：

  • 使用 model1 和 model2 初始化聊天。
  • 启用 YouTube 转录、网络搜索和指定的工具。
  • 显示通话叠加。
  • 设置初始提示为"Hello there"。
  • 将聊天标记为临时，避免任何历史保存。