---
title: "大模型 API 的 base URL 是什么？附示例 | BroadRouter"
description: "base URL 是 SDK 加在每个 API 路径前面的根地址。它在 OpenAI 兼容客户端中如何工作，以及导致 404 错误的常见配置错误。"
url: https://broadrouter.com/zh/glossary/base-url/
lang: zh-Hans
updated: 2026-11-15
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

本页由英文原文借助 AI 翻译。 [阅读英文原文](https://broadrouter.com/glossary/base-url/) (2026-11-15 更新).

# Base URL（base\_url）

更新于 2026-11-15

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
# Python SDK
client = OpenAI(base_url="https://inference.broadnet.ai/v1", api_key=os.environ["BROADNET_API_KEY"])
```

```js
// 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](https://broadrouter.com/zh/glossary/openai-compatible-api/) 可以直接替换。它还决定了你的提示词发往哪里、由谁向你收费。配错了值，可能会把流量连同你的 [API 密钥](https://broadrouter.com/zh/glossary/api-key/)一起发给错误的服务商。把它和密钥一起放在配置里，不要在多个地方硬编码。

路由器也是同样的思路：把 base URL 指向[路由器](https://broadrouter.com/zh/glossary/llm-router/)，而不是某家模型服务商。

## 在 BroadNet Inference 上

所有模型的 base URL 都是 `https://inference.broadnet.ai/v1`：对话、视觉和语音转文字都一样。对话请求发往 `/chat/completions`，转写请求发往 `/audio/transcriptions`。[curl 快速入门](https://broadrouter.com/zh/guides/curl-quickstart/)演示了第一个请求，[LangChain 指南](https://broadrouter.com/zh/guides/langchain-openai-base-url/)展示了这个设置在框架中的位置。

## 常见错误

-   **漏掉 `/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`。

要迁移整个应用？请按[迁移检查清单](https://broadrouter.com/zh/blog/openai-compatible-api-migration-checklist/)逐项检查。

## 常见问题

### 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

## 另请参阅

-   [OpenAI 兼容 API（OpenAI-compatible API）](https://broadrouter.com/zh/glossary/openai-compatible-api/) (术语)
-   [API 密钥（API key）](https://broadrouter.com/zh/glossary/api-key/) (术语)
-   [大模型路由（LLM router）](https://broadrouter.com/zh/glossary/llm-router/) (术语)
-   [用 OpenAI Python SDK 调用 BroadNet Inference](https://broadrouter.com/zh/guides/openai-python-sdk/) (指南)
-   [用 OpenAI Node.js SDK 调用 BroadNet Inference](https://broadrouter.com/zh/guides/openai-node-sdk/) (指南)
-   [在 LangChain 中调用 BroadNet Inference](https://broadrouter.com/zh/guides/langchain-openai-base-url/) (指南)
-   [用 curl 首次调用 BroadNet Inference API](https://broadrouter.com/zh/guides/curl-quickstart/) (指南)
-   [迁移到 OpenAI 兼容 API：切换服务商检查清单](https://broadrouter.com/zh/blog/openai-compatible-api-migration-checklist/) (文章)

用你的真实业务负载试一试。 新账户可获得 US$5 初始额度，用于 Gemma和转写。DeepSeek、GLM和Qwen3.8 需要先充值。

[开始使用](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-glossary-base-url&utm_content=page-cta) ·

**来源**

-   [OpenAI Python SDK README（base\_url 与 OPENAI\_BASE\_URL）](https://github.com/openai/openai-python)
-   [OpenAI Node SDK（baseURL，默认读取 OPENAI\_BASE\_URL）](https://github.com/openai/openai-node)
-   [OpenRouter 快速入门（第三方 base URL 示例）](https://openrouter.ai/docs/quickstart)
-   [BroadNet Inference API 参考文档 （英文）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-glossary-base-url&utm_content=sources)
