酒馆 API 配置

Tavern Studio 负责管理角色、世界書、預設和聊天上下文，模型服务负责生成回複。API 配置就是把這两部分連接起来。

本頁面向普通酒馆用户，不是開發者 SDK 文档。你需要理解的重點是：介面地址、API Key、模型名和测試對話。

配置 API 前先确认什么

准備好以下信息：

1. 你要使用的服务商或网關；
2. API Key；
3. 介面地址或 Base URL；
4. 模型名；
5. 是否需要代理或特殊网络环境。

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”，继续看 酒馆报错排查。