兼容 OpenAI
概览
Open WebUI 可以连接任何实现兼容 OpenAI API 的服务端或提供商。本指南介绍如何为常见的云端提供商与本地服务器配置连接。
如果你要连接的是 OpenAI 本身(或 Azure OpenAI),请参见专门的 OpenAI 指南。
面向协议的设计
Open WebUI 建立在标准协议之上。与其为每个单独的 AI 提供商都开发专用模块(这通常会带来行为不一致和配置膨胀),Open WebUI 更专注于像 OpenAI 聊天补全协议 这样的协议标准。
这意味着,Open WebUI 负责界面与工具层,而你的后端应遵循通用的聊天补全标准。
- 我们支持协议: 只要提供商遵循广泛采用的 API 标准,就能获得原生支持 。我们也对 Open Responses 提供实验性支持。
- 我们避免支持私有 API: 为了保持代码库通用且可维护,我们不会在核心中为每个厂商的非标准私有 API 单独实现适配。对于未原生支持的提供商,请使用 pipe 或 LiteLLM、OpenRouter 等中间代理进行桥接。
关于这一架构决策的完整解释,请参见 协议支持 FAQ。
添加连接时,Open WebUI 会通过标准 Bearer token 调用提供商的 /models 端点进行验证。有些提供商根本不实现 /models 端点,或者对该端点使用了非标准认证方式。在这类情况下:
- 连接验证会报错失败(例如 400、401 或 403)。
- 这并不意味着提供商不兼容——聊天补全依然可以正常工作。
- 你只需要在连接设置中的 Model IDs (Filter) 白名单里手动添加模型名即可。
已知存在 /models 问题的提供商:
| 提供商 | /models 可用吗? | 需要采取的操作 |
|---|---|---|
| Anthropic | 可以——有内置兼容层 | 自动发现可用 |
| GitHub Models | 不可用——使用非标准路径 | 手动把模型 ID 加入白名单 |
| Perplexity | 不可用——没有该端点 | 手动把模型 ID 加入白名单 |
| MiniMax | 不可用——没有该端点 | 手动把模型 ID 加入白名单 |
| OpenRouter | 可以——但会返回海量模型 | 强烈建议使用筛选白名单 |
| Google Gemini | 可以 | 自动发现可用 |
| DeepSeek | 可以 | 自动发现可用 |
| Mistral | 可以 | 自动发现可用 |
| Groq | 可以 | 自动发现可用 |
如何手动添加模型: 在连接设置中找到 Model IDs (Filter),输入模型 ID,点击 + 图标后保存。即使连接验证显示错误,这些模型依然会出现在模型选择器中。
第 1 步:添加提供商连接
- 在浏览器中打开 Open WebUI。
- 进入 ⚙️ Admin Settings → Connections → OpenAI。
- 点击 ➕ Add Connection。
- 填写提供商的 URL 和 API Key(见下方标签页)。输入 URL 时,字段会自动提示常见提供商端点。
- 如果你的提供商不支持
/models自动发现,请把模型 ID 加入 Model IDs (Filter) 白名单。 - 点击 Save。
如果 Open WebUI 运行在 Docker 中,而模型服务在宿主机上,请把 URL 里的 localhost 替换成 host.docker.internal。
每个连接都带有一个开关,你可以在不删除配置的情况下启用或禁用它。适合临时停用某个提供商。
云端提供商
- Anthropic
- Google Gemini
- DeepSeek
- Mistral
- Groq
- Perplexity
- MiniMax
- OpenRouter
- Amazon Bedrock
- Azure OpenAI
- LiteLLM
完整分步说明请查看专门的 Anthropic(Claude) 指南。
Anthropic(Claude)提供兼容 OpenAI 的端点。Open WebUI 内置兼容层,可自动识别 Anthropic URL 并完成模型发现——只要填入 API key,模型就会被自动识别。需要注意的是,这个兼容端点主要面向测试与对比;如果你要在生产环境中使用 Claude 的完整原生能力(PDF 处理、引用、extended thinking、prompt caching),Anthropic 建议使用其原生 API。
| 设置项 | 值 |
|---|---|
| URL | https://api.anthropic.com/v1 |
| API Key | 你在 console.anthropic.com 获取的 Anthropic API key |
| Model IDs | 自动发现——可留空,或筛选到特定模型 |
Google Gemini 提供兼容 OpenAI 的端点,并可与 Open WebUI 良好协作。
| 设置项 | 值 |
|---|---|
| URL | https://generativelanguage.googleapis.com/v1beta/openai |
| API Key | 你在 aistudio.google.com 获取的 Gemini API key |
| Model IDs | 自动发现——可留空,或筛选到特定模型 |
URL 必须严格写成 https://generativelanguage.googleapis.com/v1beta/openai —— 末尾不要带 /。多出的斜杠会导致 /models 调用失败。
DeepSeek 完全兼容 OpenAI,并支持 /models 自动发现。
| 设置项 | 值 |
|---|---|
| URL | https://api.deepseek.com/v1 |
| API Key | 你在 platform.deepseek.com 获取的 API key |
| Model IDs | 自动发现(例如 deepseek-chat、deepseek-reasoner) |
Mistral AI 完全兼容 OpenAI,并支持 /models 自动发现。
| 设置项 | 值 |
|---|---|
| URL | https://api.mistral.ai/v1 |
| API Key | 你在 console.mistral.ai 获取的 API key |
| Model IDs | 自动发现(例如 mistral-large-latest、codestral-latest、mistral-small-latest) |
Groq 通过兼容 OpenAI 的 API 提供极快的推理速度。
| 设置项 | 值 |
|---|---|
| URL | https://api.groq.com/openai/v1 |
| API Key | 你在 console.groq.com 获取的 API key |
| Model IDs | 自动发现(例如 llama-3.3-70b-versatile、deepseek-r1-distill-llama-70b) |
Perplexity 通过兼容 OpenAI 的聊天补全端点提供带搜索增强的 AI 模型。
| 设置项 | 值 |
|---|---|
| URL | https://api.perplexity.ai |
| API Key | 你在 perplexity.ai/settings(API 标签页)获取的 API key |
| Model IDs | 必须手动填写——例如 sonar-pro、sonar-reasoning-pro、sonar-deep-research |
Perplexity 没有 /models 端点 。你必须手动把模型 ID 加入白名单。另外,一些 Perplexity 模型可能不接受 stop 或 frequency_penalty 等参数。
MiniMax 是一家专注高性能模型的 AI 公司,其 MiniMax M2.5 尤其针对代码、推理和多轮对话做了优化。其 Coding Plan 订阅对于高频编程使用场景,相比按量计费通常更具性价比。
| 设置项 | 值 |
|---|---|
| URL | https://api.minimax.io/v1 |
| API Key | 你的 Coding Plan API key(见下方第 2 步) |
| Model IDs | 必须手动填写——例如 MiniMax-M2.5 |
第 1 步:订阅 MiniMax Coding Plan
- 打开 MiniMax Coding Plan 订阅页。
- 选择适合你的计划(例如每月 10 美元的 Starter)。
- 完成订阅流程。
Starter 计划每 5 小时提供 100 次 “prompts”。一次 prompt 大约相当于 15 次请求,相较按 token 计费具有较高性价比。详见 MiniMax Coding Plan 官方文档。
第 2 步:获取 Coding Plan API key
订阅后,你需要获取这个专用 API key。
- 打开 Account/Coding Plan 页面。
- 点击 Reset & Copy,生成并复制 API key。
- 请把它安全保存到密码管理器中。

