BroadRouter
开始使用

Base URL(base_url)

更新于

base URL 是 API 固定的根地址,例如 https://api.example.com/v1,客户端会把它加在每个端点路径(例如 /chat/completions)前面。在 OpenAI 兼容 SDK 中,修改 base URL,再配合 API 密钥和模型 ID,就能让同一份代码改用另一家服务商。

又称: base_url、接口地址、API 地址、请求地址、基础 URL、API base URL、api_base、baseURL、OPENAI_BASE_URL、endpoint URL、base URL

SDK 发出的每个请求,都是 base URL 加上一个路径。只要 base URL 配对了,客户端的其余部分无需改动就能工作。

工作原理

客户端把两部分拼接起来:

部分 示例
Base URL https://inference.broadnet.ai/v1
端点路径 /chat/completions
完整请求 URL https://inference.broadnet.ai/v1/chat/completions

在代码里,参数名取决于所用的库:

# Python SDK
client = OpenAI(base_url="https://inference.broadnet.ai/v1", api_key=os.environ["BROADNET_API_KEY"])
// Node SDK
const client = new OpenAI({ baseURL: "https://inference.broadnet.ai/v1", apiKey: process.env.BROADNET_API_KEY });

两个官方 SDK 都会回退到 OPENAI_BASE_URL 环境变量;如果什么都没设置,就使用 OpenAI 自己的地址。其他工具使用 api_base 或 OPENAI_API_BASE 之类的名字。

为什么重要

正是 base URL 让 OpenAI 兼容 API 可以直接替换。它还决定了你的提示词发往哪里、由谁向你收费。配错了值,可能会把流量连同你的 API 密钥一起发给错误的服务商。把它和密钥一起放在配置里,不要在多个地方硬编码。

路由器也是同样的思路:把 base URL 指向路由器,而不是某家模型服务商。

在 BroadNet Inference 上

所有模型的 base URL 都是 https://inference.broadnet.ai/v1:对话、视觉和语音转文字都一样。对话请求发往 /chat/completions,转写请求发往 /audio/transcriptions。curl 快速入门演示了第一个请求,LangChain 指南展示了这个设置在框架中的位置。

常见错误

  • 漏掉 /v1。 使用不带 /v1 的 https://inference.broadnet.ai,SDK 会报 404 错误。
  • 路径重复。 把完整端点(例如 .../v1/chat/completions)当作 base URL 粘贴进去,SDK 就会去调用 .../chat/completions/chat/completions。
  • 残留的环境变量。 shell 里遗留的旧 OPENAI_BASE_URL 会覆盖你预期的值。请求发错地方时,把它打印出来看看。
  • 使用明文 HTTP。 始终使用 https://。Bearer 密钥必须通过 TLS 传输。
  • 改了 URL 却没改模型。 每家服务商都有自己的模型 ID,例如 broadnet/deepseek-v4.1-flash。

要迁移整个应用?请按迁移检查清单逐项检查。

常见问题

base URL 要以 /v1 结尾吗?

对于 OpenAI 兼容 SDK,如果服务商的路径以 /v1 开头,就要。SDK 会在后面接上 /chat/completions 这样的路径。准确的值请查看服务商的文档。

能不改代码就设置 base URL 吗?

能。OpenAI 官方的 Python 和 Node SDK 在你没有传入 base URL 时,会读取 OPENAI_BASE_URL 环境变量。有些工具使用自己的变量名,例如 Aider 用的是 OPENAI_API_BASE。

BroadNet Inference 的 base URL 是什么?

https://inference.broadnet.ai/v1

以 Markdown 格式阅读问 ChatGPT问 Claude问 Perplexity