这个概念/问题是什么
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 确认你的服务提供商(官方或中转)提供的 Base URL
- 2 确认是否需要额外添加 /v1 路径(看工具要求)
- 3 用 /v1/models 端点检查当前服务支持哪些模型
- 4 在客户端填写时注意:Base URL 末尾是否需要斜杠
- 5 model 字段填模型 id(如 gpt-4o),不要填模型名称
- 6 确认请求体格式是否与你的服务兼容(OpenAI-compatible vs 官方格式)
- 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 确认模型可见性,配置后建议先小额测试。