在 Open WebUI 中使用 Ace Data Cloud
内容提要
本文介绍如何在Open WebUI中接入Ace Data Cloud，通过配置OpenAI兼容端点，使用一个API Token访问60多种大模型。内容包括申请Token、Docker部署、环境变量设置、界面添加连接、推荐模型、curl验证、知识库与多用户管理，以及常见问题解决。
延伸解读
路径规则易错点
配置OpenAI兼容端点时，Base URL的路径必须正确。文中明确指出，若写成`https://api.acedata.cloud/openai/v1`会导致404，因为该路径下没有`/v1`。正确写法是`https://api.acedata.cloud/v1`或`https://api.acedata.cloud/openai`。遇到连接错误时，应优先检查此项。
验证与排错方法
当Open WebUI连接失败时，可用curl直接请求`/v1/chat/completions`来区分是端点问题还是客户端问题。若返回HTTP 403且提示`used_up`，说明Token有效但余额不足，需充值。这有助于快速定位问题，避免盲目调整配置。
多用户与安全建议
Open WebUI支持多用户和RBAC，建议将默认用户角色设为`pending`，新用户需审核后才能使用，防止外人随意注册消耗额度。此外，知识库文档仅存于本地服务器，只有命中的片段会发送给模型，兼顾了数据隐私与成本控制。
Q&A
如何在 Open WebUI 中接入 Ace Data Cloud？
首先在 Ace Data Cloud 控制台获取 API Token，然后通过 Docker 部署 Open WebUI 并设置环境变量 OPENAI_API_BASE_URL=https://api.acedata.cloud/v1 和 OPENAI_API_KEY=你的Token，最后在界面中验证连接即可。
Open WebUI 接入 Ace Data Cloud 需要哪些环境变量？
需要设置 OPENAI_API_BASE_URL（Ace Data Cloud 入口，必须以 /v1 结尾）、OPENAI_API_KEY（你的 Token）和 WEBUI_SECRET_KEY（session 加密密钥，可自动生成）。
Open WebUI 中如何验证 Ace Data Cloud 连接是否成功？
登录 Open WebUI 后，进入 Admin Panel → Settings → Connections，点击「Verify Connection」验证；也可以使用 curl 命令直接调用 https://api.acedata.cloud/v1/chat/completions 接口，返回 OpenAI 兼容对象即表示成功。
Ace Data Cloud 支持哪些模型？
Ace Data Cloud 支持 60+ 大模型，包括 GPT（gpt-5、gpt-4o）、Claude（claude-opus-4-8）、Gemini（gemini-3.1-pro）、Grok（grok-4）、DeepSeek（deepseek-v3）、Kimi（kimi-k3）等，具体以服务文档为准。
Open WebUI 中如何配置知识库（RAG）？
在 Open WebUI 的知识库设置中，嵌入模型选择 text-embedding-3-large（通过 Ace Data Cloud），文档原文只存在服务器上，仅命中的片段会发给模型。
Open WebUI 中如何管理多用户？
在 Admin Panel → Users 中可以管理用户角色（Pending / User / Admin），建议将「Default User Role」设为 pending，新用户需审核后才能使用，避免外人随意注册消耗额度。
Open WebUI 接入 Ace Data Cloud 时出现 Connection error / 404 怎么办？
通常是 OPENAI_API_BASE_URL 写成了 .../openai/v1 或漏了 /v1，应改为 https://api.acedata.cloud/v1。
Open WebUI 容器重启后数据丢失怎么办？
启动时需挂载数据卷 -v open-webui:/app/backend/data，以持久化对话和用户数据。
