简短回答
在 Open WebUI 中使用 APIVAI：进入 Settings > Admin > Connections，在 Manage OpenAI API Connections 列表里添加一个连接，URL 填 https://api.apivai.com/v1，再把 APIVAI 密钥粘贴到 API Key。Open WebUI 会从 /v1/models 读取模型列表，所以 Claude 和 GPT 模型无需额外设置就会出现在模型选择器里，一个密钥两者通用。截至 2026-10-07，通过 APIVAI 使用 Claude Sonnet 4.6 每百万输入 / 输出 token 为 $1.04 / $5.22，官方价为 $3.00 / $15.00。对话可以立即使用；文档检索（RAG）需要另找嵌入模型，因为 APIVAI 不提供嵌入（embeddings）接口。
Open WebUI 是什么？
Open WebUI 是一个自托管的聊天界面，通常用 Docker 运行，支持用户账号、聊天记录、模型预设和文档对话。它本身不带云端模型，而是连接任何支持 OpenAI Chat Completions 协议的服务器——APIVAI 在 https://api.apivai.com/v1 提供的正是这种协议。
本文依据 2026 年 10 月的 Open WebUI 文档编写。如果你的版本中某个标签略有不同，字段本身不变：一个 URL、一个 API 密钥和一个可选的模型 ID 列表。
应该选哪种连接类型？
Open WebUI 通过 OpenAI 连接访问云端模型。它没有填写自定义 Anthropic Messages 地址的字段，内置的 Anthropic 支持只识别 Anthropic 官方地址。所以正确的选择是 OpenAI 格式：
- URL：
https://api.apivai.com/v1（带/v1，且只出现一次） - 模型： Claude 和 GPT 都能用这种格式，一个连接就能覆盖价格页上的所有模型
APIVAI 的 Anthropic 格式地址（https://api.apivai.com，不带 /v1）是给 Claude Code 等基于 Anthropic SDK 的工具用的，在 Open WebUI 中不需要。格式的详细说明见 OpenAI 兼容 API。
如何获取 APIVAI 密钥？
- 用邮箱注册账号。
- 充值，$10 起，支持银行卡、加密货币、支付宝和微信支付。没有订阅，按 token 计费。
- 在控制台创建密钥并复制。可以给密钥单独设置预算上限，多人共用一个 Open WebUI 实例时很有用。
如何一步步把 APIVAI 接入 Open WebUI？
- 用管理员账号登录 Open WebUI。
- 打开 Settings > Admin > Connections，找到 Manage OpenAI API Connections 列表。
- 点击 + Add Connection。
- 按下表填写 URL 和 API Key。Connection Type 保持 External。
- 点击 URL 字段旁的 Verify Connection。Open WebUI 会用你的密钥请求
/models，应显示 Server connection verified。 - 可选：展开 Advanced。在 Model IDs 中输入要提供的模型 ID（例如
claude-sonnet-4-6），每输入一个点一次 +。留空则列出密钥可见的全部模型。Prefix ID 会在模型名前加上类似apivai.的标签，发送请求前 Open WebUI 会自动去掉。Provider 保持 Default。 - 点击 Save。新建对话时，模型会出现在顶部的模型选择器中。
| 字段 | 值 |
|---|---|
| Connection Type | External |
| URL | https://api.apivai.com/v1 |
| API Key | 你的 APIVAI 密钥 |
| Model IDs（Advanced） | 留空表示全部模型，或填 claude-sonnet-4-6、claude-haiku-4-5、gpt-5.5 等 |
| Prefix ID（Advanced） | 可选，例如 apivai |
| Provider（Advanced） | Default |
如何用 Docker 环境变量配置？
如果用 Docker 部署，可以在创建容器时用环境变量传入相同的值：
docker run -d -p 3000:8080 \ -v open-webui:/app/backend/data \ -e WEBUI_SECRET_KEY=your-secret-key \ -e OPENAI_API_BASE_URL=https://api.apivai.com/v1 \ -e OPENAI_API_KEY=你的-apivai-密钥 \ --name open-webui --restart always \ ghcr.io/open-webui/open-webui:main
如果没有运行 Ollama，可以加上 -e ENABLE_OLLAMA_API=False，让 Open WebUI 不再尝试连接它。想通过环境变量限制模型列表，可以用 OPENAI_API_CONFIGS：一个以连接序号为键的 JSON 对象，包含 model_ids、prefix_id 等字段。
需要注意：这些变量属于 ConfigVar。在默认的 ENABLE_PERSISTENT_CONFIG=True 下，通过管理面板保存到数据库的值优先于环境变量。如果之后修改 OPENAI_API_BASE_URL 却没有生效，请直接在 Settings > Admin > Connections 中编辑连接。
应该选哪个模型？
每百万 token 价格，截至 2026-10-07。模型列表会变化，请从 GET https://api.apivai.com/v1/models 或价格页获取 ID，不要照抄旧名称。
| 模型 | 输入 | 输出 | 适用场景 |
|---|---|---|---|
| Claude Sonnet 4.6 | $1.04 | $5.22 | 大多数团队的默认对话模型 |
| Claude Sonnet 5.5 | $0.69 | $3.47 | 更新的 Sonnet，擅长代码和长文档 |
| Claude Opus 5.5 | $1.39 | $6.96 | 最难的问题 |
| Claude Haiku 4.5 | $0.35 | $1.74 | 快速回答和后台任务 |
| GPT-5.5 | $0.77 | $4.56 | GPT 方案 |
| GPT-6 Luna | $0.0144 | $0.0768 | 最便宜的选择 |
如果 Open WebUI 是给团队用的，可以通过 Model IDs 列表只开放你愿意付费的模型。对日常用户隐藏 Opus，是让共享账单可控的最简单方法。
设置便宜的任务模型
Open WebUI 会在后台发出一些小请求，用来生成对话标题、标签、推荐追问和输入自动补全。默认情况下它们使用当前对话的模型，所以用昂贵模型的对话，连标题也按同样的价格计费。在 Settings > Admin > Interface 中把 External Task Model 设为 claude-haiku-4-5 或 gpt-6-luna。
后台请求默认只有 1,000 个输出 token，思考 token 也计入这个额度。如果标题为空或被截断，在同一部分打开 Task Model Parameters > Configure，把 max_tokens 设为 4096。
费用是多少？
APIVAI 从预付余额中按 token 扣费。每次请求的实际大小取决于对话长度，因为 Open WebUI 每条消息都会带上聊天记录。
示例 1：个人使用。 假设每天 40 条消息、持续 30 天，每条约 3,000 输入 token（问题加历史）和 800 输出 token，使用 Claude Sonnet 4.6。共 1,200 条消息，费用 $8.76，官方价为 $25.20。
示例 2：十人团队。 十个人每个工作日各 40 条消息，22 个工作日共 8,800 条：使用 Claude Sonnet 4.6 为 $64.20（官方价 $185），如果大家都用 Claude Haiku 4.5 则为 $21.49。如果任务模型用 Claude Haiku 4.5，每条消息约触发两次后台请求、每次 1,500 输入和 300 输出 token，大约再增加 $18.43。
控制台会列出每次请求的 token 和费用，用几天之后就可以用自己的真实数字代替这些假设。更全面的价格对比见 2026 年 Claude API 价格对比。
文档和知识库能用吗？
通过 APIVAI 与 Claude 和 GPT 对话完全可用。文档检索（RAG）则不同：它需要嵌入（embedding）模型来索引文件，而 APIVAI 不提供嵌入接口。
Open WebUI 默认使用本地的 SentenceTransformers 模型生成嵌入（RAG_EMBEDDING_ENGINE 留空），所以上传的文档无需改动即可继续使用。只是不要把嵌入引擎切换为 OpenAI 并填 APIVAI 的地址。如果需要云端嵌入，请通过 RAG_OPENAI_API_BASE_URL 和 RAG_OPENAI_API_KEY 或在 Settings > Admin > Documents 中单独配置嵌入服务商。回答本身仍由你在 APIVAI 上的对话模型生成。图像生成和语音功能同样需要各自的服务商。
排错
- Verify Connection 返回 401： 密钥错误或不完整。从控制台重新复制，确认密钥未被删除，并确认密钥预算和账户余额没有用完。
- 404： URL 写错了。必须是
https://api.apivai.com/v1：不能是不带/v1的https://api.apivai.com，不能是/v1/v1，不能是/v1/chat/completions这样的完整路径，结尾也不要加斜杠。 - 找不到模型： Model IDs 中的某个 ID 不存在（常见于旧名称或显示名称）。请与
GET /v1/models的结果对照。显示为apivai.claude-sonnet-4-6的模型是正常的，那是你设置的 Prefix ID。 - 回复为空或被截断： 思考默认开启，思考 token 按输出计费。在 Advanced Params 中把
max_tokens设为 4096 或更高——单个对话在 Chat Controls 里设置，所有人统一则在 Workspace > Models 中按模型设置。 - 环境变量好像不生效： 管理面板中保存的值覆盖了它们（见上文 Docker 部分）。
- 429 Too Many Requests： 每个密钥默认每分钟 60 次请求，后台任务也计算在内。使用量大的团队可以给用户分配不同的密钥，或联系客服提高限额。
常见问题
不用 Anthropic 格式，Open WebUI 能用 Claude 吗？
能。APIVAI 在 https://api.apivai.com/v1 以 OpenAI 格式提供 Claude 模型，所以在 Open WebUI 中添加普通的 OpenAI 连接就够了。只有基于 Anthropic SDK 的工具才需要 Anthropic 格式，参见 Claude Code 配置指南。
一个密钥能同时提供 Claude 和 GPT 吗？
能。一个 APIVAI 密钥适用于价格页上的所有模型。用户在对话顶部的模型选择器中切换模型即可。
APIVAI 会保存我们的对话吗？
APIVAI 不记录请求和响应的内容。Open WebUI 的聊天记录保存在你服务器上它自己的数据库中。
每个用户能用自己的密钥吗？
Open WebUI 还提供个人 Direct Connections，用户可在自己的设置中添加，填写相同的 URL 和自己的 APIVAI 密钥。另一种做法是保留一个管理员连接，并在控制台中给这个密钥设置预算上限。
有免费试用吗？
没有。APIVAI 采用预付费、无订阅，最低充值 $10，只为实际使用的 token 付费。其他工具的配置见文档和我们的 LobeChat 指南。
注册账号，充值 $10 起，把密钥粘贴到 Open WebUI 即可。