OpenAI API Base URL 是什么：避免 /v1/v1、404 和协议混用

Base URL 是客户端请求接口时使用的地址前缀，不等于产品网页首页，也不一定等于一个完整 API 请求地址。不同客户端对这个字段的约定不同：有的要求填到版本前缀，有的会自行拼接端点。最常见的错误不是“地址完全不存在”，而是在已带版本前缀的地址后再次拼接 /v1，或把协议端点手工写进 Base URL。

Base URL、端点和网页地址的区别

1. 网页地址用于打开产品页面，通常不应该直接填入 API 客户端。
2. Base URL是客户端组织请求的共同前缀。
3. 端点由客户端的协议实现生成，例如不同请求形态会走不同路径。

因此，填写前要先看字段标签和客户端说明，而不是从其他客户端复制整段 URL。对于 OpenAI 开发者接口的概念，优先核对 OpenAI API 官方文档；对于 Codex，则以 Codex 配置参考为准。

为什么会出现 /v1/v1 或 404

当服务已经在 Base URL 中提供版本前缀，而客户端又自动附加版本路径时，最终请求可能出现重复路径。另一种情况是用户把 /responses 或 /chat/completions 写入 Base URL，导致客户端再次追加端点。出现 404 时，不要马上更换 Key；先把最终请求拆成地址、版本前缀、协议端点三部分，再逐项确认谁负责拼接。

安全的排错顺序

1. 记录客户端名称和版本。
2. 确认当前字段是否叫 Base URL、Endpoint、Host 或 Provider URL。
3. 只保留服务文档要求的地址前缀，不主动补全其他路径。
4. 在本地受控配置中提供 Key，用无敏感内容的短请求检查状态码。
5. 若仍失败，再按 401、403、429、502/503 的排错路径判断是鉴权、限流还是服务错误。

Shana 配置时的具体边界

Shana 的 Base URL 为 https://shana.baby/v1。具体客户端是否自动拼接后续路径，应按它的当前协议说明核对；不要把这个示例当成所有服务的通用格式。理解兼容范围可阅读 OpenAI 兼容 API 是什么，使用 Codex 时可继续看 Codex API 配置自检。准备好配置后，再通过 Shana Codex 接入说明确认实时服务信息。