简短回答
在 LobeHub（原 LobeChat）中使用 APIVAI：打开 App Settings → AI Providers，选择 Add Custom Provider，把 Request Format 设为 OpenAI，Proxy URL 填 https://api.apivai.com/v1，再把 APIVAI 密钥粘贴到 API Key；然后拉取或手动添加 claude-sonnet-4-6、gpt-5.5 等模型 ID。如果只用 Claude，也可以在内置 Anthropic 服务商的 API Proxy URL 中填 https://api.apivai.com（不带 /v1）。截至 2026-10-07，通过 APIVAI 使用 Claude Sonnet 4.6 每百万输入 / 输出 token 为 $1.04 / $5.22，官方价为 $3.00 / $15.00。自托管的 Docker 部署可以用 OPENAI_PROXY_URL 和 OPENAI_API_KEY，或 ANTHROPIC_PROXY_URL 和 ANTHROPIC_API_KEY 设置相同的值。
LobeHub 是什么？和 LobeChat 是同一个东西吗？
是的。LobeChat 现在叫 LobeHub：GitHub 仓库 lobehub/lobe-chat 会跳转到 lobehub/lobehub，文档使用新名称，Docker 镜像是 lobehub/lobehub。它是一个开源的聊天和智能体（Agent）应用，可以在网页上用、作为桌面应用用，也可以自行部署。每个智能体可以选择服务商和模型，所以一个任务用 Claude、另一个任务用 GPT 都没问题。
本文依据 2026 年 10 月的 LobeHub 文档和界面标签编写。
应该选哪种服务商配置？
LobeHub 有三种方式接入 APIVAI：
| 方式 | 填写的 URL | 模型 | 适用情况 |
|---|---|---|---|
| 自定义服务商，Request Format 选 OpenAI | https://api.apivai.com/v1 | Claude 和 GPT | 推荐：一个服务商覆盖所有模型，内置 OpenAI 服务商保持不变 |
| 内置 Anthropic 服务商 | https://api.apivai.com | 仅 Claude | 想以原生 Messages 格式使用 Claude |
| 内置 OpenAI 服务商 | https://api.apivai.com/v1 | Claude 和 GPT | 最快，但会替换 OpenAI 服务商（见下文文件部分） |
关于 /v1 的规则：OpenAI 格式的 URL 以 /v1 结尾；Anthropic 格式的 URL 不带，因为 Anthropic SDK 会自己加上 /v1/messages。LobeHub 也会去掉 Anthropic 地址末尾的 /v1，但规范的填法是 https://api.apivai.com。两种格式的详细说明见 OpenAI 兼容 API 和 Claude API 代理。
如何获取 APIVAI 密钥？
- 用邮箱注册账号。
- 充值，$10 起，支持银行卡、加密货币、支付宝和微信支付。按 token 计费，没有订阅。
- 在控制台创建密钥并复制。如果多人共用，给它设置预算上限。
如何把 APIVAI 添加为自定义服务商？
- 打开 App Settings → AI Providers。
- 点击 Add Custom Provider，会打开 Create Custom AI Provider 对话框。
- 按下表填写字段，然后点击 Create。
- 在新服务商页面使用 Connectivity Check：选择一个模型，点击 Check，应显示 Check passed。
- 在模型列表中点击 Fetch models，从
/v1/models拉取 ID，再打开需要的模型。也可以点击 Add Model，手动输入 Model ID。 - 打开智能体设置，选择 APIVAI 服务商和模型。
| 字段 | 值 |
|---|---|
| Provider ID | apivai（小写；创建后不能修改） |
| Provider Name | APIVAI |
| Request Format | OpenAI |
| Proxy URL | https://api.apivai.com/v1 |
| API Key | 你的 APIVAI 密钥 |
| Use Client Request Mode | 关闭 |
Use Client Request Mode 会让请求直接从浏览器发出，而不经过 LobeHub 服务器。没有特别理由就保持关闭；如果打开后出现网络错误，请再关掉。
另一种方式：内置 Anthropic 服务商
在 AI Providers 中选择 Anthropic 并启用，把 APIVAI 密钥粘贴到 API Key，在 API Proxy URL 中填 https://api.apivai.com。运行 Check，然后启用 Claude 模型。模型 ID 必须与 APIVAI 的 ID 一致，例如 claude-sonnet-4-6；如果内置模型卡片的 ID 不同，用 Add Model 添加正确的 ID。如果这种方式下 Fetch models 拉不到模型，就手动添加。把自定义服务商的 Request Format 设为 Anthropic 并填同样的 URL，效果相同。
另一种方式：内置 OpenAI 服务商
选择 OpenAI，粘贴密钥，把 API Proxy URL 设为 https://api.apivai.com/v1。Use Responses API Specification 保持关闭：LobeHub 说明该选项仅支持 OpenAI 模型，而你也会通过这个服务商发送 Claude 请求。
如何用 Docker 环境变量配置？
自托管的 LobeHub 服务器从环境变量读取服务商配置。把下面的内容加入 Docker 部署指南中的 lobehub.env 文件，与已有的数据库和认证变量放在一起：
# OpenAI 格式：Claude 和 GPT OPENAI_API_KEY=你的-apivai-密钥 OPENAI_PROXY_URL=https://api.apivai.com/v1 OPENAI_MODEL_LIST=-all,+claude-sonnet-4-6,+claude-haiku-4-5,+gpt-5.5 # 或 Anthropic 格式：仅 Claude ANTHROPIC_API_KEY=你的-apivai-密钥 ANTHROPIC_PROXY_URL=https://api.apivai.com
然后照常启动容器，例如 docker run -d -p 3210:3210 --env-file lobehub.env --name lobehub lobehub/lobehub，每次修改文件后都要重启容器。
OPENAI_MODEL_LIST 使用 LobeHub 的模型列表语法：-all 隐藏默认的 OpenAI 模型，+id 添加模型，id=Display Name 修改显示名称。这样设置的密钥是服务器密钥，你实例的所有用户共用，所以请在 APIVAI 控制台给它单独设置预算。LobeHub 文档提到，返回空消息往往是因为 OPENAI_PROXY_URL 少了 /v1；对 APIVAI 来说一定要带上。
文件和知识库还能用吗？
通过 APIVAI 对话完全可用。但文件和知识库还需要一个嵌入（embedding）模型来索引文档，而 APIVAI 不提供嵌入接口。
LobeHub 默认通过 OpenAI 服务商使用 OpenAI 的 text-embedding-3-small 生成嵌入。如果你把 OPENAI_PROXY_URL 指向了 APIVAI，文件索引就会失败——这也是推荐用自定义服务商来对话的另一个原因。请通过 DEFAULT_FILES_CONFIG 单独配置嵌入服务商，例如 DEFAULT_FILES_CONFIG=embedding_model=ollama/<你的嵌入模型>；支持的服务商见 LobeHub 的知识库部署指南。针对文件的回答仍由你在 APIVAI 上的对话模型生成。
应该选哪个模型？
每百万 token 价格，截至 2026-10-07。模型列表会变化，请从 GET https://api.apivai.com/v1/models（或 Fetch 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-6 Sol | $0.30 | $1.52 | 当前的 GPT |
| GPT-6 Luna | $0.0144 | $0.0768 | 最便宜的选择 |
一个实用的搭配：通用助手智能体用 Claude Haiku 4.5 或 GPT-6 Luna，写作和编程智能体用 Claude Sonnet 4.6，只有处理最难工作的智能体才用 Claude Opus 5.5。
费用是多少？
APIVAI 从预付余额中按 token 扣费。每条消息都会重新发送对话历史，所以对话越长，每条消息越贵。
示例 1：个人日常使用。 每天 50 条消息、持续 30 天，每条约 3,000 输入和 800 输出 token：1,500 条消息使用 Claude Sonnet 4.6 费用为 $10.94（官方价 $31.50），使用 GPT-6 Luna 则为 $0.157。
示例 2：大量文档工作。 一个阅读长文本的智能体，每个工作日 10 次请求、共 22 个工作日，每次约 20,000 输入和 1,500 输出 token：220 次请求使用 Claude Sonnet 5.5 费用为 $4.18，官方价为 $12.10。
控制台会显示每次请求的 token 和费用。Claude API 价格对比把所有模型与官方价格并列展示。
排错
- 401 或 "API key invalid"： 检查密钥是否有多余空格、是否已被删除，并在控制台确认它的预算和你的余额。
- 404： URL 中的
/v1不对。OpenAI 格式（自定义服务商、OpenAI 服务商、OPENAI_PROXY_URL）需要https://api.apivai.com/v1；Anthropic 格式需要https://api.apivai.com。不要加/chat/completions或/messages。 - 找不到模型： Model ID 必须与 APIVAI 的 ID 完全一致，例如
claude-sonnet-4-6，而不是显示名称。用 Fetch models 或GET /v1/models确认。 - 回复为空或被截断： 思考默认开启，思考 token 按输出计费。在智能体的模型设置中打开 Enable Max Tokens Limit，把 Max Tokens Limit 设为 4096 或更高。如果 OpenAI 格式下回复为空，也请确认 URL 以
/v1结尾。 - 环境变量不生效： 修改
lobehub.env后重启容器，并确认变量名与上文完全一致。 - 429： 每个密钥默认每分钟 60 次请求。如果共享实例触发限制，请联系客服提高限额。
常见问题
LobeChat 和 LobeHub 是同一个吗？
是的。LobeChat 已更名为 LobeHub，仓库、文档和 Docker 镜像都使用 LobeHub 这个名字。旧教程里 LobeChat 的相关设置，对应现在的 App Settings → AI Providers。
能在一个服务商里同时用 Claude 和 GPT 吗？
能。使用 OpenAI 格式的自定义服务商，地址填 https://api.apivai.com/v1。一个 APIVAI 密钥适用于价格页上的所有模型。
必须用 Docker 吗？
不必。只有自己运行 LobeHub 服务器时才需要 Docker。在任何带有 AI Providers 设置的 LobeHub 应用中，都可以按上文在设置里添加 APIVAI。
APIVAI 会保存我的对话吗？
APIVAI 不记录请求和响应的内容。聊天记录由 LobeHub 保存；如果是自托管，就保存在你自己的服务器上。
有免费试用吗？
没有。APIVAI 采用预付费、按量计费，$10 起，无订阅。其他工具的配置见文档，另一款自托管聊天界面的配置见 Open WebUI 指南。
注册账号，充值 $10 起，把密钥粘贴到 LobeHub 即可。