中文 ▾
获取 API 密钥

更新于

SillyTavern 中的 DeepSeek API 密钥:连接我们的 API

SillyTavern 可以通过其自定义来源连接到任何兼容 OpenAI 的接口。本指南展示了需要填写的字段、适合长角色扮演的合理上下文设置,以及每次聊天的费用。

舞台插图,上面有连接到服务器的浮动面具,代表 SillyTavern 中与 API 的角色扮演聊天

快速设置

对于 DeepSeek API 密钥 sillytavern 设置,先澄清一点。由 DeepSeek 官方平台颁发的密钥用于 DeepSeek 的接口。你在此网站获得的密钥属于另一项服务:一个独立的、兼容 OpenAI 的 API,运行一个开放权重模型,针对合法成人用途进行优化,可无内容拒绝地回答。它不是 DeepSeek 的官方 API,因此请仅在此网站的 Base URL 下使用此网站的密钥。

在 SillyTavern 中输入的值如下:

  • 来源: Chat Completion,然后 Custom(OpenAI 兼容)
  • 自定义接口(基础 URL): https://api.deepseekapikey.com/v1
  • API 密钥: 你账户中的密钥
  • 模型 ID: uncensored

SillyTavern 更新频繁,菜单标签在不同版本中可能会有所变化,因此如果名称不同,请根据含义匹配。本页面的其余部分将逐步介绍每个步骤以及长角色聊天中重要的设置。

界面中的分步指南

  1. 获取密钥。 在 API 密钥页面 使用 Google 或邮箱密码注册。新用户可一键领取 $0.50 免费试用额度,有效期 7 天,每人限一次,无需绑定银行卡。
  2. 打开 API 连接面板。 在 SillyTavern 中,点击顶部的插头图标以打开 API 连接。
  3. 选择 API 类型。 从 API 下拉菜单中选择 Chat Completion。文本补全模式适用于接受原始提示词的后端;此 API 使用聊天消息。
  4. 选择来源。 在 Chat Completion Source 列表中,选择 Custom(兼容 OpenAI)。
  5. 输入接口。 将 https://api.deepseekapikey.com/v1 粘贴到自定义接口字段中。SillyTavern 会自动添加聊天补全路径,因此请留空。如果稍后出现 404 错误,请尝试使用完整路径作为第二次尝试。
  6. 输入密钥。 将密钥粘贴到自定义 API 密钥字段中。
  7. 输入模型。 在模型 ID 字段中输入 uncensored。如果模型下拉列表从 GET /v1/models 接口加载,你可以从那里选择它。
  8. 连接。 点击连接。绿色状态和模型名称表示调用成功。向角色发送消息以确认。

如果连接失败,请在终端中在 SillyTavern 之外进行测试。这样可以隔离问题:

curl https://api.deepseekapikey.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "uncensored", "messages": [{"role": "user", "content": "Reply with the word ready."}], "max_tokens": 10}'

正常的 JSON 回复表示密钥和 URL 有效,问题出在 SillyTavern 的字段中。快速入门 列出了更多示例。

上下文大小和响应长度

这是角色扮演设置要么运行良好要么浪费金钱的地方。模型具有 100,000 token 的上下文窗口,计算提示词和回复的总和。SillyTavern 在采样设置中有一个上下文大小滑块,用于控制将多少历史记录和角色数据打包到每个请求中。

你可以将其设置为高达 100,000,但要考虑这意味着什么。SillyTavern 在每一轮构建完整的提示词:系统提示词、角色卡、lorebook 条目、人格,然后是尽可能多的聊天记录。较大的设置意味着模型会看到更多的过去,并且你将为每条消息中的每个 token 付费。

选择的一个实用方法:

  • 8,000 到 16,000 个 token: 短场景和快速聊天。便宜且快速。
  • 30,000 到 50,000 个 token: 具有详细角色卡和 lorebook 的长故事。适合大多数用户。
  • 高达 100,000 个 token: 大型 lorebook 或非常长的连续故事。留出余量,以便提示词加上回复保持在窗口内。

对于响应长度,将最大响应长度设置为 300 到 600 token 以生成典型的角色扮演回复。API 中的 max_tokens 参数是可选的,但 SillyTavern 会发送一个值,且限制可以防止过长的回复导致账单激增。开启流式输出选项,以便在生成时显示文本;API 支持带有 stream: true 的服务器发送事件。

传递惩罚和采样值按界面建议的方式工作。Temperature、Top P、frequency penalty 和 presence penalty 被发送到模型,stop sequences 和固定 seed 也作为参数传递。从大约 0.8 的 temperature 开始并调整:如果角色记不住事实,请降低;如果回复感觉重复,请提高。

