在 SillyTavern 中使用 DeepSeek API：自定义接口

五步设置

如何在 SillyTavern 中使用 deepseek api 的问题归结为一个事实：SillyTavern 可以连接到任何兼容 OpenAI 的接口，因此你只需提供 URL、密钥和模型 ID。请注意，此服务不是官方 DeepSeek API。它托管一个 ID 为 uncensored 的开放权重模型，由独立提供商运行，并针对合法成人使用进行了调整，以无内容拒绝方式回答。

1. 创建账户并打开 API 密钥页面。复制一个密钥。新用户只需点击一下即可领取 $0.50 的免费试用额度，无需信用卡，有效期为 7 天。
2. 在 SillyTavern 中，打开 API 连接选项卡（顶部栏中的插件图标）。
3. 将 API 类型设置为 聊天补全。然后将聊天补全源设置为 自定义（兼容 OpenAI）。
4. 在自定义接口字段中输入 https://api.deepseekapi.top/v1。将你的 API 密钥粘贴到 API 密钥字段中。在模型 ID 字段中输入 uncensored。
5. 点击连接。绿色状态灯和模型名称表示连接有效。

SillyTavern 版本之间的标签名称略有变化，但思路保持不变：聊天补全模式、自定义源、接口、密钥、模型。从 API 密钥页面获取密钥。

如果连接失败

按顺序检查这些项。大多数故障都是其中之一。

• URL 格式错误。 接口以 /v1 结尾。不要添加 /chat/completions。
• 源错误。 文本补全模式使用不同的请求格式。此 API 提供 POST /v1/chat/completions 和 GET /v1/models，因此请使用聊天补全。
• 密钥粘贴时带有空格。 再次粘贴并查找尾部空格。
• 服务器无法访问互联网。 如果你在家庭服务器或容器中运行 SillyTavern，该机器需要出站 HTTPS 访问权限。

为了将 SillyTavern 问题与密钥问题区分开来，请在终端中测试密钥：

Copycurl https://api.deepseekapi.top/v1/models   -H "Authorization: Bearer YOUR_KEY" | grep uncensored

包含 uncensored 的 JSON 列表表示密钥有效。要检查聊天路由本身：

Copycurl https://api.deepseekapi.top/v1/chat/completions   -H "Authorization: Bearer YOUR_KEY"   -H "Content-Type: application/json"   -d '{"model": "uncensored", "messages": [{"role": "user", "content": "Say hello in one sentence."}]}'

对角色扮演至关重要的设置

流式输出

在聊天补全面板中开启流式输出。API 通过 SSE 发送生成的 token，因此回复在生成时就会显示。流式请求会占用一个并发槽位，直到流结束。完整密钥允许同时 8 个，试用密钥允许 2 个。

上下文大小

该模型拥有 100,000 token 的上下文窗口，包含提示词和补全。你不必全部使用。SillyTavern 会在每条消息中发送角色卡、人设、lorebook 条目以及尽可能多的聊天记录，直到达到你设置的限制。较小的限制意味着更低的账单和更快的回复。对于大多数对话，16k 到 32k token 就足够了。

最大回复长度

将响应限制设置为合理的数值，例如 400 到 600 个 token，以防止回复变成冗长的文章。API 不要求设置 max_tokens，但上限可以保护你的预付额度免受失控输出的影响。

采样

Temperature、top_p、停止序列、seed 和惩罚参数会直接传递给模型。角色聊天的常见初始设置是 temperature 0.8 到 1.0，top_p 约为 0.9。每次只更改一个值。如果角色重复短语，请稍微提高频率惩罚或存在惩罚，而不是提高 temperature。

停止序列

如果模型也开始生成用户的对话内容，请将用户名后跟冒号作为停止序列添加。该设置会直接传递。

首次运行检查清单

在加载你喜欢的角色之前，运行简短的测试对话，以确保连接正常。

1. 创建一个空白角色或使用默认助手卡。
2. 发送 “请用 ready 这个词回复。”。答案应在几秒内返回，并以流式输出形式生成。
3. 如果没有任何内容出现，打开 SillyTavern 控制台或网络日志。401 表示密钥错误，404 表示 URL 或模型 ID 错误，429 表示触发了速率限制。
4. 检查你的余额。每个响应都包含一个 X-Balance-USD 头，因此你可以验证每条消息的预付额度都会减少一点点。
5. 然后加载你的真实角色卡和 lorebook。

