简短回答
在 Chatbox 中使用 APIVAI：打开 Settings → Model Provider → Add，选择 Add Custom Provider，命名为 APIVAI，API Mode 选 OpenAI API Compatible。API Host 填 https://api.apivai.com/v1，API Path 填 /chat/completions，把 APIVAI 密钥粘贴到 API Key，在 Models 中通过 Fetch 或 New 添加 claude-sonnet-4-6 或 gpt-5.5 等模型，再点击 Check。如果想以原生格式使用 Claude，可以再添加一个 API Mode 为 Claude API Compatible 的自定义提供方，API Host 同样填 https://api.apivai.com/v1，因为 Chatbox 只会在后面加 /messages。截至 2026-10-07，通过 APIVAI 使用 Claude Sonnet 4.6 每百万输入 / 输出 token 为 $1.04 / $5.22，官方价为 $3.00 / $15.00，从预付余额按 token 扣费。
Chatbox 是什么？
Chatbox（Chatbox AI）是一款支持 Windows、macOS、Linux、iOS、Android 和网页的聊天客户端。除了自家的付费 Chatbox AI 服务，它还允许你为多家服务商使用自己的 API 密钥，并可以通过自定义提供方接入任何兼容 OpenAI 或 Claude API 格式的服务。
APIVAI 正是以这种方式接入。一个 APIVAI 密钥即可使用 Claude 和 GPT 模型，按 token 计费且低于官方标价，从你自己充值的余额中扣费，无需订阅。同一个密钥在电脑和手机上都能用，每台设备配置一次 Chatbox，所有用量都在同一个控制台里查看。
Chatbox 里应该选哪个 API Mode？
添加自定义提供方时，Chatbox 会要求选择 API Mode。适合 APIVAI 的有两种：
| OpenAI API Compatible | Claude API Compatible | |
|---|---|---|
| API Host | https://api.apivai.com/v1 | https://api.apivai.com/v1 |
| API Path | /chat/completions | 不使用（Chatbox 自动加 /messages） |
| 模型 | Claude 和 GPT | 仅 Claude |
| 适合 | 一个提供方覆盖所有模型 | 以原生格式使用 Claude，并使用 Chatbox 的 Claude 思考设置 |
选 OpenAI API Compatible：想在一个提供方里同时用 Claude 和 GPT，这是最简单的配置。再加一个 Claude API Compatible 提供方：如果你主要用 Claude——Chatbox 只有在 Claude 模型通过 Claude API 方式接入时才会显示思考（thinking）相关设置。同一个密钥两种都能用。Chatbox 还提供 OpenAI Responses API Compatible，本文用不到。
请注意 /v1 规则，这一点和很多其他工具不同：在 Chatbox 的 Claude 模式下，API Host 必须包含 /v1，因为 Chatbox 只会追加 /messages。Chatbox 会在输入框下方显示最终 URL 的 Preview。OpenAI 模式应显示 https://api.apivai.com/v1/chat/completions，Claude 模式应显示 https://api.apivai.com/v1/messages。
如何一步步把 Chatbox 接入 APIVAI？
第 1 步：获取 APIVAI 密钥
- 在 apivai.com 用邮箱注册。
- 充值余额，$10 起，支持银行卡、加密货币、支付宝或微信支付。没有免费试用，只按实际用量付费。
- 打开控制台，创建密钥并复制。可以为密钥设置预算上限，在手机 App 中使用时尤其有用。
第 2 步：添加自定义提供方
- 打开 Settings → Model Provider。在手机上，先点左上角的菜单展开侧边栏。
- 点击 Add，选择 Add Custom Provider。
- Name 填
APIVAI，API Mode 选 OpenAI API Compatible，点击 Add 确认。 - 填写提供方设置：
| 字段 | 值 |
|---|---|
| API Key | 你的 APIVAI 密钥 |
| API Host | https://api.apivai.com/v1 |
| API Path | /chat/completions |
确认 Preview 一行显示的是 https://api.apivai.com/v1/chat/completions，其中 /v1 只出现一次。
第 3 步：添加模型
在 Models 中点击 Fetch 拉取密钥可用的模型，或点击 New 手动添加：
| 字段 | 值 |
|---|---|
| Model ID | claude-sonnet-4-6（或价格页上的其他 ID） |
| Nickname | 任意名称，例如 “Claude Sonnet” |
| Model Type | Chat |
| Context Window | 模型页面上标注的上限 |
| Max Output Tokens | 4096 或更高 |
每个模型添加一条。模型 ID 会随时间变化，请从 Fetch、GET https://api.apivai.com/v1/models 或价格页复制，不要照抄旧教程。
第 4 步：检查并开始对话
点击 Check 测试密钥和地址，然后在对话的模型选择器中选中新模型，发送消息即可。
可选：Claude API Compatible 提供方
重复第 2 步，Name 填 APIVAI Claude，API Mode 选 Claude API Compatible。使用同一个 API Key，API Host 填 https://api.apivai.com/v1，API Path 留空。Preview 应显示 https://api.apivai.com/v1/messages。这里只添加 Claude 模型，例如 claude-sonnet-4-6 或 claude-opus-5-5。Anthropic 格式的说明见 Claude API 代理页面。
在 Chatbox 中该选哪个模型？
每百万 token 价格，截至 2026-10-07。全部模型见价格页。
| 模型 | 模型 ID | 输入 | 输出 | 适合 |
|---|---|---|---|---|
| Claude Sonnet 4.6 | claude-sonnet-4-6 | $1.04 | $5.22 | 日常默认，写作和代码 |
| Claude Sonnet 5.5 | claude-sonnet-5-5 | $0.69 | $3.47 | 更新的 Sonnet，擅长编程 |
| Claude Haiku 4.5 | claude-haiku-4-5 | $0.35 | $1.74 | 手机上快速问答、翻译 |
| Claude Opus 5.5 | claude-opus-5-5 | $1.39 | $6.96 | 最难的问题 |
| GPT-5.5 | gpt-5.5 | $0.77 | $4.56 | 通用对话的 GPT |
| GPT-6 Sol | gpt-6-sol | $0.30 | $1.52 | 更新的 GPT，适合高要求任务 |
| GPT-6 Luna | gpt-6-luna | $0.0144 | $0.0768 | 最便宜，适合简单任务 |
对大多数人来说，Claude Sonnet 4.6 是不错的默认选择。简短的小任务切换到 Claude Haiku 4.5 或 GPT-6 Luna，只有问题确实需要时才用 Claude Opus 5.5。
用 APIVAI 时 Chatbox 要花多少钱？
你只为 token 付费。每条消息都会重新发送之前的对话，所以对话越长，每轮越贵。Thinking 默认开启，思考 token 按输出计费。
- 日常对话： 假设每轮约 2,500 输入 token（你的消息加最近的历史）和 700 输出 token，每天 30 轮、持续 30 天（共 900 轮）。用 Claude Sonnet 4.6 一个月为 $5.63，官方价为 $16.20。同样一个月用 Claude Haiku 4.5 为 $1.88，用 GPT-6 Luna 为 $0.0808。
- 难题： 向 Claude Opus 5.5 提 10 个问题，每个约 8,000 输入和 2,000 输出 token，共 $0.25（官方价 $0.72）。
话题变了就新开对话；如果你的版本在对话设置中支持，限制 Chatbox 发送的历史消息条数。控制台会列出每次请求的 token 和费用。完整对比见 Claude API 价格对比。
Chatbox 的知识库能用 APIVAI 吗？
对话可以完全通过 APIVAI 使用，但知识库需要 Embedding Model 来索引文件，而 APIVAI 不提供 embeddings。请为知识库另外配置一个嵌入模型服务商；负责回答的模型仍然可以是 APIVAI 的 Claude 或 GPT。APIVAI 也不提供图像生成。
排错
- 401 或 “invalid API key”： 密钥复制时带了空格或换行、已被删除或预算用完。从控制台重新复制，并检查余额。
- 404： 看 Preview 一行。OpenAI 模式必须是
https://api.apivai.com/v1/chat/completions；Host 不带/v1又填了 API Path，或者/v1出现两次，都会 404。Claude 模式必须是https://api.apivai.com/v1/messages；这里填不带/v1的https://api.apivai.com会 404。 - 找不到模型： Model ID 必须完全一致，例如
claude-sonnet-4-6。GPT 模型在 Claude API Compatible 提供方中会失败，请加到 OpenAI 那个提供方。 - 回复为空或被截断： 思考 token 也计入输出上限。在模型条目或对话设置中把 Max Output Tokens 调到 4096 以上。
- 连接错误或流式输出中断： 在提供方设置中打开 Improve Network Compatibility 后重试。
- 429： 每个密钥默认每分钟 60 次请求；稍等片刻，或联系客服提高限额。
全部端点和错误码见文档。
常见问题
Chatbox 的 API Host 需要带 /v1 吗？
需要，两种模式都填 https://api.apivai.com/v1。Chatbox 会在后面加上 /chat/completions（来自 API Path）或 /messages。以 Preview 为准。
需要订阅 Chatbox AI 吗？
不需要。自定义提供方使用你自己的密钥，APIVAI 从预付余额按 token 扣费。Chatbox 自己的付费套餐是另一项服务。
手机上能用同一个密钥吗？
可以。在 Chatbox 手机 App 中添加同样的自定义提供方即可。一个密钥所有设备通用；想封顶花费，可以给它设预算上限。
一个密钥能同时用 Claude 和 GPT 吗？
可以。一个 APIVAI 密钥适用于价格页上的所有模型，OpenAI 格式和 Claude 格式都支持。它也能用于 Cherry Studio 和其他 OpenAI 兼容工具。
APIVAI 会保存我的对话吗？
不会。请求和响应内容不记录日志，只保留用于计费的使用数据，例如模型、token 数和费用。
注册账号，充值 $10 起，把密钥粘贴到 Chatbox 即可。