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。
要迁移整个应用?请按迁移检查清单逐项检查。