中文 ▾
获取 API 密钥

SillyTavern API 设置:OpenAI 兼容连接指南

本文结合验证命令,说明 sillytavern api 设置中容易混淆的连接地址、密钥、模型名称和上下文值。

更新日期

要点

  • 连接方式选择 Chat Completion 自定义(OpenAI 兼容)
  • URL 为 https://api.mukenetsuapi.com/v1、模型名为 uncensored
  • 上下文最大支持 100,000,但出于成本和速度考虑,建议限制
  • 401 检查密钥,404 检查 URL,429 检查并发或请求次数是否超限
SillyTavern API 连接示意图:舞台面具与服务器插头通过发光线缆连接

准备所需的 3 项内容

sillytavern api 设置本身步骤简单,多数问题源于输入值错误。请先准备好以下 3 项。

  • API 密钥:前往 获取 API 密钥页面 生成。新注册后可一键领取 $0.50 试用额度。
  • Base URL:https://api.mukenetsuapi.com/v1
  • 模型名称:uncensored

SillyTavern 是一个支持添加 OpenAI 兼容接口的客户端。由于本 API 兼容 OpenAI,无需选择官方 OpenAI,可将其注册为自定义接口。

连接步骤

菜单文本可能因版本而异。此处介绍通用流程。若不一致,请参考 SillyTavern 官方文档。

  1. 打开顶部的“API Connections”(插头图标)。
  2. API 类型选择“Chat Completion”。
  3. 在源列表中,选择 OpenAI 兼容的自定义连接(Custom)。
  4. 在端点 URL 输入 https://api.mukenetsuapi.com/v1。末尾不要添加 /chat/completions。
  5. 在 API 密钥栏粘贴生成的密钥,注意不要包含前后空格。
  6. 将模型名称设置为 uncensored。若可从列表选择则选择,若需手动输入则直接输入。
  7. 点击连接按钮,确认是否显示成功提示。

连接前,在终端中确认密钥和 URL 是否正确,可以简化排查原因的过程。

curl https://api.mukenetsuapi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "uncensored", "messages": [{"role": "user", "content": "こんにちは"}], "max_tokens": 50}'

若返回响应,说明密钥、URL 和模型名称正确。此时若 SillyTavern 失败,可怀疑应用侧输入有误。

确定上下文和响应长度

本 API 的上下文窗口允许提示词和输出合计最多使用 100,000 token。但不建议将 SillyTavern 上下文设为最大值,因为每次都会重新发送角色设定、世界观和历史记录,值越大单次输入量越大。

费用计算示例

若上下文使用 16,000 token,响应 300 token,则每条消息的费用如下:

  • 输入:16,000 ÷ 1,000,000 × $0.15 = $0.0024
  • 输出:300 ÷ 1,000,000 × $0.50 = $0.00015
  • 总计:$0.00255

100 条消息收费 $0.255。将上下文减半至 8,000,输入侧成本约减半。单价详情见 价格页面。

建议

如果不是长篇故事或多人群像场景,建议先从 8,000 到 16,000 开始,当感觉角色忘记了过往事件时再增加,这是比较现实的做法。最大响应长度应根据你希望作为单次回复阅读的长度来设定。max_tokens 是可选的,但如果想避免过长的回复,建议在 SillyTavern 端设置上限以确保安全。

采样设置思路

temperature、top_p、stop、seed 以及各种惩罚参数将直接传递给 API。您可以通过 SillyTavern 预设进行调整。

  • 重复表达:稍微提高 frequency 或 presence 惩罚。
  • 回复发散:降低 temperature。
  • 单调:稍微提高 temperature。
  • 进行比较:固定 seed,逐个改变数值。

预设项名称因 SillyTavern 版本而异。如果设置未生效,请检查所使用的连接方式是否支持该选项,或查阅 SillyTavern 文档。

常见错误与解决方法

症状可能原因解决方法
401密钥不同或包含空格重新粘贴密钥,并使用 curl 测试同一密钥。
404URL 不正确确认末尾是否为 /v1。
未找到模型模型名称拼写以小写形式输入 uncensored。
429(concurrency)并发请求过多减少滑动连击或群聊的并发生成。
429(rate_limited)每分钟请求数超限稍作等待。
429(Retry-After: 5 附带)暂时拥堵等待 5 秒后重试。

完整密钥的上限为并发 8,每分钟 300;试用密钥为并发 2,每分钟 60。流式响应在结束前会占用 1 个并发连接槽位。使用试用密钥进行群聊会迅速占满槽位。

您可以通过以下命令确认余额是否充足。

curl https://api.mukenetsuapi.com/v1/balance \
  -H "Authorization: Bearer YOUR_API_KEY"

也可以从响应头 X-Balance-USD 中读取。查看模型列表请使用 GET /v1/models。

curl https://api.mukenetsuapi.com/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

使用注意事项

此 API 仅支持文本。如需使用 SillyTavern 的图像生成或语音功能,需要其他服务。内容假设用于合法的成人用途范围内的小说、角色扮演或伴侣应用等虚构内容。禁止涉及未成年人的性内容。提示词不会用于模型训练。

更详细的参数请参见 文档。支付支持 USDT(TRC20)或 USDC(Base),金额为 $20 至 $500 的整数额。

其他指南

常见问题

SillyTavern 使用的模型名称是什么?

uncensored。请以小写形式直接输入。

URL 末尾需要 /chat/completions 吗?

不需要。基础 URL 只需到 /v1,剩余路径由应用自行添加。

试用密钥够用吗?

用于连接测试或简短对话已足够。但试用密钥限制为并发 2、每分钟 60,且有效期为 7 天,因此如果使用群聊,请充值普通密钥。

可以生成图像吗?

不可以。此 API 仅支持文本,不支持图像、语音和视频生成。

上下文窗口应该设置多少?

最大支持 100,000 个 token,但建议先从 8,000 到 16,000 开始尝试。上下文越大,每次输入量增加,费用也会越高。

通过 1 个表单即可获取 API 密钥

创建账户、复制密钥、修改基础 URL。完成这些步骤即可全部设置完毕。

获取 API 密钥