文档

文档

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.kunavo.com/v1
自定义 API 密钥sk-kn-…
可用模型连接后自动填充——可选择任意 id
/v1 后缀必须包含在此字段中。SillyTavern 的自定义来源遵循 OpenAI 规范,只会追加路由,因此,若 https://api.kunavo.com 未包含 /v1,连接就会失败,模型列表也会为空。

分步操作

  1. 在 /app/keys 创建密钥并复制——它只会显示一次。
  2. 在 SillyTavern 中,点击顶部栏的 插头图标(API Connections)。
  3. 将 API → Chat Completion,然后将 Chat Completion Source → Custom (OpenAI-compatible)。
  4. 将 https://api.kunavo.com/v1 粘贴到 Custom Endpoint,再将密钥粘贴到 Custom API Key。
  5. 点击 Connect。状态显示为绿色,且 Available Models 下拉列表已填充,即表示连接成功。
  6. 从下拉列表中选择模型 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 的美元价格,按输入/输出顺序列出。

模型 IDKunavo 输入 / 输出适用场景
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 上下文窗口的前沿推理模型——当聊天历史本身成为问题时可选用
在 SillyTavern 的长会话中,最先遇到的限制是上下文长度:每一轮都会重新发送完整历史,因此 token 开销会随对话增长,而不是保持不变。Kunavo 按 token 从预付余额中扣费,不收月费,因此闲置一个月不会产生费用——详情见 计费;对于重复上下文,提示缓存是最重要的优化手段。

故障排除

症状原因修复方法
连接失败,模型列表仍为空Custom Endpoint 中缺少 /v1使用 https://api.kunavo.com/v1。通过上面的 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 之外复现失败,并判断具体是哪种原因。