空白角色测试
复现：暂时关闭扩展、世界书及复杂角色卡，使用 Test Message 后在空白会话发送一句话。
通过：两次都有有效文本，确认选择的模型与实际请求一致。
正在打开页面…
正在加载内容，请稍候。
- 应用 / 开发工具
选择对应协议，填写 Key 与 Base URL
- apizt 网关
核对模型 ID、令牌分组和可用额度
- 模型返回结果
检查响应正文与后台用量记录
先给结论
适用范围与接入结论
酒馆选择 Chat Completion → Custom (OpenAI-compatible)，Custom Endpoint 填 https://api.apizt.com/v1，Key 和模型 ID 分别填写。不要把 /chat/completions 加进 Base URL。
适合角色扮演、人物卡及长对话。角色卡、世界书、作者注释和历史记录都会进入提示词，单轮短测的费用与真实长会话不同。
按真实任务判断是否可用
恢复长会话
复现：逐项恢复角色卡、世界书和历史记录，记录首次失败时新增的上下文。
通过：能定位到导致超限或格式不兼容的具体项。
先选对协议和请求地址
Custom Endpoint 是 OpenAI 兼容聊天基址，SillyTavern 会拼接聊天路径。状态检查可因模型列表行为而单独失败，Test Message 才会发送真实模型请求。
按当前工具填写的配置示例 · 模型 ID 与 Key 需要换成自己的
API：Chat Completion
Source：Custom (OpenAI-compatible)
Custom Endpoint：https://api.apizt.com/v1
Custom API Key：apizt 令牌
Enter a Model ID：平台可用的完整模型 ID这是字段与路径示例，不包含有效密钥。所选模型是否支持对应协议、工具与图像能力，应按令牌授权和实际调用结果核对。
生成 SillyTavern 酒馆配置 配置与验证清单照这个顺序接入
- 01
选择聊天协议
在 API Connections 中选 Chat Completion 与 Custom (OpenAI-compatible)，不要选 Text Completion 或把完整端点当基址。
- 02
核对模型与提示词处理
填写完整模型 ID。Prompt Post-Processing 起步保持默认；仅在真实返回指出角色格式问题时调整。
- 03
分两轮验证
Test Message 可能计费。它成功后还要在空白角色会话实际回复，再逐步恢复角色卡与扩展。
对照工具配置与验证顺序
验证到哪一步？
文档站保留 SillyTavern 1.19.0 release 的本地中文截图，字段为 Custom Endpoint、Custom API Key 与 Model ID。
- 现有依据
- 本地界面字段已核对
- 验证边界
- 没有 SillyTavern 带 Key 实际付费聊天记录；本文的复现步骤需要用户在自己的角色会话执行。
- 资料日期
- 核对公开配置说明；客户端调用记录以各链接标注的日期为准。
出现这些现象，先查哪里
| 现象 | 可能原因 | 下一步 |
|---|---|---|
| 404 /chat/completions/chat/completions | Custom Endpoint 填了完整请求路径。 | 改回 /v1 基址后确认最终 URL。 |
| 连接灯正常但角色不回复 | 状态检查或列表读取并不验证角色会话。 | 用 Test Message 与空白角色会话分别测试。 |
| 短测可用，角色卡超限 | 系统提示、角色卡、世界书及聊天历史合并后过长。 | 记录总上下文并保留输出 token 空间，逐项移除复现。 |
选出你的现象，查看下一步
只需选择错误类型，无需粘贴密钥或完整日志。本页不会发送 API 请求，也不会自动判定连接成功。
先取得错误详情，暂时不能确定原因
- 展开错误详情，记录时间、HTTP 状态、错误码和最终请求路径。不要只截最外层提示。
- 核对服务商协议、模型 ID、API 地址；然后按对应教程进行同条件终端检查。
确认 Test Message 与实际角色会话各自返回有效文本；连接指示正常或模型列表出现均不能替代回答验证。
查看 酒馆 SillyTavern 完整配置教程记录仅在浏览器中生成；下载后可补充脱敏结果，便于对照复测或提交客服。
- 响应包含有效结果
- 文本请求有可读取的输出；异步任务需要继续查询到完成状态，不能只把提交成功当作生成成功。
- 日志与请求对得上
- 核对调用时间、模型、令牌分组和用量。界面与账单显示不同货币时，先确认计价口径。
- 原工具中也能重复完成
- 最小示例成功但工具失败，优先检查工具的协议、模型映射和配置生效位置。反馈问题时隐藏完整 Key、Cookie 和个人数据。
把选好的模型，接入你的应用
从 Claude、GPT、Gemini 等模型中选择所需能力。获取 API Key，按工具配置接口地址，再用一个小请求确认结果和费用。
创建 API Key
在控制台创建令牌，选择需要使用的模型权限。
填写接入配置
按工具要求填写 API Key、接口地址与模型 ID。
发起第一次调用
确认收到有效结果，再到控制台查看用量与费用。
常见问题
SillyTavern 自定义 API 的 Base URL 要加 /chat/completions 吗？
现有配置使用 Custom Endpoint 根地址到 /v1，不再追加 /chat/completions，由客户端拼接聊天路径。不同版本先核对字段说明，再看实际请求 URL。
酒馆空白对话成功但角色卡没有回复怎么排查？
逐步加入角色卡、世界书、历史和扩展，检查哪一部分触发角色格式或上下文错误。总输入需包含系统提示与全部历史，并给最大输出留空间。
酒馆 SillyTavern 应该填写哪个 API 地址？
Chat Completion → Custom (OpenAI-compatible)；Custom Endpoint (Base URL) 为 https://api.apizt.com/v1，不附加 /chat/completions。
终端请求成功，为什么客户端仍然失败？
Prompt Post-Processing 先保持默认或 None；仅根据模型返回的角色格式错误调整。 输入包含角色卡、世界书、历史和系统提示；给最大输出预留空间，不能只计算用户最后一句话。 终端结果只有在同一 Key、模型、端点和实际运行网络下才具有可比性。
本页是否代表已经实测全部功能？
不是。本页为配置核对与排错指南，依据官方文档及现有教程整理。客户端版本和真实调用结果需要按步骤记录；网页检查通过不能替代客户端实测。