酒馆 API 配置
Tavern Studio 负责管理角色、世界书、预设和聊天上下文，模型服务负责生成回复。API 配置就是把这两部分连接起来。
本页面向普通酒馆用户，不是开发者 SDK 文档。你需要理解的重点是：接口地址、API Key、模型名和测试对话。
配置 API 前先确认什么
准备好以下信息：
- 你要使用的服务商或网关；
- API Key；
- 接口地址或 Base URL；
- 模型名；
- 是否需要代理或特殊网络环境。
API Key 是私密凭证。不要把它发到截图、日志、角色卡或公开帖子里。
选择 API 服务商
常见类型包括：
- 直接的云模型服务商；
- OpenAI 兼容网关；
- 本地模型服务；
- 自定义反代或团队网关。
如果你只是想先跑通聊天，优先选择配置最简单、文档最清楚的服务。
填写 API Key
复制 API Key 时注意：
- 不要多复制空格；
- 不要漏掉前后字符；
- 确认 Key 没有过期；
- 确认账号还有额度；
- 不要把多个服务商的 Key 混用。
如果你怀疑 Key 泄露，应该到服务商后台撤销并重新创建。
填写接口地址和模型名
接口地址最常见的问题是 /v1 路径。部分服务商需要你手动填写 /v1，部分服务商已经包含。重复或漏写都会导致请求失败。
模型名也要和服务商要求完全一致。不要凭感觉改大小写或缩写。
OpenAI 兼容接口说明
OpenAI 兼容通常表示服务商使用类似的请求格式，但不代表每个字段、模型和参数都完全一样。
配置时只需要先关注：
- Base URL；
- API Key；
- Model；
- Provider 或 route 类型。
开发者 API 细节不是本页重点。
常见配置错误
常见错误包括：
- Base URL 写错；
/v1重复或缺失；- API Key 无效；
- 模型名不存在；
- 账号没额度；
- 网络或代理无法访问；
- 选择了不支持当前预设参数的模型。
如何测试是否配置成功
先用一个很短的普通问题测试，不要一开始就用长角色卡、复杂世界书和大量预设。
如果短测试能成功，再逐步启用角色卡、世界书和预设。这样可以判断问题来自 API 配置，还是来自上下文太长或预设不兼容。
报错时下一步怎么排查
如果出现 400、403、Forbidden、Internal Server Error 或“API returned an error”，继续看 酒馆报错排查。