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 | 设置对话的初始查询或 Prompt。 | /?q=Hello%20there |
temporary-chat | 设置为 true 时，将当前对话标记为一次性使用的临时对话。 | /?temporary-chat=true |
code-interpreter | 设置为 true 时启用代码解释器（Code Interpreter）功能。 | /?code-interpreter=true |
image-generation | 设置为 true 时启用图像生成（Image Generation）功能。 | /?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. 初始查询 Prompt
- 描述：
q参数允许为对话设置一个初始查询或 Prompt。 - 设置方法：指定查询或 Prompt 文本作为参数值。
- 示例：
/?q=Hello%20there - 行为：对话会带着指定的 Prompt 启动，并自动将其作为第一条消息发送。
8. 临时对话会话
- 描述：
temporary-chat参数将对话标记为临时会话。这可能会限制某些功能，例如保存对话历史或应用持久化设置。 - 设置方法：将此参数设置为
true以开启临时对话会话。 - 示例：
/?temporary-chat=true - 行为：启动一个一次性的临时对话会话，不保存历史记录，也不应用高级配置。
- 注意：为了隐私安全，临时对话中的文档处理仅在前端进行。可能无法完全支持需要后端解析的复杂文件（如 DOCX）。
9. 代码解释器（Code Interpreter）
- 描述：
code-interpreter参数启用代码解释器功能。 - 设置方法：将此参数设置为
true以在此新对话会话中启用代码解释器功能。 - 示例：
/?code-interpreter=true - 行为：激活代码解释器按钮，以便在向 LLM 发送下一个 Prompt 时执行代码解释器。
10. 图像生成（Image Generation）
- 描述：
image-generation参数为提供的 Prompt 启用图像生成。 - 设置方法：将此参数设置为
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”作为初始 Prompt。
- 将对话标记为临时对话，避免保存任何历史记录。