酒馆 SillyTavern 配置教程

本教程介绍如何在酒馆 SillyTavern 中接入 apizt：选择聊天补全接口，填写 API 地址、密钥和模型，再打开角色对话。适用于通过 OpenAI 兼容 Chat Completions 接口调用的模型。

一、准备酒馆和 API Key

1. 按官方安装指南安装 SillyTavern，使用 release 分支。已安装的用户直接打开酒馆即可。
2. 启动酒馆，打开终端显示的本地地址，通常为 http://localhost:8000。使用期间保持酒馆服务运行。
3. 进入 apizt 控制台的「令牌管理」，为酒馆创建 API Key，确认令牌额度、分组和模型权限。
4. 到 模型价格页复制当前令牌可用的完整模型 ID，后续填写时保留大小写和后缀。

二、打开 API 连接面板

点击酒馆顶部的插头图标（API Connections）。在 API 下拉框选择 Chat Completion（聊天补全），然后在 Chat Completion Source（聊天补全来源）选择 Custom (OpenAI-compatible)（自定义／兼容 OpenAI）。

中文版与英文版的字段位置基本一致；不同版本的翻译可能略有差异，可按图中的英文名称查找。

三、填写 apizt 地址、密钥和模型

在自定义来源面板中，按下表填写：

如果连接后 Available Models（可用模型）显示列表，可以直接选择模型；列表为空时，在 Enter a Model ID手动填写已经确认可用的模型 ID。列表读取失败不一定表示聊天接口不可用，应继续用测试消息确认。

四、连接并发送测试消息

1. 确认地址、密钥、模型 ID 已填写，点击 Connect（连接）。
2. 点击 Test Message（发送测试消息），等待模型返回结果。测试会调用 API，并按所用模型正常计费。
3. 收到正常回复后，再到 apizt 控制台查看对应调用日志，确认使用了预期模型和分组。

不要只凭连接状态判断成功：模型能返回内容，才说明基础聊天请求可用。本文截图演示配置字段与操作位置，未使用真实 API Key 进行付费调用。

五、选择角色开始聊天

点击顶部的角色管理（Character Management）图标，在列表里选择现有角色。也可以使用角色面板中的创建或导入按钮添加角色卡。

打开角色后，在底部输入框发送一条简短消息，例如「你好，请用中文介绍一下自己」。正常回复后再添加世界书、长角色设定或扩展，便于定位后续问题。

六、聊天参数怎么设置

• 上下文长度（Context Size）：不要超过当前模型与分组的限制。角色描述、世界书、历史聊天及预留回复都会占用上下文。
• 最大回复长度（Max Response Length）：首次测试可从 512～1024 tokens 开始，确认可用后按模型限制增加。
• 流式输出（Streaming）：基础测试成功后再开启；如果只有流式失败，可关闭流式重试并核对错误信息。
• 提示词后处理：默认保留 None。若错误体明确要求消息角色交替或限制 system 消息，再按官方说明选择对应后处理模式。

常见问题

酒馆 API 地址需要填写完整的聊天接口吗？

不需要。填写 https://api.apizt.com/v1，酒馆会追加聊天接口路径。

可用模型列表没有内容怎么办？

在 Enter a Model ID 手动输入当前令牌已放行的完整模型 ID，再点击 Test Message。若测试失败，根据错误体检查密钥、分组、地址和模型权限。

连接成功，但角色没有回复怎么办？

先用 Test Message 测试简单请求。如果测试也失败，检查 API 错误；如果只有角色对话失败，减少角色提示词与世界书、调低上下文和回复长度，再检查消息格式及扩展设置。