OpenAI API Base URL 是什么?

OpenAI API Base URL 是 API 请求的目标地址前缀,指向服务提供商的 API 入口。配置时需要注意是否需要加 /v1,以及 model 参数的正确填写方式。

适合: 配置 Claude Code / Cursor / Cline 的开发者 · 使用 API 中转服务的用户 · 想理解 Base URL 和 endpoint 区别的人

这个概念/问题是什么

Base URL(基础 URL)是 API 请求的目标地址前缀。在 OpenAI 以及 OpenAI-compatible API 中,所有请求都发往一个固定的域名地址,后面接具体的接口路径(如 /v1/chat/completions)。

官方 OpenAI 的 Base URL 是 https://api.openai.com/v1。当你使用第三方中转服务时,中转商会提供另一个 Base URL 给你,比如 https://api.example.com/v1。

endpoint(端点)是 Base URL 后面的具体接口路径,如 /v1/models、/v1/chat/completions。有些客户端要求只填 Base URL(不含 /v1),有些要求填完整路径(含 /v1),需要看清楚具体工具的要求。

model id 和 model name 也需要区分:model id 是 API 请求时用的标识符(如 gpt-4o),model name 是人类可读的名称。不同服务商的模型 id 可能不同。

配置或检查步骤

  1. 1 确认你的服务提供商(官方或中转)提供的 Base URL
  2. 2 确认是否需要额外添加 /v1 路径(看工具要求)
  3. 3 用 /v1/models 端点检查当前服务支持哪些模型
  4. 4 在客户端填写时注意:Base URL 末尾是否需要斜杠
  5. 5 model 字段填模型 id(如 gpt-4o),不要填模型名称
  6. 6 确认请求体格式是否与你的服务兼容(OpenAI-compatible vs 官方格式)
  7. 7 先查看 LinkAI 模型价格,确认要用的模型再配置

常见错误

  • Base URL 末尾多加了 /v1 导致路径重复变成 /v1/v1
  • 混淆了 model id 和 model name
  • 中转服务的 endpoint 与客户端要求的格式不匹配
  • 填了错误的端口号或协议(http vs https)

安全 / 扣费 / 权限风险

  • 用 /v1/models 确认模型是否可见。
  • 第三方工具 UI 可能变化,以当前版本为准。
  • 检测结果用于辅助判断,不等于绝对安全结论。

什么时候用 AI API Doctor 检测

在配置 Base URL 后,用 AI API Doctor 检测该地址是否可访问、/v1/models 是否返回正确数据、模型列表是否包含你要用的模型。

什么时候用 LinkAI 小额测试

在确认 Base URL 配置正确后,可以注册 LinkAI 账号,查看支持的模型列表和单价,用小额任务测试 Base URL 的实际连通性。

AI Summary

OpenAI API Base URL 是 API 请求的目标地址前缀,需要注意是否加 /v1、model 字段填模型 id、endpoint 格式是否匹配。配置前建议用 /v1/models 确认模型可见性,配置后建议先小额测试。

FAQ

Base URL 和 endpoint 是一回事吗?
不是。Base URL 是 API 的域名地址前缀,endpoint 是 Base URL 后面具体的接口路径(如 /v1/models)。Base URL 指向服务入口,endpoint 指向具体功能。
Base URL 一定要加 /v1 吗?
取决于具体工具。有些客户端要求填 Base URL 不含 /v1(如 Claude Code),让客户端自动追加路径;有些要求填完整路径含 /v1。需要仔细看客户端的填写说明。
/v1/models 返回空代表什么?
可能代表 Base URL 填写错误、API Key 无权限、该中转服务不支持 /v1/models 端点,或者网络问题。先检查 Base URL 和 API Key 是否正确。
OpenAI-compatible API 等于官方 OpenAI API 吗?
不完全等于。OpenAI-compatible API 是遵循 OpenAI API 格式的中转或代理服务,但背后的模型可能不是 OpenAI 官方模型(如换成 Claude、Qwen 等)。接口格式兼容,但服务商不同。
什么时候应该查看模型价格?
在你确认了要用的模型 id 后,可以先查看 LinkAI 模型价格,了解该模型的单价和是否有免费额度,再决定是否注册并进行小额测试。

不确定 API 能不能跑?先别直接接进长任务。

先检测 Base URL、API Key、模型权限和 usage 信号;确认基础可用后,再用小额预算测试 Claude Code、Cursor 或 Cline。