文档

文档

Chatbox

Chatbox 将端点拆分为主机和路径,并自动填写路径。因此,主机应填写源站地址——在其中加入 /v1 是此客户端最容易让人犯的错误。

添加一个类型为 OpenAI API Compatible 的提供商,将 API Host 设置为服务根地址 — Chatbox 会自行追加 /v1/chat/completions。

Chatbox 设置
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-5
API Host 应填写 https://api.kunavo.com,不要包含 /v1。Chatbox 有单独的 API Path 字段,默认值为 /v1/chat/completions,因此,如果主机地址已以 /v1 结尾,请求就会发往 /v1/v1/chat/completions。除非确定需要其他设置,否则请将路径留空。
Chatbox 的服务商类型选择器指定的是线路格式。请选择 OpenAI API 兼容,然后输入 Claude 模型 ID——端点会解析该 ID,因此二者并不冲突。
还没有密钥?创建 Kunavo 账户,创建一个密钥(以 sk-kn- 开头),并充值 $10 起——调用费用从该余额中扣除,失败的调用不会收费。随后,控制台会打开 Chatbox 设置页面。

分步操作

  1. 在 /app/keys 创建密钥并复制——它只会显示一次。
  2. 打开设置 → 模型服务商,然后点击添加。
  3. 为服务商命名,将类型设为 OpenAI API 兼容,然后粘贴 API Key。
  4. 将 API 主机 / API Host 设为 https://api.kunavo.com,并将 API 路径 / API Path 留空。
  5. 添加所需的模型 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 的美元,格式为输入 / 输出。

模型 IDKunavo 输入 / 输出它在 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使用同一密钥调用另一个系列的模型
计费方式是从预付余额中按 token 扣费,无月费——参见 计费。对于重复上下文——这正是编辑器或聊天客户端发送内容的大部分——提示缓存对账单的影响大于模型选择。

常见问题

对于 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 容易被误认为是身份验证问题。