这个 API key 仅适用于 Coding Plan,不能与标准按量计费 API key 互换使用。
第 3 步:在 Open WebUI 中配置连接
- 打开 Open WebUI,进入 Admin Panel > Settings > Connections。
- 点击 OpenAI API 区域下的 + 图标。
- 填写上表中的 URL 和 API key。
- 重要: MiniMax 不提供
/models端点,所以你必须手动添加模型。 - 在 Model IDs (Filter) 中输入
MiniMax-M2.5,然后点击 + 图标。 - 点击 Verify Connection(你应看到成功提示)。
- 点击 Save。

第 4 步:开始聊天
在模型下拉框中选择 MiniMax-M2.5 并开始聊天。推理与思考模式默认即可正常工作,无需额外配置。

OpenRouter 在单一 API 后汇聚了来自多个提供商的数百种模型。
| 设置项 | 值 |
|---|---|
| URL | https://openrouter.ai/api/v1 |
| API Key | 你在 openrouter.ai/keys 获取的 API key |
| Model IDs | 强烈建议填写——添加一个筛选白名单 |
OpenRouter 会暴露成千上万个模型,这会让模型选择器非常混乱,也会拖慢管理界面。我们强烈建议:
- 使用白名单——只添加你真正需要的模型 ID(例如
anthropic/claude-sonnet-4-5、google/gemini-2.5-pro)。 - 通过
Settings > Connections > Cache Base Model List或ENABLE_BASE_MODELS_CACHE=True启用模型缓存。若不缓存,页面加载可能需要 10–15 秒甚至更久。详见性能指南。
Amazon Bedrock 是 AWS 的托管服务,通过单一 API 提供多家 AI 公司的基础模型(Anthropic、Meta、Mistral、Cohere、Stability AI、Amazon 等)。
将 Open WebUI 接入 AWS Bedrock,有多种兼容 OpenAI 的方式:
- Bedrock Access Gateway(BAG)
- stdapi.ai
- LiteLLM 搭配 Bedrock 提供商(LiteLLM 并非专门为 AWS 设计)
- Bedrock Mantle —— AWS 原生方案,无需额外安装
功能对比
| 能力 | Bedrock Access Gateway (BAG) | stdapi.ai | LiteLLM(Bedrock 提供商) | AWS Bedrock Mantle |
|---|---|---|---|---|
| 自动发现模型 | ✅ | ✅ | — | ✅ |
| 聊天补全 | ✅ | ✅ | ✅ | ✅ |
| 嵌入 | ✅ | ✅ | ✅ | — |
| 文本转语音 | — | ✅ | — | — |
| 语音转文本 | — | ✅ | — | — |
| 图片生成 | — | ✅ | ✅ | — |
| 图片编辑 | — | ✅ | — | — |
| 多区域模型访问 | — | ✅ | ✅ | — |
| 无需安装 | — | — | — | ✅ |
| 许可 | MIT | AGPL 或商业版 | MIT 或商业版 | AWS 服务 |
方案 1:Bedrock Access Gateway (BAG)
前置要求
- 有效的 AWS 账户
- 可用的 AWS Access Key 和 Secret Key
- 在 AWS 中拥有启用 Bedrock 模型的 IAM 权限(或相关模型已启用)
- 系统中已安装 Docker
第 1 步:配置 Bedrock Access Gateway
BAG 是 AWS 开发的代理,它包装原生 Bedrock SDK,并暴露兼容 OpenAI 的端点。端点映射如下:
| OpenAI 端点 | Bedrock 方法 |
|---|---|
/models | list_inference_profiles |
/models/{model_id} | list_inference_profiles |
/chat/completions | converse 或 converse_stream |
/embeddings | invoke_model |
按照 Bedrock Access Gateway 仓库 中的说明搭建 BAG:
git clone https://github.com/aws-samples/bedrock-access-gateway
cd bedrock-access-gateway
# 使用 ECS Dockerfile
mv Dockerfile_ecs Dockerfile
docker build . -f Dockerfile -t bedrock-gateway
docker run -e AWS_ACCESS_KEY_ID=$AWS_ACCESS_KEY_ID \
-e AWS_SECRET_ACCESS_KEY=$AWS_SECRET_ACCESS_KEY \
-e AWS_SESSION_TOKEN=$AWS_SESSION_TOKEN \
-e AWS_REGION=us-east-1 \
-d -p 8000:80 bedrock-gateway打开 http://localhost:8000/docs 上的 Swagger 页面,验证 gateway 已经正常运行。
如果容器启动后马上退出(尤其在 Windows 上),请先用 docker logs <container_id> 查看日志。若看到 Python/Uvicorn 相关错误,很可能是 Python 3.13 兼容性问题。请在构建前修改 Dockerfile,把 python:3.13-slim 改为 python:3.12-slim,然后重新构建。

第 2 步:在 Open WebUI 中添加连接
- 在 Admin Panel 中进入 Settings → Connections。
- 使用 + 按钮在 OpenAI 下新增连接。
- URL 填写
http://host.docker.internal:8000/api/v1。 - API Key 填写 BAG 默认设置中的
bedrock(你也可以通过 BAG 的DEFAULT_API_KEYS修改)。 - 点击 Verify Connection——你应看到 “Server connection verified” 提示。

其他有帮助的教程