API Base URL 是什么？和 API Key 有什么区别？

一句话回答

API Base URL 是 API 服务的入口地址，决定请求要发到哪里；API Key 是身份凭证，决定服务端是否允许你调用。简单说：Base URL 像“门牌号”，API Key 像“钥匙”。

在 OpenAI 或 OpenAI-compatible 配置里，Base URL 常见形式是 https://api.openai.com/v1 或 https://api.tokencheap.space/v1，API Key 则是一串密钥。两者必须来自同一个服务商，否则很容易出现 401、invalid_api_key、model_not_found 或连接失败。

为什么很多人会混淆 Base URL 和 API Key

因为 Cursor、Dify、n8n、LangChain、OpenAI SDK 的配置页里经常同时出现这些字段：

API Key
Base URL
API Endpoint
Model Name
Provider

如果只照着教程复制，却不知道每个字段的作用，后续一换服务商就容易填错。比如 Key 是 TokenCheap 生成的，Base URL 却填了 OpenAI 官方地址，服务端就无法识别这个 Key。

Base URL、Endpoint、API Key、Model 的区别

字段	作用	示例
Base URL	API 根入口	`https://api.tokencheap.space/v1`
Endpoint	具体功能路径	`/models`、`/chat/completions`
API Key	身份认证	`sk-...` 或服务商生成的 Key
Model Name	要调用的模型	`gpt-4o-mini`、服务商支持的模型 ID

一次完整请求可以理解为：

Base URL + Endpoint + API Key + Model Name

例如请求模型列表：

curl "https://api.tokencheap.space/v1/models" \
  -H "Authorization: Bearer YOUR_API_KEY"

Base URL 应该填到哪一层

大多数 OpenAI-compatible 工具建议填到 /v1：

https://api.tokencheap.space/v1

不要填成网页地址：

https://www.tokencheap.space

也不要把具体接口填进去：

https://api.tokencheap.space/v1/chat/completions

因为工具通常会自动在 Base URL 后面拼接 endpoint。如果你把 endpoint 也写进去，路径可能重复。

在 Cursor、Dify、n8n 里怎么理解

Cursor

Cursor 的 Base URL 决定编辑器向哪个模型服务发请求。API Key 必须属于这个服务。配置不匹配时，常见报错是 Cursor 提示 invalid OpenAI API key。

Dify

Dify 里的 openai_api_base 本质就是 Base URL。常见填写方式可参考 Dify 里的 openai_api_base 应该怎么填。

n8n

n8n 的 Base URL 决定工作流节点请求哪个 API。自建 n8n 还要确认服务器能访问该地址。可参考 n8n OpenAI API Base URL 怎么填。

常见错误

1. Key 和 Base URL 来自不同服务商

这是最常见错误。OpenAI 官方 Key 要配官方 Base URL；TokenCheap Key 要配 TokenCheap Base URL。

2. 把网页地址当 API 地址

网页地址通常用于登录后台，不是 API 请求入口。API 地址一般以 api. 开头，并带版本路径。

3. 漏掉 /v1

很多兼容接口需要 /v1。漏掉后可能 404 或模型列表为空。

4. 模型名不属于当前 Base URL

Base URL 和 Key 正确，但模型名不在服务列表里，也会失败。先用 /models 验证可用模型。

快速检查清单

Base URL 是 API 地址，不是网页地址。
API Key 来自同一个服务商。
Base URL 是否需要 /v1。
没有把 /chat/completions 写进 Base URL。
模型名在 /models 返回列表里。
自部署工具的服务器能访问该 API 域名。

FAQ