跳到主要内容

OpenAI

概述​

Open WebUI 可以轻松连接到 OpenAI 和 Azure OpenAI。本指南将引导您完成添加 API Key、设置正确的端点并选择模型的操作，以便您可以立即开始对话。

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

重要提示：关注协议而非提供商​

Open WebUI 是一个**以协议为中心（Protocol-centric）**的平台。尽管我们对 OpenAI 模型提供了卓越的支持，但我们主要是通过 OpenAI Chat Completions API 协议来实现的。

我们专注于在数十个提供商之间共享的通用标准，并对像 Open Responses 这样的新兴标准提供实验性支持。有关详细解释，请参阅我们 关于协议支持的 FAQ。

步骤 1：获取您的 OpenAI API Key​

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

一旦 Open WebUI 启动并运行：

  1. 转到 ⚙️ 管理员设置。
  2. 导航至 外部连接 > OpenAI > 管理（查找扳手图标）。
  3. 点击 ➕ 添加新连接。
  • 连接类型 (Connection Type)：外部 (External)
  • URL：https://api.openai.com/v1
  • API Key：您的机密 Key（以 sk-... 开头）

高级配置​

  • 模型 ID (过滤)：

    • 默认 (留空)：自动检测提供商所有可用的模型。
    • 设置：充当白名单。只有在此处输入的特定模型 ID 才会对普通用户可见。使用此项可以隐藏老旧或昂贵的模型。

  • 前缀 ID (Prefix ID)：

    • 如果您连接了多个拥有相同模型名称的提供商（例如两个提供商都提供 llama3），请在此处添加前缀（例如 groq/）以示区分。该模型将显示为 groq/llama3。
  1. 点击 保存 ✅。

这会安全地存储您的凭证信息。

连接超时配置

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

# 针对慢速网络增加超时时间（默认是 10 秒）
AIOHTTP_CLIENT_TIMEOUT_MODEL_LIST=15

如果您保存了一个无法访问的 URL 并导致 UI 变得无响应，请参阅 模型列表加载问题 故障排除指南以了解恢复选项。

OpenAI Connection Screen

步骤 3：开始使用模型​

一旦您的连接被保存，您就可以直接在 Open WebUI 中开始使用模型了。

🧠 您不需要下载任何模型——只需在模型选择器中选择一个即可开始对话。如果您的提供商支持该模型，您就可以通过其 API 立即使用它。

下面是模型选择器的外观示例：

OpenAI Model Selector

只需选择 GPT-4, o3-mini，或您的提供商提供的任何兼容模型即可。

准备就绪！​

大功告成！您的 OpenAI API 连接已准备就绪。

如果您还想要连接其他提供商，请参阅 Anthropic (Claude) 指南，或针对 Google Gemini, Mistral, Groq, DeepSeek 等的 兼容 OpenAI 的提供商 指南。

如果您遇到任何问题或需要额外支持，请访问我们的 排错帮助部分。

祝您提问愉快！ 🎉

This content is for informational purposes only and does not constitute a warranty, guarantee, or contractual commitment. Open WebUI is provided "as is." See your license for applicable terms.