SillyTavern API 设置:配置 OpenAI 兼容 API
准备四个值即可快速设置 SillyTavern API:来源、基础 URL、密钥和模型名称。下文将说明填写内容、选择上下文和回复长度的方法,以及故障排除。


要点
- 需输入 OpenAI 兼容来源、基础 URL、API 密钥和模型名称 uncensored。
- 客户端的上下文大小应适配 API 的 100,000 token 窗口及您的预算。
- 常见错误来源包括基础 URL 错误或密钥拼写错误。
- 角色扮演每条消息成本仅为几分钱,因为历史记录每次都会发送。
您需要的四个值
SillyTavern 是一个用于聊天和角色扮演的人物卡片前端。它可以连接到各种文本来源,包括支持 OpenAI 格式的接口。连接需要以下四项信息:
- 来源: OpenAI 兼容或自定义聊天补全来源
- 基础 URL:
https://api.unzensiertesllm.com/v1 - API 密钥: 来自 获取 API 密钥 页面的密钥
- 模型名称:
uncensored
菜单和字段的名称可能因 SillyTavern 版本而异。请参照上述术语,如有差异,请阅读 SillyTavern 官方文档。
逐步连接
- 登录(Google 或带密码的电子邮件),然后生成密钥。登录后,点击即可领取 $0.50 测试额度:每人限领一次,有效期 7 天,无需提供支付信息。
- 在 SillyTavern 中打开 API 连接区域。
- 选择 API 类型为 Chat Completion,来源选择自定义、OpenAI 兼容条目(具体名称取决于您的版本)。
- 输入带有
/v1后缀的基础 URL。 - 粘贴密钥,确保首尾无空格。
- 将模型指定为
uncensored,或在客户端查询模型列表时从中选择。 - 连接并发送一条简短的测试消息。
如果客户端显示模型列表,它会调用 GET /v1/models。如果显示 uncensored,则地址和密钥正确。
在 SillyTavern 之外预先检查连接
如果出现问题,请脱离客户端单独检查地址和密钥。这能避免猜测。
curl https://api.unzensiertesllm.com/v1/models \
-H "Authorization: Bearer DEIN_SCHLUESSEL"
curl https://api.unzensiertesllm.com/v1/chat/completions \
-H "Authorization: Bearer DEIN_SCHLUESSEL" \
-H "Content-Type: application/json" \
-d '{"model": "uncensored", "messages": [{"role": "user", "content": "Sag kurz Hallo."}], "max_tokens": 30}'如果 curl 有响应,问题在客户端;如果 curl 无响应,问题在密钥、地址或网络。您可以在响应头 X-Balance-USD 中查看余额。
正确选择上下文大小和回复长度
两个设置决定了每条消息发送和生成的量:
- 上下文大小(Context Size): 历史记录、人物描述和世界信息总共包含多少个 token。API 允许提示词和回复总共最多 100,000 个 token。您不必用满。许多角色扮演只需几千个 token,且每条消息都会消耗上下文 token。
- 回复长度(Response Length): 对应
max_tokens。API 中该参数可选;在客户端中最好设置它,以防止回复过长。
经验法则:选择上下文大小,使人物卡片、重要笔记和最近几十条消息能容纳在内。更早的内容可由客户端丢弃,或进行总结。
采样器值
API 传递 temperature、top_p、stop、seed 和惩罚参数。从适中值开始,例如温度 0.8,每次只更改一个设置。SillyTavern 为特定来源提供的其他采样器可能不受此接口支持;它们将无效。请在 文档 中检查。
角色扮演会话的成本
价格:输入 token 每 1M 为 $0.15,输出 token 每 1M 为 $0.50。假设每条消息发送 8,000 token 上下文并接收 350 token 回复:
- 输入:8,000 / 1,000,000 × $0.15 = $0.0012
- 输出:350 / 1,000,000 × $0.50 = $0.000175
- 总计:每条消息 $0.001375
200 条消息的会话费用为 $0.275。$0.50 的测试额度足以支持约 363 条此类消息(0,50 / 0,001375 ≈ 363,6)。将上下文扩展至 16,000 token 时,输入部分费用升至 $0.0024,单条消息费用升至 $0.002575。
您可以使用 TRC20 上的 USDT 或 Base 上的 USDC 充值 $20 至 $500 之间的任意整数金额。充值 $50 起享 +5% 奖金,$100 起 +10%,$200 起 +15%。额度永不失效。阶梯详情见 价格页面。
典型错误及其解决方案
| 消息或症状 | 原因 | 解决方案 |
|---|---|---|
| 401 或认证错误 | 密钥错误、截断或包含空格 | 重新粘贴,使用 curl 验证 |
| 404 或模型未找到 | /v1 缺失或模型名称错误 | 填写带 /v1 的 Base URL,模型为 uncensored |
429 错误,由 concurrency 引起 | 并发请求过多(测试密钥:2,完整密钥:8) | 群聊改为串行而非并发,关闭流式输出标签页 |
429 错误,由 rate_limited 引起 | 每分钟请求过多(分别为 60 或 300) | 不要频繁重新生成 |
429 错误,包含 Retry-After: 5 | 短暂过载 | 等待 5 秒后重试 |
| 回复在句子中间中断 | 客户端设置的回复长度过小 | 增加回复长度 |
| 因上下文过长导致的错误 | 仅历史记录就无法放入 100,000 token 的窗口(回复会被限制在剩余空间内) | 减小客户端上下文大小,缩短旧消息 |
一个流式请求会占用并发请求限制中的一个位置,直到流结束。这解释了当您打开多个聊天时出现的某些意外 429 错误。
内容与隐私说明
该模型经过微调,可无拒绝地服务于成人向的虚构、角色扮演和伴侣场景。它是一个独立供应商提供的单个开放权重模型,并非大型厂商的官方 API。严禁涉及未成年人的性内容。API 仅提供文本,不生成图像或语音。提示词不用于训练。
了解更多关于无审查模型的选择,请参阅 无审查 AI 对比。
更多指南
常见问题
我在 SillyTavern 中应输入哪个 Base URL?
https://api.unzensiertesllm.com/v1, 以 /v1 结尾。模型指定为 uncensored。
合理的上下文大小是多少?
API 允许提示词和回复最多使用 100,000 个 token。对于角色扮演,通常只需几千个 token;更高的数值会增加每条消息的成本。
为什么我会收到 429 错误?
错误代码指出了原因:rate_limited 表示每分钟请求过多,concurrency 表示并发请求过多。使用测试密钥时,限制为每分钟 60 次和同时 2 次。
一次包含 200 条消息的会话成本是多少?
8,000 个 token 的上下文和 350 个 token 的回复约为 $0.275。上下文越多,价格越高。