OpenWebUI 接入 AI快站 API 配置与模型验证教程

推荐配置

先在终端验证：

curl https://www.aifast.club/v1/models \
  -H "Authorization: Bearer $API_KEY"

然后在 OpenWebUI 管理设置的连接区域添加 OpenAI Compatible 连接：

OpenWebUI 不同版本可能把入口放在“管理员设置 / 连接”“设置 / 模型”或环境变量中。判断配置是否正确，应以最终请求地址和连接测试结果为准。

验证步骤

1. 保存连接后刷新模型列表。
2. 选择一个真实模型 ID。
3. 新建空白会话，只发送“只回复 OK”。
4. 验证普通响应后，再测试流式输出、文件、工具和多模态能力。
5. 在服务端日志中确认请求进入预期接口。

模型列表为空

• 直接请求 /v1/models，确认 Key 和网络可用。
• 检查 OpenWebUI 容器是否能访问外网域名。
• 检查反向代理、DNS 和证书错误。
• 确认连接地址没有重复追加 /v1。

返回 HTML 而不是 JSON

通常说明请求访问了网站页面，而不是 API 路由。检查最终 URL 是否包含正确的 /v1 路径。

流式输出一次性出现

先使用 curl -N 直接请求。如果终端可以逐块显示，而 OpenWebUI 一次性显示，重点检查反向代理缓冲、容器网关和 OpenWebUI 版本。

安全建议

• 为 OpenWebUI 单独创建 API Key。
• 不把 Key 写入公开 Docker Compose、截图或 Git 仓库。
• 多用户环境设置额度和并发限制。
• 定期检查使用日志并轮换异常 Key。