如何将 SillyTavern 连接到 OpenRouter（2026 指南）
How to Connect SillyTavern to OpenRouter (2026 Guide)
OpenRouter 发布指南，介绍如何用单个 API key 在 SillyTavern 中调用 70+ 家提供商的 300+ 模型，替代分别注册 Anthropic、Google、Mistral 等账号。
原文给出 SillyTavern 接入 OpenRouter 的完整步骤、免费额度规则和常见报错修法，可作配置参考。
在 SillyTavern 中使用多个 AI 模型通常意味着要分别注册 Anthropic、Google、Mistral 等几家服务，每家都有自己的账号，而且往往还要每月支付 20 美元订阅费。一个 OpenRouter 密钥就能取代这一切：只需一个信用余额，就能在 SillyTavern 的一个下拉菜单里使用来自 70 多家提供商的 300 多个模型。许多模型可以免费上手，大约五分钟就能开始聊天。
本指南涵盖连接步骤、值得一试的角色扮演模型、真正重要的设置，以及 SillyTavern 用户最常遇到的错误的修复方法。同一个密钥也可用于编程智能体和编辑器，参见如何将 OpenRouter 与任何编程智能体配合使用。
五步将 SillyTavern 连接到 OpenRouter
在 SillyTavern 的 API Connections 面板中操作。目标是让 SillyTavern 指向 OpenRouter、验证你的密钥、选择一个模型，并在开始较长对话前先发送一条测试消息。
- 打开 API Connections 面板（顶部栏中的插头图标），将 API Type 设为 Chat Completion。
- 将 Chat Completion Source 设为 OpenRouter。
- 点击 Authorize 通过 OAuth 流程创建密钥，或在 openrouter.ai/settings/keys 生成一个密钥并粘贴到 API key 字段中。
- 点击 Connect，等待 SillyTavern 验证密钥。
- 从下拉菜单中选择一个模型，然后点击 Test Message。
在投入长时间会话之前，先发送那条测试消息。Connect 成功只能证明 SillyTavern 能验证你的密钥。如果模型不可用、提供商路由无法处理请求、slug 有误、你的账号无法访问该模型，或者你的提示超出了模型的上下文窗口，生成仍然可能失败。
几乎所有配置都使用 Chat Completion。图像内联和工具调用只能通过 Chat Completion 工作，这也符合当前 OpenRouter 模型对提示的预期方式。Text Completion 为高级用户提供对原始提示格式的更精细控制，但不适合作为起点。如果你的版本中 OpenRouter 只出现在 Chat Completion 来源下，这是正常的。完整设置详情见 SillyTavern OpenRouter 文档。
免费模型与 $10 信用额度规则
标记为 :free 的模型每 token 费用为 $0，但请求限制仍然适用，这一点常让人措手不及。
| 账户状态 | 每日 :free 上限 | 每分钟上限 |
|---|---|---|
| 信用额度低于 $10 | 50 次请求/天 | 20 次请求/分钟 |
| 信用额度 $10 或以上 | 1,000 次请求/天 | 20 次请求/分钟 |
这 $10 是一次性购买信用额度，不是订阅，并且仍可用于付费模型。OpenRouter 不对提供商定价加价，所以你支付的就是目录价格，失败的请求不计费。如果你已经直接向某提供商付费并希望保留该合约，可以改为自带密钥。
“免费”模型产生费用几乎总是意味着触发了按 token 计费和请求限制。检查你是否实际选择了付费模型、启用了付费回退路由，或使用了不以 :free 结尾的 slug。达到免费模型上限是限制问题，而不是免费模型在向你收费。
值得一试的角色扮演模型
DeepSeek V3.2 是长场景中便宜、可靠的默认选择。如果需要更具表现力、过滤更少的文本，可以试试 Euryale 微调版。当角色卡带有模型必须遵循的复杂指令时，Hermes 4 405B 比大多数模型处理得更好。
| 模型 slug | 上下文 | 每 1M 输入/输出 | 免费变体 | 最适合 |
|---|---|---|---|---|
deepseek/deepseek-v3.2 | 131K | $0.23 / $0.34 | 否 | 长会话中便宜、连贯的默认选择 |
deepseek/deepseek-r1-0528 | 164K | $0.50 / $2.15 | 否 | 推理密集型场景与规划 |
sao10k/l3.3-euryale-70b | 131K | $0.65 / $0.75 | 否 | 富有角色个性的 RP 散文，长上下文窗口 |
gryphe/mythomax-l2-13b | 4K | $0.06 / $0.06 | 否 | 经典预算主力，上下文极小 |
aion-labs/aion-rp-llama-3.1-8b | 32K | $0.80 / $1.60 | 否 | 专为角色扮演调校，轻量级 |
nousresearch/hermes-4-405b | 131K | $1.00 / $3.00 | 否 | 复杂角色卡，严格遵循指令 |
z-ai/glm-4.6 | 203K | $0.43 / $1.74 | 否 | 强大的通用模型 |
mistralai/mistral-large-2512 | 262K | $0.50 / $1.50 | 否 | 打磨精良的付费选项，过滤较少 |
价格和上下文窗口已于 2026-06-16 对照 OpenRouter 目录核实。按 token 计费的价格会变动，因此在进行长时间会话前，请到模型页面确认。
免费变体来去无常，而模型本身并未改变，且它们运行的上下文窗口通常比付费版更小。这正是角色卡在场景中途开始遗忘的常见原因。在围绕任何免费模型搭建配置之前，请查看 openrouter.ai/models?q=free，确认确切的 :free slug 仍然有效。
重要的设置与路由
先从保持聊天稳定的设置入手，等连接稳定后再进行调优。
- 开启流式传输，让回复在模型生成时即时显示。
- 将上下文长度滑块设为上表中该模型的真实窗口。免费变体更小，因此请查看目录页面，而不是第三方指南。
- 为可靠性保留回退提供商启用。仅当你需要精确控制由哪个提供商处理请求时，才禁用它们。
- 对于系统提示词庞大或 lorebook 上下文重复的长时运行角色，使用 提示缓存。它不会让请求免费，但能降低多轮对话中重复输入的成本。
两个路由后缀加在模型 slug 末尾。:nitro 会排序到最快的提供商；:floor 会排序到最便宜的。两者都对应 OpenRouter 的 提供商路由排序选项。对于使用固定角色卡的长会话，:floor 加上提示缓存能显著降低成本。对于时间敏感的生成，请使用 :nitro。
关于流式传输的一条计费说明：中止流式传输只会对支持取消的提供商停止处理和计费。有几家不支持，包括 AWS Bedrock、Groq、Google、Google AI Studio、Minimax 和 Mistral。对于这些提供商，或对于非流式请求，模型可能运行至完成并按完整响应计费。
保持角色扮演聊天私密
OpenRouter 的隐私取决于两个层面：OpenRouter 存储什么，以及处理你请求的提供商存储什么。除非你选择启用日志记录，否则 OpenRouter 不会存储提示词或响应，但会保留 token 计数和延迟等使用元数据。下游提供商有自己的保留政策，这就是路由控制重要的原因。
启用 零数据保留，以仅路由到不存储提示词或响应的提供商，可按请求或账户范围启用。OpenRouter 可能会为选择启用提示词和补全日志记录提供小幅折扣；大多数角色扮演用户应保持关闭，而不是将角色卡和聊天历史暴露给日志。
OpenRouter 本身不过滤内容，但它会路由到执行自身政策的提供商，因此称该配置为“无审查”是夸大其词。如果模型不断拒绝或截断场景，那是提供商的内容审核。请切换到过滤较少的模型或提供商。信任中心有具体细节。
修复最常见的错误
大多数 SillyTavern 和 OpenRouter 问题都归为几种模式。从确切的错误消息入手，然后应用相应的修复方法。
“Could not verify OpenRouter token.” 这是一个常见错误，而且这条提示具有误导性。密钥几乎总是没问题的；真正的原因是 DNS 或网络问题，导致 SillyTavern 无法访问 openrouter.ai，因此请求从未得到验证。请在你的密钥页面确认密钥处于有效状态，重新粘贴并确保末尾没有空格，如果你使用的是 OAuth 就重新授权，然后重启。如果问题仍然存在，请将 DNS 解析器切换为 8.8.8.8 或 1.1.1.1 并重启。大多数情况下，DNS 就是解决办法。
401 错误。 这意味着 OpenRouter 拒绝了 SillyTavern 发送的密钥。请重新生成密钥，重新粘贴并确保末尾没有空格，如果你调用的是付费模型，请确认账户有余额。
来源列表中缺少 OpenRouter。 请先将 API 类型设置为 Chat Completion，因为它在其他类型下不会显示。更新并重启 SillyTavern。只有在较旧或不寻常的安装环境中才需要编辑 config.yaml，在那里 show_openrouter_api: true 是作为一种变通方案存在，而非默认设置。修改前请先查看相关的 SillyTavern issue。
模型下拉列表为空。 账户通常没问题；是 SillyTavern 加载列表失败。请刷新连接并重启。如果仍然失败，请从模型页面手动输入准确的模型 slug。
连接成功，但生成失败。 连接成功只能证明密钥有效。请切换到另一个模型进行测试，确认账户对付费模型有余额，检查 slug，如果大型角色卡、世界书或历史记录超出了上下文窗口，请降低上下文长度。
常见问题
如何将 OpenRouter 连接到 SillyTavern？
打开 API Connections 面板，将 API 类型设置为 Chat Completion，选择 OpenRouter 作为来源，点击 Authorize 获取 OAuth 密钥，或从 openrouter.ai/settings/keys 粘贴一个密钥，点击 Connect，选择一个模型，然后发送一条测试消息。
OpenRouter 对 SillyTavern 真的免费吗？
对于标记为 :free 的模型，是的，但有额度限制。免费模型的使用上限为每天 50 次请求、每分钟 20 次。一次性购买 10 美元额度可将每日上限提升至 1,000 次请求，而每分钟上限保持不变。这不是订阅制，额度仍可用于付费模型。
SillyTavern 角色扮演的最佳免费模型是什么？
meta-llama/llama-3.3-70b-instruct:free 是一个不错的选择，可用时具有 131K 上下文。免费模型的可用性经常变化，因此在围绕它搭建配置之前，请先在 openrouter.ai/models?q=free 确认准确的 :free slug 仍然有效。
如何修复“could not verify OpenRouter token”？
这通常是 DNS 或网络问题，而不是密钥无效。请将 DNS 切换为 8.8.8.8（Google）或 1.1.1.1（Cloudflare），确认密钥有效，重新粘贴并确保末尾没有空格，然后重启 SillyTavern。
为什么我的生成会提前停止？
请先检查响应的 finish reason，因为同样的症状可能有多种原因：提供商审核、最大 token 限制、上下文长度问题或流式传输行为。如果某个提供商总是截断场景，请尝试其他模型或提供商；如果响应只是结束得太早，请提高最大输出设置。
SillyTavern 应该用 OpenRouter 还是单一提供商密钥？
如果你只使用一个提供商并希望计费最简单，请使用直接密钥。如果你希望用一套配置支持多种模型、提供商路由、路由故障时的回退、可试验的免费模型以及单一额度池，请使用 OpenRouter。
来源：OpenRouter Blog · openrouter.ai