文档
SillyTavern
SillyTavern 的 Custom (OpenAI-compatible) 来源需要基础 URL 和密钥。将其指向 Kunavo 后,Claude 和 GPT 都会显示在同一个模型下拉列表中。
要将 SillyTavern 连接到 Kunavo,请打开 API Connections,将 API 设为 Chat Completion,将 Chat Completion Source 设为 Custom (OpenAI-compatible),然后填写两个字段:Custom Endpoint = https://api.kunavo.com/v1,Custom API Key = 你的 sk-kn-… 密钥。点击 Connect;SillyTavern 会调用 GET /v1/models,并根据响应填充模型下拉列表。
| SillyTavern 字段 | 值 |
|---|---|
| API | 聊天补全 |
| 聊天补全来源 | 自定义(OpenAI 兼容) |
| 自定义端点(基础 URL) | https://api. |
| 自定义 API 密钥 | sk-kn-… |
| 可用模型 | 连接后自动填充——可选择任意 id |
/v1 后缀必须包含在此字段中。SillyTavern 的自定义来源遵循 OpenAI 规范,只会追加路由,因此,若 https://api.kunavo.com 未包含 /v1,连接就会失败,模型列表也会为空。分步操作
- 在
/app/keys创建密钥并复制——它只会显示一次。 - 在 SillyTavern 中,点击顶部栏的 插头图标(API Connections)。
- 将 API → Chat Completion,然后将 Chat Completion Source → Custom (OpenAI-compatible)。
- 将
https://api.kunavo.com/v1粘贴到 Custom Endpoint,再将密钥粘贴到 Custom API Key。 - 点击 Connect。状态显示为绿色,且 Available Models 下拉列表已填充,即表示连接成功。
- 从下拉列表中选择模型 id,然后开始聊天。之后切换模型无需重新连接。
SillyTavern 对此界面的官方参考文档是 Chat Completions API connections 页面。
该页面说明,不要在端点后添加 /chat/completions 后缀,并记录了一个“Prompt Post-Processing”设置——None、Merge consecutive messages from the same role、Semi-strict、Strict、Single user message——其中不使用工具的变体不支持工具调用(docs.sillytavern.app,2026 年 10 月 25 日阅读)。
先验证,再排查界面问题
发送一个请求,就能判断问题出在端点、密钥还是 SillyTavern。如果此请求返回模型 id 的 JSON 列表,同一 URL 和密钥就能填充下拉列表。
# Confirms the key and the endpoint before you touch SillyTavern.
# A JSON list of model ids means the same URL will populate the dropdown.
curl -sS https://api.kunavo.com/v1/models \
-H "Authorization: Bearer sk-kn-..."选择模型
Kunavo 上的所有文本模型都可以通过同一个下拉列表访问——完整列表见模型页面,也可通过 GET /v1/models 实时获取。费率单位为每 1M 个 token 的美元价格,按输入/输出顺序列出。
| 模型 ID | Kunavo 输入 / 输出 | 适用场景 |
|---|---|---|
claude-haiku-4-5 | $0.70 / $3.50 | 价格最低的 Claude——适合最看重每轮成本的长会话 |
claude-sonnet-5 | $1.40 / $7.00 | 质量与价格的默认平衡选择 |
claude-opus-5 | $3.50 / $17.50 | 质量最高的 Claude 档位 |
claude-fable-5 | $7.00 / $35.00 | 具备 1M-token 上下文窗口的前沿推理模型——当聊天历史本身成为问题时可选用 |
故障排除
| 症状 | 原因 | 修复方法 |
|---|---|---|
| 连接失败,模型列表仍为空 | Custom Endpoint 中缺少 /v1 | 使用 https://api.。通过上面的 curl 命令确认。 |
| 401 / 密钥无效 | 粘贴的密钥带有空格,或密钥已被撤销 | 重新从 /app/keys 复制;参见 401 和 403 |
| 响应一次性全部返回,而非流式传输 | 连接前方的代理正在缓冲服务器发送事件 | 端点支持流式传输——参见 流式传输错误 |
| 模型 id 被拒绝 | 该端点不提供此 id | 从下拉列表中选择,或参见 model_not_found |
| 仅在长对话中出错 | 历史记录已超出模型的上下文窗口 | 缩短历史记录,或改用上下文更长的模型——参见 context_length_exceeded |
坦诚说明两点
无关联关系
SillyTavern 是一个独立的开源项目,与 Kunavo 没有关联。本页介绍的配置之所以可用,是因为 SillyTavern 支持任意 OpenAI 兼容端点——双方都没有为此进行特别定制。
内容政策仍然适用
通过 Kunavo 发送的请求会到达上游提供商,每个提供商都会针对发送给它的内容执行自身的使用政策。网关不会免除这些限制,任何声称相反的网站都是在兜售虚假信息。Kunavo 自身的条款见可接受使用政策。
常见问题
如何将 SillyTavern 连接到自定义 API 端点?
在 SillyTavern 中,打开 API Connections 标签页(插头图标),将 API 设为 Chat Completion,并将 Chat Completion Source 设为 Custom (OpenAI-compatible)。在 Custom Endpoint 中填写网关的 OpenAI 兼容基础 URL——Kunavo 的地址是 https://api.kunavo.com/v1;在 Custom API Key 中填写密钥,然后点击 Connect。随后,SillyTavern 会向该端点调用 GET /v1/models,并根据响应填充模型下拉列表。
SillyTavern 能否通过 OpenAI 兼容端点使用 Claude 模型?
可以。SillyTavern 的 Custom (OpenAI-compatible) 来源只需要端点实现 POST /v1/chat/completions,因此以这种格式提供的 Claude 模型无需使用 SillyTavern 单独的 Anthropic 来源。在 Kunavo 上,Claude 和 GPT 模型 id 都会通过同一个密钥显示在同一个下拉列表中,切换模型无需重新连接。
SillyTavern 通过自定义端点使用时支持流式传输吗?
只要端点在 /v1/chat/completions 上实现服务器发送事件,流式传输就能正常工作;Kunavo 支持此功能。如果响应一次性完整返回,通常是连接前方的代理缓冲了数据流,而不是端点本身的问题。
连接后 SillyTavern 的模型列表为什么为空?
SillyTavern 中的模型下拉列表为空,表示 GET /v1/models 调用失败;问题出在端点或密钥,而不是 SillyTavern。最常见的两个原因是基础 URL 缺少 /v1 后缀,或密钥对该端点无效。使用同一密钥对 /v1/models 运行 curl,即可在 SillyTavern 之外复现失败,并判断具体是哪种原因。