角色扮演费用

价格为每 1M 输入 token $0.15,每 1M 输出 token $0.50。输入占主导地位是因为重新发送的历史记录。计算示例,每次回复 400 个 token:

提示词大小输入成本输出成本(400 个 token)每条消息100 条消息
8,000 token$0.0012$0.0002$0.0014$0.14
20,000 token$0.0030$0.0002$0.0032$0.32
50,000 token$0.0075$0.0002$0.0077$0.77
100,000 个 token$0.0150$0.0002$0.0152$1.52

检查一行:20,000 / 1,000,000 x $0.15 = $0.003,400 / 1,000,000 x $0.50 = $0.0002,总计 $0.0032。在该大小下,$0.50 的试用额度大约可以覆盖 156 条消息。失败或被拒绝的请求不会收费,因此错误后的重试不会增加账单。滑动和重新生成会计费,因为每个都是一次新的已完成请求。

额度为预付,永不过期,无订阅。充值金额为 $20 至 $500 的整数,$50 起加 5%,$100 起加 10%,$200 起加 15%。例如,充值 $100 获得 $110 额度。支持加密货币(TRC20 上的 USDT、Base 上的 USDC)支付。定价页面 有当前列表。

群聊、滑动和速率限制

SillyTavern 可以发送短时间内连续的多个请求:群聊中多个角色依次回复、滑动,以及总结或生成侧面内容的扩展。完整密钥允许 8 个并发请求和每分钟 300 个请求。试用密钥允许 2 个并发和每分钟 60 个。

如果看到代码为 concurrency 的错误,表示并发请求过多。在再次滑动之前等待当前流式输出完成,因为流式请求会保留其槽位直到流结束。代码为 rate_limited 的错误表示每分钟请求过多。带有 Retry-After: 5 报头的 429 错误是临时过载,会很快清除。

对于长故事,建议使用摘要扩展或 lorebook 条目来延续事实,以便保持较低的上下文大小。在提示词顶部添加早期事件的简短摘要,比保留五万个 token 的原始历史记录成本低得多。

修复常见问题

连接显示未授权

密钥错误,末尾有空格,或者来自其他服务。由 DeepSeek 平台颁发的密钥不适用于此基础 URL。

连接显示未找到

检查接口拼写。在常见设置中,它应以 /v1 结尾。某些构建期望完整的聊天补全路径,因此如果短形式失败,请尝试 https://api.deepseekapikey.com/v1/chat/completions。

回复内容简短或被截断

提高最大回复长度。如果仅在长对话中出现截断,说明提示词已接近上下文窗口限制;请适当降低上下文窗口大小,为回复留出空间。

角色忘记了早期事件

这是上下文设置的作用。请提高上下文窗口大小,或将关键事实放入角色卡、人格设定或 lorebook 条目中,以确保它们出现在每条提示词中。

回复被拒绝

模型针对合法成人用途进行了无内容拒绝的优化,但有一条规则不变:禁止涉及未成年人的性内容。该领域的角色和场景会被拒绝。该服务仅支持文本,因此 SillyTavern 中的图像生成需要不同的后端。

通过 API 发送的提示词不会用于训练。除非你移动它们,否则聊天文件将保留在你机器上 SillyTavern 的数据文件夹中。如果你想了解本服务与 DeepSeek 自有服务之间的区别,请参阅 DeepSeek API:常见误区与事实。

问答

我可以在 SillyTavern 中使用 DeepSeek 颁发的密钥进行此设置吗?

否。密钥仅对发行方有效。DeepSeek 密钥请使用 DeepSeek 的接口;本站密钥请使用 https://api.deepseekapikey.com/v1。

我在 SillyTavern 中应该选择哪个来源?

选择 Chat Completion,然后选择 Custom(OpenAI 兼容)。输入基础 URL、你的密钥和模型 ID uncensored。

上下文可以有多大?

上下文窗口为 100,000 token,包含提示词和回复。更高的设置会使每条消息的成本更高,因为历史记录会在每一轮重新发送。

支持流式输出吗?

支持。流式输出通过服务器发送事件运行,你可以在 SillyTavern 中开启它。流式请求会占用并发槽位,直到结束。

我如何免费测试?

新用户可以在注册后,在 API 密钥页面一键领取 $0.50 的免费试用额度。有效期为 7 天,无需绑定银行卡。

只差一步,即可获得密钥

创建账户,复制密钥,更改基础 URL。这就是全部设置。

获取 API 密钥