如果回复为空或在句子中间被截断，首先查看回复长度设置。限制设置过低会导致回复提前结束，未完成的句子不是模型的错误。

在预设之间切换

SillyTavern 将采样预设与连接配置文件分开保存。值得保存一个用于叙事写作的预设（较高的 temperature），以及一个用于简短事实回复的预设（较低的 temperature）。切换预设不会触及接口或密钥。

角色扮演会话的成本

价格为每 100 万输入 token $0.15，每 100 万输出 token $0.50，从预付额度中扣除，无订阅费。由于历史记录会被重新发送，输入量占比较大。以每条消息 20,000 个 token 的提示词和 400 个 token 的回复进行聊天：

• 输入：20,000 × $0.15 / 1,000,000 = $0.003
• 输出：400 × $0.50 / 1,000,000 = $0.0002
• 总计：每条消息 $0.0032

因此 100 条消息花费 $0.32。现在对比将上下文截断为 8,000 token、回复相同的情况：8,000 × $0.15 / 1,000,000 = $0.0012，加上 $0.0002，每条消息 $0.0014，100 条共 $0.14。减少上下文后成本不到一半。

$0.50 的试用额度在较大上下文规模下可覆盖约 156 条消息（0.50 / 0.0032 = 156.25），或在较小规模下覆盖约 357 条消息（0.50 / 0.0014 = 357.1）。失败或被拒绝的请求不收费，且预付额度永不失效。有关充值金额、奖励和支付方式，请参阅 定价页面；支持银行卡（Visa、Mastercard、Apple Pay、Google Pay）和加密货币（TRC20 上的 USDT、Base 上的 USDC）。

角色、安全与一条硬性规则

该模型针对成人小说、角色扮演和伴侣应用进行了调整。它不是通用的安全过滤器，也不决定什么对你来说合适。这是你的工作：将你的卡片和对话保持在合法成人使用范围内。

唯一的固定限制是禁止涉及未成年人的性内容，没有任何提示词可以改变这一点。在角色卡中保持角色年龄明确为成人。

一些实用习惯有助于提高对话质量：

• 将角色的关键信息放在卡片顶部，不要埋在末尾。
• 使用简短的系统提示词来设定叙述者风格和回复长度。
• 使用 SillyTavern 的摘要功能对聊天记录中的旧部分进行摘要，而不是无限期地保留它们。
• 保持设定集条目简短并通过关键词触发，以便仅在需要时将它们加入提示词。

提示词不用于训练。阅读 快速入门文档 以获取响应头信息，包括 X-Balance-USD，它显示你的剩余余额。

将角色用作伴侣应用后端

有些人将 SillyTavern 用作面向成人的长期伴侣角色的前端。适用规则与任何聊天相同。通过将其写为简短的固定块来保持角色一致性，并让摘要功能处理旧事件。会话之间的长时间间隔不产生费用，因为额度永不过期且没有订阅。

如果你后来构建自己的应用而不是使用 SillyTavern，你可以从代码中调用相同的接口。快速入门文档 展示了 curl、Python 和 Node 示例，使用相同的 Base URL 和模型 ID，因此在 SillyTavern 中有效的提示词可以直接迁移。

繁忙聊天中的速率限制

单个聊天很少达到限制。群聊、滑动操作和多个打开的标签页可能会达到。当你超过每分钟请求限制（试用密钥为 60，完整密钥为 300）时，服务会返回 HTTP 429 状态码并附带代码 rate_limited；当并发请求过多时（试用为 2，完整为 8），会返回 concurrency。

在短暂过载时，你还会收到带有 Retry-After: 5 头的 429 响应。等待五秒后重新发送是正确的做法。如果你在试用密钥上看到这些情况，请关闭额外的标签页或在开始另一次滑动前停止当前滑动。

更多指南

• 在 Cursor 中使用 DeepSeek API：自定义 Base URL 设置
• DeepSeek API Python 示例：聊天、流式输出、工具
• DeepSeek API 密钥：无审查 LLM API 访问权限