跳到主要内容

OpenAI

概览​

Open WebUI 可以轻松连接 OpenAI 和 Azure OpenAI。本指南会带你完成 API key 配置、正确端点填写与模型选择，让你马上开始聊天。

对于其他提供兼容 OpenAI API 的提供商（如 Google Gemini、Mistral、Groq、DeepSeek 等），请参见 兼容 OpenAI 的提供商 指南。至于 Anthropic 的 Claude 模型，请参阅专门的 Anthropic（Claude） 指南。

重要：我们支持的是协议，而不是厂商私有实现​

Open WebUI 是一个以协议为中心的平台。虽然我们为 OpenAI 模型提供了一流支持，但本质上主要还是通过 OpenAI 聊天补全 API 协议来实现。

我们优先支持被几十家提供商共同采用的通用标准，并对 Open Responses 这类新兴标准提供实验性支持。关于这一设计思路的详细解释，请参见 协议支持 FAQ。

第 1 步：获取你的 OpenAI API key​

第 2 步：在 Open WebUI 中添加 API 连接​

当 Open WebUI 已经运行后：

  1. 进入 ⚙️ Admin Settings。
  2. 打开 Connections > OpenAI > Manage（查找扳手图标）。
  3. 点击 ➕ Add New Connection。
  • Connection Type：External
  • URL：https://api.openai.com/v1
  • API Key：你的密钥（通常以 sk-... 开头）

高级配置​

  • Model IDs (Filter)：

    • 默认（留空）：自动检测提供商中的全部可用模型。

  • 填写后：作为白名单 生效。只有这里列出的模型 ID 会对用户可见，适合隐藏旧模型或高成本模型。

  • Prefix ID：

    • 如果你连接了多个提供商，而它们刚好存在同名模型（例如都提供 llama3），可在这里加上前缀（如 groq/）用于区分。模型将显示为 groq/llama3。
  1. 点击 Save ✅。

这样你的凭据就会被安全保存。

连接超时配置

如果你的 API 提供商响应较慢，或你遇到了超时问题，可以调整模型列表获取超时：

# 针对慢网络提高超时（默认 10 秒）
AIOHTTP_CLIENT_TIMEOUT_MODEL_LIST=15

如果你保存了一个不可达 URL，导致界面卡住，请参见 模型列表加载问题 故障排查页面。

OpenAI 连接界面

第 3 步：开始使用模型​

保存连接后，你就可以直接在 Open WebUI 内使用模型。

🧠 无需下载任何模型——只要在模型选择器中选择一个模型并开始聊天即可。只要提供商支持该模型，你就能通过其 API 立即使用它。

模型选择界面如下：

OpenAI 模型选择器

只需选择 GPT-4、o3-mini 或提供商支持的任意兼容模型即可。

一切就绪！​

就是这样！你的 OpenAI API 连接已经可以使用了。

如果还想连接其他提供商，请查看 Anthropic（Claude） 指南，或 兼容 OpenAI 的提供商 指南，了解 Google Gemini、Mistral、Groq、DeepSeek 等更多方案。

如果你遇到问题或需要更多支持，请访问我们的帮助页面。

祝你提示愉快！🎉

本内容仅供参考，不构成任何保证、担保或合同承诺。Open WebUI 按“现状”提供。请参阅您的许可协议 以了解适用条款。