文档
Chatbox
Chatbox 将端点拆分为主机和路径,并自动填写路径。因此,主机应填写源站地址——在其中加入 /v1 是此客户端最容易让人犯的错误。
添加一个类型为 OpenAI API Compatible 的提供商,将 API Host 设置为服务根地址 — Chatbox 会自行追加 /v1/chat/completions。
Settings → Model Providers → Add
API 提供方名称 / Provider name Kunavo
API 类型 / Type OpenAI API 兼容 (OpenAI API compatible)
API 密钥 / API Key sk-kn-...
API 主机 / API Host https://api.kunavo.com
API 路径 / API Path (leave empty → /v1/chat/completions)
Model claude-sonnet-5https://api.kunavo.com,不要包含 /v1。Chatbox 有单独的 API Path 字段,默认值为 /v1/chat/completions,因此,如果主机地址已以 /v1 结尾,请求就会发往 /v1/v1/chat/completions。除非确定需要其他设置,否则请将路径留空。sk-kn- 开头),并充值 $10 起——调用费用从该余额中扣除,失败的调用不会收费。随后,控制台会打开 Chatbox 设置页面。分步操作
- 在
/app/keys创建密钥并复制——它只会显示一次。 - 打开设置 → 模型服务商,然后点击添加。
- 为服务商命名,将类型设为 OpenAI API 兼容,然后粘贴 API Key。
- 将 API 主机 / API Host 设为
https://api.kunavo.com,并将 API 路径 / API Path 留空。 - 添加所需的模型 ID,保存,然后开始对话。
已于 2026年9月6日对照 Chatbox 服务商配置指南检查。第三方设置会发生变化;如果这里的字段名称不再与你看到的内容一致,应以该页面为准,而不是本页。
调试客户端前先验证
一个请求即可确定故障来自端点、密钥还是配置文件。如果返回 JSON,则相同的基础 URL 和密钥可以在 Chatbox 中使用。
# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
-H "Authorization: Bearer sk-kn-..."字段中应填写哪个模型 ID
每个文本模型都可通过模型 ID 访问——实时列表见 GET /v1/models,包含价格的目录见模型页面。费率单位为每 1M token 的美元,格式为输入 / 输出。
| 模型 ID | Kunavo 输入 / 输出 | 它在 Chatbox 中的位置 |
|---|---|---|
claude-sonnet-5 | $1.40 / $7.00 | 默认对话模型 |
claude-haiku-4-5 | $0.70 / $3.50 | 适用于讲究延迟和价格的简短对话 |
claude-opus-5 | $3.50 / $17.50 | 保留为第二个服务商条目,用于处理难题 |
gpt-5-6-terra | $0.70 / $4.20 | 使用同一密钥调用另一个系列的模型 |
常见问题
对于 OpenAI 兼容端点,Chatbox 的 API Host 应填写什么?
填写不带路径的源站地址,例如 https://api.example.com。Chatbox 有单独的 API Path 字段,默认值为 /v1/chat/completions。其文档指出,通常无需填写此字段,因此 /v1 应来自路径,而不是主机。若主机地址以 /v1 结尾,请求会变成 /v1/v1/chat/completions,并返回 404。
如何在 Chatbox 中添加自定义模型服务商?
打开“设置” → “模型服务商”,点击“添加”,然后为服务商命名,选择 OpenAI 兼容 API 类型,粘贴 API 密钥,将 API Host 设为端点的源站地址,并将 API Path 留空。添加要使用的模型 ID 并保存后,该服务商就会出现在每个对话的模型选择器中。
Chatbox 可以调用 Claude 模型吗?
可以,通过提供这些模型的 OpenAI 兼容端点调用。Chatbox 会将你输入的模型 ID 发送到已配置的主机,由该端点解析 Claude ID,而不需要应用自身持有 Anthropic 凭据。服务商类型选择器选择的是线路格式,而不是厂商。
什么时候需要填写 Chatbox 的 API Path?
只有当端点未在 /v1/chat/completions 提供 Chat Completions 服务时才需要填写。该字段适用于路由方式特殊的网关;对于标准的 OpenAI 兼容服务,留空即可。填写路径是导致 404 的常见原因,而这种 404 容易被误认为是身份验证问题。