Msty Studio

Model Hub > Model Providers > Add Provider > Open AI Compatible：填写 API Key 和 https://api.kunavo.com/v1 的 Inference Endpoint — 应用自身说明指出，大多数 OpenAI 兼容端点需要 /v1。

Model Hub  >  Model Providers  >  Add Provider

Provider             Open AI Compatible     (under "OpenAI Compatible")
Name                 Kunavo                 "Give it a name (optional)"
API Key              sk-kn-...
Inference Endpoint   https://api.kunavo.com/v1      <- keep the /v1

Models               Fetch Models, then tick the ids you want
                     (or Add Custom Model: Model ID + Model Name)
                                                     → Save Provider

分步操作

1. 在 /app/keys 创建密钥并复制——它只会显示一次。
2. 在 Msty Studio 中打开 Model Hub > Model Providers，然后选择 Add Provider。在提供商列表的 OpenAI Compatible 标题下，选择 Open AI Compatible——不要选择 OpenAI，后者是固定的 OpenAI 提供商。
3. 为它填写名称，将密钥粘贴到 API Key，并将https://api.kunavo.com/v1填入Inference Endpoint。应用要求该地址以https://开头。
4. 点击 Fetch Models，勾选所需模型。Kunavo 会通过GET /v1/models返回完整目录，因此建议只选几个，而不是全部。如果愿意，也可以打开Add Custom Model，准确输入目录中所列的Model ID，例如claude-sonnet-5。
5. 点击 Save Provider，然后打开一个对话并选择其中一个模型——Msty 自己的文档将此列为测试步骤。如果收到回复，说明端点、密钥和模型 ID 均正确。

已于 2026年10月1日 对照 Msty Studio 的在线提供商页面 检查。第三方设置会发生变化；如果这里的字段名称不再与你看到的内容一致，应以该页面为准，而不是本页。

调试客户端前先验证

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

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

你使用的是哪个 Msty

• Msty Studio——本页介绍的桌面与网页工作区，提供商位于 Model Hub > Model Providers 下。
• Msty Go——另一款代理应用，其提供商设置位于 Settings 下；设置说明见专属页面。
• Msty 1.x——已停止维护的应用，其冻结文档仍托管在 docs.msty.app 并出现在搜索结果中。它的界面与 Studio 不同。

应用出错时显示的信息

以下是 2.9.11 版本附带的错误消息，以及它们对该端点的含义：

• “未找到提供商端点。请检查端点 URL，并确保其中包含正确的 API 路径，例如 /v1。” — 缺少推理端点 /v1。
• “无法连接到提供商端点……” — 主机名有拼写错误，或者本应为 https:// 的位置写成了 http://。
• Fetch Models 失败，但 URL 正确——检查密钥。Kunavo 的模型列表需要有效密钥；没有密钥时会返回 401。
• 模型已列出，但聊天时报错 — Msty 自己的表单会提示：“并非所有模型都经过 Msty 测试”。Kunavo 的列表包含聊天窗口无法使用的图像、视频和音频模型；请选择聊天模型。

哪些内容会离开你的设备

Msty 将在线提供商描述为一种“使用托管模型和你的 API 密钥，而无需在设备上运行模型推理”的方式。因此，使用 Kunavo 模型进行对话时，该对话的提示词和附加上下文会发送到 Kunavo，再由 Kunavo 转发给模型供应商；使用本地模型进行对话则不会。如果你在意这一边界，请将敏感材料留在本地模型中。

此提供商类型的思考强度

Msty 的文档指出，“OpenAI Compatible Models”仅支持 None 和 Default 两种思考力度，而其原生 Anthropic 提供商支持 Think Lightly、Moderately 和 Deeply。通过 Open AI Compatible 类型使用 Claude 模型时，请预期它会以默认推理力度运行，而非分级力度。