ChatWise

Settings → Providers → “+” 通过三个字段创建自定义提供商 — Provider name、设置为 https://api.kunavo.com/v1 的 API Base URL 和 API Key — 随后 Fetch 会从端点读取模型列表。

Provider name    Kunavo
API Base URL     https://api.kunavo.com/v1
                 field help: "Do NOT include /chat/completions in the URL"
API Key          sk-kn-...
Models           click Fetch to read the list from the endpoint,
                 or "+ New" and type an id by hand

"+ New" → Chat Models, the fields the docs name:
  Model ID       claude-sonnet-5
  Display Name   Claude Sonnet 5 (Kunavo)
  Capabilities   image input / reasoning flag — tick what the model does
  Context length as published on the models page

分步操作

1. 在 /app/keys 创建密钥并复制——它只会显示一次。
2. 在 ChatWise 中，打开设置 → 服务商，然后点击 “+” 添加新服务商。文档提供了两种方式：选择一个内置预设，或创建自定义配置——Kunavo 不是预设，因此请选择第二种。
3. 按上述说明填写 Provider name、API Base URL 和 API Key。表单中的设置都不会指定厂商：端点会解析模型 ID，因此在 OpenAI 兼容服务商下使用 Claude ID 正是预期的组合，并非配置不匹配。
4. 在 Models 行点击 Fetch。ChatWise 文档称，如果 API 支持 /models 端点，就可以自动添加可用模型；Kunavo 会响应 GET /v1/models，因此模型列表会自动填充。若要手动输入 ID，可点击 + New。
5. 如果手动添加模型，文档列出了相关字段：Model ID 是 API 标识符，Display Name 仅是标签，因此 ID 必须与目录中的内容完全一致。勾选 Capabilities 并将 Context length 设为与模型一致——这些标记用于告知客户端可以提供哪些功能，而不是指示端点执行什么操作。
6. 在模型选择器中选择该服务商并发送消息。对于图像模型，ChatWise 的图像生成页面还说明了一个步骤：必须先将模型类型设为 Image，它才会出现在图像选择器中。

已于 2026年9月21日 对照 ChatWise 自定义服务商页面 检查。第三方设置会发生变化；如果这里的字段名称不再与你看到的内容一致，应以该页面为准，而不是本页。

调试客户端前先验证

一个请求即可确定故障来自端点、密钥还是配置文件。如果返回 JSON，则相同的基础 URL 和密钥可以在 ChatWise 中使用。

# 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 的美元，格式为输入 / 输出。