酒馆报错排查

遇到酒馆报错时，先不要乱改所有设置。不同错误代表的问题不同，最重要的是先看清楚错误信息。

如果你还没完成 API 配置，请先看 酒馆 API 配置。

先看清楚错误信息

排查前先记录：

• 使用的服务商；
• 模型名；
• 错误码或错误文本；
• 是否能刷新模型列表；
• 是所有聊天都报错，还是某个角色才报错；
• 最近是否改过预设、代理、接口地址或 API Key。

不要在公开截图里暴露 API Key 或私密聊天内容。

API Key 或权限错误

如果出现 forbidden、403、权限不足等错误，优先检查：

• API Key 是否复制完整；
• Key 是否属于当前账号或项目；
• 账号是否有权限使用这个模型；
• 服务商是否限制地区或网关；
• Key 是否被撤销；
• 是否需要选择组织、项目或 route。

接口地址和模型名错误

400 或请求格式错误，常见原因是：

• Base URL 写错；
• /v1 重复或缺失；
• 模型名拼错；
• 模型不支持当前参数；
• 请求内容过长；
• 预设和服务商不兼容。

建议先用短 prompt 和已知可用模型测试。

请求失败或服务端错误

Internal Server Error 不一定是你的配置错了，也可能是服务商或网关临时异常。

先按顺序检查：

1. 稍等后重试；
2. 查看服务商状态；
3. 换一个更短的 prompt；
4. 换一个模型；
5. 换一个 provider route；
6. 检查网络和代理。

额度、频率和服务商限制

免费额度、频率限制、余额不足、模型暂不可用，都可能表现为 API 报错。不要只看 Tavern Studio 设置，也要看服务商后台。

网络和代理问题

如果模型列表刷不出来，或者所有服务商都失败，可能是网络问题。检查代理、公司网络、防火墙、DNS 或系统时间。

重置配置前的检查清单

重置前先确认：

• API Key 正确；
• Base URL 正确；
• 模型名正确；
• 账号有额度；
• 网络可访问；
• 短测试 prompt 也失败。

如果短测试成功，问题可能在角色卡、世界书、预设或上下文长度，而不是 API 配置。

仍然报错时如何反馈

反馈问题时提供错误码、服务商、模型名、是否能刷新模型列表、是否所有角色都失败。不要提供 API Key。