OpenAI-compatible API 设置：在 Tavern Studio 连接自定义端点

OpenAI-compatible API 通常需要三项信息：Base URL、API Key（如果需要）和模型 ID。Tavern Studio 把这些提供商配置和角色卡、预设分开，这样你可以换模型路线，而不用重写角色。

很多云服务、本地服务和第三方网关提供 OpenAI 风格接口，但并非所有细节都完全一样。具体仍要看服务文档。

适合谁

• 想连接 OpenAI-compatible 云服务的用户。
• 使用本地模型服务的开发者。
• 有自定义网关、反向代理或私有端点的人。
• 从 SillyTavern 迁移 API 设置的用户。

核心内容

OpenAI-compatible endpoint 通常使用 Bearer Token，并通过 chat completions 接收 model 和 messages。本地服务可能不需要 Key，自定义网关可能有额外 Header、账户 ID 或路径。

不要把提供商信息写进角色卡。角色、预设、模型连接应该分开管理。

Tavern Studio 如何处理

Tavern Studio 支持 OpenAI-compatible API 配置。完整迁移时，常见服务可以自动映射；自定义端点、本地服务、反向代理、Azure OpenAI、Cloudflare Workers AI、缺失 Base URL 或默认模型等需要手动检查。

Prompt 组装可以为 OpenAI 风格路线准备结构化 messages。

操作步骤

1. 打开 API 或模型连接设置。
2. 选择 OpenAI-compatible 路线。
3. 填写 Base URL。
4. 如需要，填写 API Key。
5. 填写或选择模型 ID。
6. 保存连接。
7. 发短消息测试。
8. 把路线绑定到需要的聊天或预设。

常见问题

什么是 OpenAI-compatible API？

指遵循 OpenAI 风格请求和响应的接口，常见为 /chat/completions。

可以连接本地服务吗？

可以，只要服务暴露兼容接口，Base URL 和模型 ID 设置正确。

Tavern Studio 会绕过 API Key 吗？

不会。请使用提供商或你自己的本地服务提供的合法凭据。

为什么端点连接失败？

常见原因包括 Base URL 错误、漏写 /v1、模型 ID 错误、Key 无效、代理问题或提供商差异。

同一角色能换不同端点吗？

可以。通过模型路线和预设切换即可测试。

下一步

• 了解云端 API 聊天客户端。
• 使用Windows 本地 LLM作为本地路线。
• 用预设和提示词管理控制生成。