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
  • 行为：这会启动一个一次性聊天会话，不保存历史记录或应用高级配置。
    • 注意：出于隐私考虑，临时聊天中的文档处理仅在前端进行。可能不完全支持需要后端解析的复杂文件（例如 DOCX）。

9. 代码解释器​

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

10. 图像生成​

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

临时聊天会话 假设用户想要启动一个不保存历史记录的快速聊天会话。他们可以通过在 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"。
  • 将聊天标记为临时，避免保存任何历史记录。