酒馆报错排查

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

如果你还没完成 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。