twinny

twinny 没有基础 URL 字段 — Add provider → OpenAI-compatible server，然后填写 Protocol https、Hostname api.kunavo.com、Port 留空、API path /v1，其聊天面板即可使用你的密钥。

Label          Kunavo
Type           Chat
Provider       OpenAI-compatible server
Hostname       api.kunavo.com
Port           (leave blank — "Blank means the protocol's default")
Protocol       https
API path       /v1
Model name     claude-sonnet-5
FIM template   (Autocomplete only — not part of a Chat provider)
API key        sk-kn-...

分步操作

1. 在 /app/keys 创建密钥并复制——它只会显示一次。
2. 点击侧边栏顶部的机器人图标，打开 Providers 选项卡；也可以从命令面板运行 Manage twinny providers。
3. Add provider → 在 On your machine 下选择 OpenAI-compatible server，即通用预设。该预设默认指向 localhost:8080。
4. 将 Protocol 设为 https，将 Hostname 设为 api.kunavo.com，清空 Port，并将 API path 设为 /v1。Type 保持为 Chat。
5. 将密钥粘贴到 API key 字段中——twinny 会将其作为 Authorization: Bearer 发送。然后设置 Model name，可以手动输入，也可以使用 Choose from the server's models，因为 Kunavo 支持 GET /v1/models。
6. 点击 Test provider，然后点击 Use this provider 将其设为当前聊天提供商。若要添加第二个模型，请使用 Copy 复制该行，而不必重新输入四个端点字段。

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

调试客户端前先验证

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

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

聊天可用，自动补全和索引则不行。

twinny 将工作拆分给三种提供商类型，且每种都需要单独配置——因此“twinny 支持 Kunavo”只对其中一种成立。其他两种并不是你尚未找到的配置选项；它们所需的路由并非 Kunavo 支持的路由。

这两项能力缺失都不会阻止配置，因为 twinny 对每种类型分别保留一个当前提供商，彼此独立。twinny 自己的托管 API 页面称这种拆分是“一种常见配置”：使用小型本地基础模型进行补全，同时使用托管模型进行聊天、评审和编辑。工作区索引也是类似情况——这里不提供嵌入步骤，而 twinny 的文档建议通过 Ollama 使用本地模型，例如 nomic-embed-text。不同模型生成的向量不能混用，因此更换该模型后需要重建索引，而不是更新索引。