中文 ▾

SillyTavern API 设置:配置 OpenAI 兼容 API

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

无审查 AI:LLM API 与本地模型与云服务

更新于

带有面具和发光对话气泡的戏剧舞台,指向一个插头:将 SillyTavern 连接到 API

要点

  • 需输入 OpenAI 兼容来源、基础 URL、API 密钥和模型名称 uncensored。
  • 客户端的上下文大小应适配 API 的 100,000 token 窗口及您的预算。
  • 常见错误来源包括基础 URL 错误或密钥拼写错误。
  • 角色扮演每条消息成本仅为几分钱,因为历史记录每次都会发送。

您需要的四个值

SillyTavern 是一个用于聊天和角色扮演的人物卡片前端。它可以连接到各种文本来源,包括支持 OpenAI 格式的接口。连接需要以下四项信息:

  • 来源: OpenAI 兼容或自定义聊天补全来源
  • 基础 URL: https://api.unzensiertesllm.com/v1
  • API 密钥: 来自 获取 API 密钥 页面的密钥
  • 模型名称: uncensored

菜单和字段的名称可能因 SillyTavern 版本而异。请参照上述术语,如有差异,请阅读 SillyTavern 官方文档。

逐步连接

  1. 登录(Google 或带密码的电子邮件),然后生成密钥。登录后,点击即可领取 $0.50 测试额度:每人限领一次,有效期 7 天,无需提供支付信息。
  2. 在 SillyTavern 中打开 API 连接区域。
  3. 选择 API 类型为 Chat Completion,来源选择自定义、OpenAI 兼容条目(具体名称取决于您的版本)。
  4. 输入带有 /v1 后缀的基础 URL。
  5. 粘贴密钥,确保首尾无空格。
  6. 将模型指定为 uncensored,或在客户端查询模型列表时从中选择。
  7. 连接并发送一条简短的测试消息。

如果客户端显示模型列表,它会调用 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。上下文越多,价格越高。

您的密钥只需点击一下即可获得

创建账户,复制密钥,调整基础 URL。就这样。

获取 API 密钥