SillyTavern 集成指南

概览

SillyTavern 通过 Chat Completion 源与 UnoRouter 通信。只需粘贴基础 URL 和 API 密钥，然后从自动填充的下拉菜单中选择一个模型即可。无需代理服务器、无需反向隧道、无需额外配置。

快速配置

将以下三个值复制到 SillyTavern 的 Custom（OpenAI-compatible）源字段中。

基础 URL: https://api.unorouter.ai/v1
API 密钥:  YOUR_API_KEY
模型:    claude-opus-4-5

只粘贴基础 URL，SillyTavern 会自动附加 `/chat/completions`。若自行追加会导致 400 错误。

逐步配置

1. 1
   打开 AI Response Configuration

   在 SillyTavern 顶部点击插头图标，打开 API Connections 面板。

2. 2
   选择 Chat Completion

   将 API 类型设置为 Chat Completion。

3. 3
   选择 Custom（OpenAI-compatible）

   在 Chat Completion Source 下拉菜单中选择 Custom（OpenAI-compatible）。

4. 4
   粘贴基础 URL

   输入 UnoRouter 以 `/v1` 结尾的基础 URL，不要添加 `/chat/completions`。

5. 5
   粘贴 API 密钥

   将 UnoRouter API 密钥粘贴到 Custom API Key 字段。

6. 6
   连接并选择模型

   点击 Connect。Model 下拉菜单会从 UnoRouter 的模型列表自动填充，选择你想用的那个即可。

7. 7
   可选：绕过状态检查

   如果消息已能正常发送，但 SillyTavern 仍显示警告横幅，请启用 Bypass API Status Check。

模型下拉菜单行为

SillyTavern 会对你的基础 URL 调用 `GET /v1/models` 来填充模型选择器。UnoRouter 提供此端点，因此下拉菜单会自动填充。如果列表为空，可退而使用 Custom Model ID 文本框手动输入模型名称。

故障排查

• 每条消息都返回 400 Bad Request。 你在 URL 末尾追加了 `/chat/completions`。请删除它，基础 URL 必须以 `/v1` 结尾。
• 模型下拉菜单为空。 连接失败。先重新检查基础 URL，然后开启 Bypass API Status Check，避免 SillyTavern 过早中断列表加载。
• 401 Unauthorized。 API 密钥已过期或输入有误。请在 UnoRouter 控制台重新生成一个，并粘贴时不要带首尾空格。
• 429 Too Many Requests。 你已达到当前套餐的速率上限。请稍等片刻，或在 UnoRouter 账单页面升级套餐。
• SSL 或证书错误。 系统时间不准确。请先同步时间再重试；SillyTavern 使用系统信任库。
• 流式输出中途截断。 在生成设置中关闭 Streaming，以确认问题是否出在流式侧，然后再重新开启。如果企业代理会剥离 `data:` 前缀，也会引发此问题。