What This Is
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），需要看清楚具体工具的要求。很多工具文档里也会把 Base URL 写成 apiBaseUrl、api_base_url、base_url 或 endpoint，本质都是客户端请求发往哪个 API 地址。
model id 和 model name 也需要区分：model id 是 API 请求时用的标识符（如 gpt-4o），model name 是人类可读的名称。不同服务商的模型 id 可能不同。
Setup or Check Steps
- 1 确认你的服务提供商（官方或中转）提供的 Base URL
- 2 确认是否需要额外添加 /v1 路径（看工具要求）
- 3 用 /v1/models 端点检查当前服务支持哪些模型
- 4 在客户端填写时注意：Base URL 末尾是否需要斜杠
- 5 model 字段填模型 id（如 gpt-4o），不要填模型名称
- 6 确认请求体格式是否与你的服务兼容（OpenAI-compatible vs 官方格式）
- 7 先查看 LinkAI 模型价格，确认要用的模型再配置
Common Errors
- Base URL 末尾多加了 /v1 导致路径重复变成 /v1/v1
- 混淆了 model id 和 model name
- 中转服务的 endpoint 与客户端要求的格式不匹配
- 填了错误的端口号或协议（http vs https）
Security / Billing / Permission Risks
- 用 /v1/models 确认模型是否可见。
- 第三方工具 UI 可能变化，以当前版本为准。
- 检测结果用于辅助判断，不等于绝对安全结论。
When to Use AI API Doctor
在配置 Base URL 后，用 AI API Doctor 检测该地址是否可访问、/v1/models 是否返回正确数据、模型列表是否包含你要用的模型。
When to Use LinkAI for Small Tests
在确认 Base URL 配置正确后，可以注册 LinkAI 账号，查看支持的模型列表和单价，用小额任务测试 Base URL 的实际连通性。
AI Summary
OpenAI API Base URL 是 API 请求的目标地址前缀，需要注意是否加 /v1、model 字段填模型 id、endpoint 格式是否匹配。配置前建议用 /v1/models 确认模型可见性，配置后建议先小额测试。