Base URL 是什么？API Base URL 怎么填（OpenAI、Claude、中转站配置对照表）
Base URL 是什么、怎么填？本文讲清 API Base URL 的含义和拼接规则，说明 Base URL 要不要加 /v1，给出 OpenAI SDK、Claude Code、Anthropic SDK、Cursor 和各类 AI 客户端的 Base URL 配置对照表，附 OpenAI Compatible 渠道配置步骤和 404、401 等常见报错排查。
SupaStore 开发者体验组 ·
**Base URL 是什么？**它是 API 请求的"根地址"，客户端会在它后面拼上具体的接口路径，比如 /chat/completions、/messages、/models，再把请求发出去。接入中转站时，Base URL 填错一个 /v1 或多一个斜杠，就会直接报 404。
这篇文章讲清 API Base URL 的拼接规则、要不要加 /v1，再给出 OpenAI SDK、Claude Code、Cursor 和常见 AI 客户端的 Base URL 配置对照表，最后整理常见报错。还不了解 API中转站是什么的话，可以先看《API中转站是什么？2026 AI中转站选型避坑指南》。
Base URL 是什么意思
一个完整的 API 请求地址由两部分组成：
https://api.supastore.cc/v1 + /chat/completions
└──────── Base URL ────────┘ └── 接口路径 ──┘
- Base URL：服务商的接口根地址，由你在客户端里填写；
- 接口路径：由 SDK 或客户端自动拼接，不同功能对应不同路径。
换一个服务商，只需要改 Base URL 和 API Key，代码和接口路径都不用动。这也是 API中转站能"无缝替换"官方接口的原因。
SupaStore 的接口地址
| 用途 | 完整请求地址 |
|---|---|
| OpenAI 兼容对话 | POST https://api.supastore.cc/v1/chat/completions |
| Claude 原生 Messages 协议 | POST https://api.supastore.cc/v1/messages |
| 获取模型列表 | GET https://api.supastore.cc/v1/models |
对应的 Base URL 统一是 https://api.supastore.cc/v1。
API Base URL 要不要加 /v1
这是配置时最常见的问题。规则其实很简单：看客户端会不会自动帮你补 /v1。
字段叫 "Base URL"：填到 /v1
OpenAI 官方 SDK、Claude Code、大多数 OpenAI Compatible 渠道配置界面，都是直接在你填的 Base URL 后面拼接口路径，不会再补 /v1。所以必须填完整的 https://api.supastore.cc/v1。
字段叫 "API 域名 / API Host"：只填域名
部分聊天客户端的输入框叫"API 域名"或"API Host"，它们会自己在后面补上 /v1。这类客户端只填 https://api.supastore.cc，否则会变成 /v1/v1/...。
三个通用规则
- 不要把接口路径写进 Base URL：填
.../v1，不要填.../v1/chat/completions； - 末尾不要多加
/：https://api.supastore.cc/v1/在部分客户端会拼出双斜杠； - 拿不准时先用 cURL 测试
/v1/models，能返回模型列表就说明地址和 Key 都没问题。
Base URL 配置对照表
| 工具 / SDK | 配置项 | 填写内容 |
|---|---|---|
| OpenAI Python / Node.js SDK | base_url / baseURL 或环境变量 OPENAI_BASE_URL |
https://api.supastore.cc/v1 |
| Anthropic Python SDK | base_url |
https://api.supastore.cc/v1 |
| Claude Code | ANTHROPIC_BASE_URL |
https://api.supastore.cc/v1 |
| Cursor | Override OpenAI Base URL | https://api.supastore.cc/v1 |
| OpenAI Compatible 渠道（各类 AI 应用） | Base URL | https://api.supastore.cc/v1 |
| Cherry Studio | API 域名（OpenAI 类型） | https://api.supastore.cc |
| NextChat / Chatbox | 接口地址 | https://api.supastore.cc |
各工具的完整配置步骤：
- Claude Code：《Claude API 中转怎么用？国内 Claude Code 中转站配置教程》
- Cursor：《Cursor 中转 API 怎么配置？Cursor 自定义 API Key 与 Base URL 教程》
- Python 代码：《Claude API 调用教程：Python 接入 Claude API 完整示例》
- 一个 Key 接入多家模型：《如何通过单 API Key 统一接入 40+ 主流大模型实践教程》
在 AI 应用里配置 OpenAI Compatible 渠道
很多 AI 应用、Agent 平台和插件都提供"OpenAI Compatible"渠道，配置界面大同小异：
- 渠道名称：随便起一个便于识别的名字，例如
supastore； - 协议：选择 OpenAI Compatible；
- Base URL：填写
https://api.supastore.cc/v1； - API Key：填入在 SupaStore 控制台【令牌管理】中创建的
sk-开头的密钥； - 获取模型：点击后应用会请求
/v1/models，自动拉取这个 Key 可用的模型； - 手动填写模型：自动获取失败时，按模型 ID 逗号分隔填写，例如
claude-sonnet-5-5,gpt-4o，模型 ID 以模型广场为准； - 测试连接：保存前先测试，确认能正常返回。
用 OpenAI SDK 验证 Base URL
from openai import OpenAI
client = OpenAI(
api_key="sk-your-supastore-api-key",
base_url="https://api.supastore.cc/v1",
)
print([m.id for m in client.models.list().data][:5])
resp = client.chat.completions.create(
model="claude-sonnet-5-5",
messages=[{"role": "user", "content": "用一句话解释什么是 Base URL"}],
)
print(resp.choices[0].message.content)
用 cURL 验证 Base URL
curl https://api.supastore.cc/v1/models \
-H "Authorization: Bearer sk-your-supastore-api-key"
curl https://api.supastore.cc/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-your-supastore-api-key" \
-d '{"model": "claude-sonnet-5-5", "messages": [{"role": "user", "content": "你好"}]}'
Base URL 常见报错排查
| 报错 | 常见原因 | 处理方法 |
|---|---|---|
404 Not Found |
漏写 /v1、多写了一层 /v1，或把接口路径写进了 Base URL |
按客户端类型填写，SDK 类填 https://api.supastore.cc/v1 |
401 Unauthorized |
Key 错误、复制时多了空格，或把官方 Key 用在了中转站 | 重新复制中转站控制台里的 Key |
| 获取模型为空 | Key 没有勾选可用模型，或客户端不支持 /models |
检查 Key 的模型权限，改为手动填写模型 |
400 模型不存在 |
模型 ID 拼写错误 | 在模型广场复制准确的模型 ID |
| 连接超时 | Base URL 填成了官方地址，国内网络无法直连 | 确认填的是中转站地址 |
更多排查步骤见常见问题排查。不同中转站价格怎么比较，见《API中转站倍率是什么意思？》。
常见问题 (FAQ)
Q: Base URL 是什么意思？
答： Base URL 是 API 请求的根地址，客户端会在它后面拼接 /chat/completions、/messages、/models 等接口路径；更换服务商时，通常只需要修改 Base URL 和 API Key。
Q: Base URL 要不要加 /v1？
答： 取决于客户端：OpenAI SDK、Claude Code 和 OpenAI Compatible 渠道这类直接拼接路径的，需要填到 /v1；字段叫 API 域名、会自动补 /v1 的客户端，只填域名即可。
Q: SupaStore 的 Base URL 是多少？
答： SupaStore 的 Base URL 是 https://api.supastore.cc/v1，OpenAI 兼容接口和 Claude 原生 Messages 接口都使用这个地址。
Q: OPENAI_BASE_URL 环境变量怎么设置？
答： 在终端执行 export OPENAI_BASE_URL="https://api.supastore.cc/v1"，并同时设置 OPENAI_API_KEY，大部分 OpenAI SDK 和开源工具会自动读取这两个变量。
Q: Base URL 填对了还是 404 怎么办？
答： 检查末尾是否多了斜杠、是否把 /chat/completions 写进了 Base URL，以及客户端是否会自动补 /v1，然后用 cURL 请求 /v1/models 确认地址可用。