Open WebUI API Key 配置
Open WebUI API Key 怎么填:Connections 配置
在管理后台的 Connections 里按下面这几项填好,换上你自己的 API Key,Open WebUI 就能用 Claude 模型了,按量付费。
Admin Panel → Settings → Connections → OpenAI API → +
URL: https://api.aicodewith.ai/v1
API Key: sk-***
Save → new chat → model selector → claude-haiku-4-5-20251001配置步骤
一键长期设置 Key
这个工具把 Key 保存在自己的设置里。登录后复制 Key,贴进下面步骤里的 API Key 输入框。
sk-***没登录时只显示占位符。登录后会自动填你的 Key。 去控制台取 Key
复制成功只表示命令已复制到剪贴板。还要在终端执行,或把 Key 贴进工具设置。 获取 API Key 教程
以下步骤在 Linux 上实测(Open WebUI v0.12.0)。macOS 和 Windows 还没实测,暂不列出。
还没装 Open WebUI?先安装(装过可跳过)
运行
uv tool install open-webui,再运行uv tool list | grep open-webui,列出 open-webui 和版本号就装好了。然后运行open-webui serve,在浏览器打开终端里显示的地址。终端里运行 uv tool list | grep open-webui,确认已安装 Open WebUI v0.12.0(红框为版本号) 点左下角头像,进入 Admin Panel
打开 Open WebUI 首页,点左下角头像,在菜单里点 Admin Panel。
打开 Open WebUI 首页,点击左下角头像,菜单中的 Admin Panel 即管理后台入口(红框) 点顶部的 Settings
进入 Admin Panel 后,点顶部的 Settings 标签。
进入 Admin Panel 后,点击顶部的 Settings 标签(红框) 点左侧的 Connections
在设置页左侧 AI 分组下点 Connections,能看到 OpenAI API 区域就对了。
在打开的设置页面中,点击左侧 AI 分组下的 Connections(红框) 添加连接,填入 URL 和你的 API Key
在 OpenAI API 区域点右侧 +,URL 填
https://api.aicodewith.ai/v1,API Key 粘贴你的 Key(获取 API Key),点 Save。在 OpenAI API 区域点右侧 +,打开 Add Connection:URL 填 https://api.aicodewith.ai/v1,API Key 粘贴你的 Key,点 Save 确认连接已启用
保存后,OpenAI API 下出现
https://api.aicodewith.ai/v1这条连接,开关是开着的就对了。保存后,OpenAI API 下出现 https://api.aicodewith.ai/v1 这条连接,并且已启用(红框) 想再核对一遍?点齿轮看连接
点连接旁的齿轮打开 Edit Connection,可以核对 URL;API Key 会用圆点遮住。
点击连接旁的齿轮打开 Edit Connection:URL 填 https://api.aicodewith.ai/v1,下方为已用圆点遮盖的 API Key(Bearer) 新对话里选模型
新开对话,点模型选择器,列表里出现
claude-haiku-4-5-20251001等模型,说明 URL 填对了;Key 对不对,看第 9 步能不能收到回复。点击页面底部的模型选择器,列表中出现 aicodewith 提供的模型,红框为 claude-haiku-4-5-20251001 发一条消息测试
选
claude-haiku-4-5-20251001,发送Reply with exactly: Hello from aicodewith.ai,收到Hello from aicodewith.ai就配好了。选择 claude-haiku-4-5-20251001 并发送 “Reply with exactly: Hello from aicodewith.ai”,模型回复 Hello from aicodewith.ai(红框) URL 填错会怎样:OpenAI: Network Problem
如果 URL 填错(例如
https://api.aicodewith.ai/nope),点验证(刷新图标)后右上角会弹出OpenAI: Network Problem。改法见常见报错。URL 写错(比如末尾写成 /nope)时,点验证(刷新图标),右上角弹出 "OpenAI: Network Problem"(红框) 把 URL 改回 /v1,恢复正常回复
把 URL 改回
https://api.aicodewith.ai/v1并保存,新开对话再发一次,收到Hello from aicodewith.ai就恢复了。把 URL 改回 https://api.aicodewith.ai/v1 并保存后,新对话再次正常回复 Hello from aicodewith.ai,配置已恢复
常见报错
OpenAI: Network Problem
出现什么
OpenAI: Network Problem
- 原因
- 连接里的 URL 填错了(例如 https://api.aicodewith.ai/nope),点验证(刷新图标)时连不上
- 怎么改
- 把 URL 改成 https://api.aicodewith.ai/v1 并保存,新对话就能正常回复
回到第 5 步:添加连接,填入 URL 和你的 API Key →
常见问题
Open WebUI 怎么用自己的 API Key?
在 Admin Panel → Settings → Connections 的 OpenAI API 区域点 +,URL 填 https://api.aicodewith.ai/v1,API Key 粘贴你的 Key,保存即可。
Open WebUI 的 API Key 要每次重新填吗?
不用。Key 存在 Open WebUI 自己的数据库里,重启服务后仍然有效,不需要设环境变量。
怎么查看 Open WebUI 版本?
open-webui 没有 --version 参数。用 uv 安装的话,运行 uv tool list | grep open-webui 查看。
Open WebUI 提示 OpenAI: Network Problem 怎么办?
连接里的 URL 填错了,改成 https://api.aicodewith.ai/v1 并保存,见上面的常见报错。