---
title: "OpenAI 兼容 API base_url 地址汇总（14 家） | BroadRouter"
description: "14 家 OpenAI 兼容大模型 API 的 base_url，均摘自各服务商官方文档，附上它们列出的端点，以及会让“直接替换”失败的差异。"
url: https://broadrouter.com/zh/blog/openai-compatible-api-base-urls/
lang: zh-Hans
updated: 2026-11-15
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

本页由英文原文借助 AI 翻译。[阅读英文原文](https://broadrouter.com/blog/openai-compatible-api-base-urls/)（2026-11-15 更新）。

# OpenAI 兼容 API 的 base\_url 汇总：14 家服务商逐一核对

BroadNet Inference 团队 · 阅读约 6 分钟 · 发布于 2026-11-15

OpenAI 兼容 API 让你继续用 OpenAI SDK，只需改两处：base\_url 和 API key。base URL 因服务商而异，例如 Groq 是 https://api.groq.com/openai/v1，OpenRouter 是 https://openrouter.ai/api/v1，BroadNet Inference 是 https://inference.broadnet.ai/v1。路径、模型 ID 和支持的参数仍有差别，切换前先发一个请求测试。

## 要点

-   大多数服务商的 base URL 以 /v1 结尾，但并非全部：DeepSeek 不带版本路径，Z.ai 用 /api/paas/v4/，Gemini 用 /v1beta/openai/。
-   base\_url 应设为 SDK 在其后拼接 /chat/completions 的根路径。不要把完整的 /chat/completions 路径填进 base\_url。
-   “兼容”很少意味着所有端点都支持。逐家确认文档里列出了对话补全、音频转写、embeddings 和 Responses API 中的哪些。
-   模型 ID 随服务商而变：DeepInfra 上是 deepseek-ai/DeepSeek-V4-Flash-0731，Fireworks 上是 accounts/fireworks/models/…，BroadNet 上是 broadnet/…。
-   Anthropic 说它的 OpenAI 兼容层主要用于测试；xAI 称 Responses API 是首选的接入方式。服务商这样说的地方，就用原生 API。

**本页内容**

1.  各家 OpenAI 兼容服务商的 base URL 是什么？
2.  在代码里怎么设置 base URL？
3.  怎么用 curl 测试新的 base URL？
4.  修改 base\_url 时常见的错误有哪些？
5.  BroadNet Inference 支持哪些端点？
6.  要不要把多家服务商统一到一个 base URL 后面？
7.  BroadNet Inference 适合什么场景

OpenAI 兼容 API 接受与 OpenAI API 相同的请求格式，所以只要改掉 `base_url` 和 API key，官方 OpenAI SDK 就能直接用。麻烦在于，每家服务商的端点位置都略有不同。下表列出 14 家，每一家都是我们在 2026 年 11 月 15 日从服务商自己的文档中读取的。

## 各家 OpenAI 兼容服务商的 base URL 是什么？

| 服务商 | Base URL | OpenAI 兼容文档列出的内容 | 文档中写明的差异 |
| --- | --- | --- | --- |
| OpenAI | `https://api.openai.com/v1` | 全部；它就是参照标准 | 什么都不设置时的 SDK 默认值 |
| Anthropic | `https://api.anthropic.com/v1/` | 对话补全 | “Primarily intended to test and compare model capabilities”（译文：主要用于测试和比较模型能力）；忽略 `strict`；音频和文件输入返回 400 |
| Google Gemini | `https://generativelanguage.googleapis.com/v1beta/openai/` | 对话补全、embeddings、图像生成、models、batch | OpenAI 库支持 “still in beta”（译文：仍处于 beta 阶段）；未列出 Responses API |
| DeepSeek | `https://api.deepseek.com` | 对话补全 | 没有版本路径；另有 Anthropic 格式的地址 `/anthropic` |
| Groq | `https://api.groq.com/openai/v1` | 对话补全、Responses API；另有音频转写说明 | `logprobs`、`logit_bias`、`top_logprobs`、`messages[].name` 返回 400；`n` 必须为 1；不支持 `srt` 或 `vtt` 格式的转写 |
| Together AI | `https://api.together.ai/v1` | 对话、补全、图像、语音合成、转写、models、Responses | 仅限美国的推理地址为 `https://us-api.together.ai/v1`；embeddings 仅在专用端点上提供 |
| Fireworks AI | `https://api.fireworks.ai/inference/v1` | 对话补全 | 模型 ID 形如 `accounts/fireworks/models/…`；默认会把 `max_tokens` 调低以适应上下文，而不是报错，除非另行指定 |
| DeepInfra | `https://api.deepinfra.com/v1/openai` | 对话补全；Responses 客户端使用同一个 base | embeddings、图像和语音在另一个页面中说明 |
| Mistral AI | `https://api.mistral.ai/v1` | `POST /v1/chat/completions` | 其 API 参考并未自称 OpenAI 兼容；依赖它之前先测试 |
| OpenRouter | `https://openrouter.ai/api/v1` | 对话补全 | 可选的 `HTTP-Referer` 和 `X-OpenRouter-Title` 请求头，用于其排行榜 |
| xAI | `https://api.x.ai/v1` | Responses API | 其指南写道 “The Responses API is the preferred way of interacting with our models”（译文：Responses API 是与我们的模型交互的首选方式） |
| Z.ai（GLM） | `https://api.z.ai/api/paas/v4/` | 对话补全 | 路径是 `v4`，不是 `v1` |
| 阿里云百炼（Model Studio） | `https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1`（新加坡） | 对话补全 | 主机名中包含 Workspace ID；密钥只能在创建它的地域使用，否则返回 401 |
| BroadNet Inference | `https://inference.broadnet.ai/v1` | 对话补全、音频转写 | 模型 ID 以 `broadnet/` 开头；详见下文 |

阿里云还列出了位于 `us-east-1` 的美国（弗吉尼亚）端点。同一页面上北京那一行显示的却是新加坡的主机名，而页面其他文字提到的是 `cn-beijing`，所以中国内地端点请在控制台中确认。这张表只是一个时间点的快照。端点会变：我们核对时，Anthropic 和 Google 的文档都重定向到了新地址。

各服务商的价格，请看 [各服务商大模型 API 价格](https://broadrouter.com/llm-api-pricing/providers/) 页面。

## 在代码里怎么设置 base URL？

在 Python 中，把 `base_url` 传给客户端：

```python
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
)
r = client.chat.completions.create(
    model="broadnet/gemma-4-26b-a4b",
    messages=[{"role": "user", "content": "Say hello in one line."}],
)
print(r.choices[0].message.content)
```

在 Node 中，选项名是 `baseURL`：

```js
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://inference.broadnet.ai/v1",
  apiKey: process.env.BROADNET_API_KEY,
});
```

也可以一次设置好，让所有使用官方 SDK 的工具都生效。Node SDK 的源码中，`baseURL` 默认取 `process.env['OPENAI_BASE_URL']`，没有时再用 `https://api.openai.com/v1`；Python 的 README 也说明了同一个变量：

```bash
export OPENAI_BASE_URL="https://inference.broadnet.ai/v1"
export OPENAI_API_KEY="your-key"
```

完整步骤：[OpenAI Python SDK](https://broadrouter.com/zh/guides/openai-python-sdk/)、[OpenAI Node SDK](https://broadrouter.com/zh/guides/openai-node-sdk/)。什么是 [base URL](https://broadrouter.com/zh/glossary/base-url/)、为什么各种工具都要你填它，请看术语表。

## 怎么用 curl 测试新的 base URL？

改动任何应用代码之前，先发一个最小的请求：

```bash
curl https://inference.broadnet.ai/v1/chat/completions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "broadnet/gemma-4-26b-a4b", "messages": [{"role": "user", "content": "ping"}], "max_tokens": 20}'
```

把 base URL、密钥和模型换成你要测试的服务商。返回 200 且带有 `choices` 数组，说明路径、密钥和模型 ID 都没问题。404 通常是路径错了；401 是密钥或地域不对；400 往往会写明服务商不接受哪个参数。[curl 快速入门](https://broadrouter.com/zh/guides/curl-quickstart/)里有更多示例，[API 请求生成器](https://broadrouter.com/tools/api-request-builder/)可以帮你写出 curl、Python 和 Node 三种版本。

## 修改 base\_url 时常见的错误有哪些？

-   \*\*粘贴了完整的端点。\*\*SDK 会自动拼接 `/chat/completions`。如果 base URL 已经以它结尾，就会变成 `/chat/completions/chat/completions`，返回 404。
-   \*\*习惯性地加上或去掉 `/v1`。\*\*DeepSeek 文档中的 base 没有 `/v1`，Z.ai 的以 `/v4/` 结尾，Gemini 的以 `/v1beta/openai/` 结尾。照抄服务商给出的原样字符串。
-   **继续用 OpenAI 的模型名。**`gpt-…` 这类名字在别处会失败。每家服务商都有自己的格式：DeepInfra 上是 `deepseek-ai/DeepSeek-V4-Flash-0731`，Fireworks 上是 `accounts/fireworks/models/…`，BroadNet 上是 `broadnet/deepseek-v4.1-flash`。
-   \*\*发送服务商拒绝或忽略的参数。\*\*Groq 遇到 `logprobs` 返回 400；Anthropic 的兼容层会悄悄忽略 `seed`、`logit_bias` 和 `reasoning_effort`。被悄悄忽略的参数比报错更糟，因为没有任何提示。
-   \*\*以为响应字段都一样。\*\*Anthropic 的兼容层返回空的 `prompt_tokens_details`，所以拿不到缓存 token 的统计。Fireworks 把流式输出的用量放在最后一个数据块里，SDK 的类型定义里可能没有声明。
-   **以为每个端点都存在。**“OpenAI 兼容”通常指的是对话补全。embeddings、音频、图像生成和 Responses API 要分别确认，正如上表所示。
-   \*\*混用地域。\*\*阿里云的密钥绑定地域，Together 另有一个仅限美国的主机。有效的密钥用在错误的主机上，照样会失败。

切换前的完整清单见 [OpenAI 兼容迁移清单](https://broadrouter.com/zh/blog/openai-compatible-api-migration-checklist/)。

## BroadNet Inference 支持哪些端点？

BroadNet 的 [API 参考](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-blog-openai-compatible-api-base-urls&utm_content=body)在 `https://inference.broadnet.ai/v1` 上列出了两个模型端点，另有用于获取目录元数据的 `GET /v1/models`：

| 端点 | 模型 |
| --- | --- |
| `POST /v1/chat/completions` | DeepSeek V4.1 Flash、GLM 5.3、Qwen3.8 27B、BroadNet Gemma 4 VL 26B |
| `POST /v1/audio/transcriptions` | BroadNet Transcribe Arabic、BroadNet Transcribe（14 种语言） |

这在实际使用中意味着：

-   \*\*文档中没有 embeddings、图像生成或 Responses API。\*\*如果某个工具必须用到其中之一，这部分就需要另找一家服务商。
-   **工具调用和结构化输出**在文档中列给了 [GLM 5.3](https://broadrouter.com/zh/models/glm-5.3/) 和 [Qwen3.8 27B](https://broadrouter.com/zh/models/qwen3.8-27b/)。
-   **图像以 `data:` URL 的形式**放在 `image_url` 内容块中传入，适用于 DeepSeek V4.1 Flash、Qwen3.8 27B 和 Gemma 4 VL 26B。
-   **思考模型**（DeepSeek V4.1 Flash、GLM 5.3、Qwen3.8 27B）的思考内容计入 `max_tokens`。按文档建议，预留 1,000 个 token 以上，或把 `reasoning_effort` 设为 `low`；参见[为什么思考模型会返回空回答](https://broadrouter.com/zh/guides/reasoning-tokens-empty-response/)。
-   \*\*模型列表有响应：\*\*我们在 2026 年 11 月 15 日调用 `GET /v1/models` 时得到了返回，但它不在文档列出的端点中，所以不要依赖它。
-   \*\*限制：\*\*按量付费密钥每分钟 30 个请求，同时最多 4 个请求。

每百万 token 价格：DeepSeek V4.1 Flash 输入 $0.175、输出 $0.52，Gemma 4 VL 26B 输入 $0.10、输出 $0.22。DeepSeek V4.1 Flash 还有固定价格套餐，每个会话每月 $60，同一时间一个请求。

## 要不要把多家服务商统一到一个 base URL 后面？

如果你的应用要调用上面好几家服务商，可以用 LiteLLM 这样的代理：你的代码只面对一个 base URL，由代理把模型名映射到各个上游。映射关系由你决定；除非你自己配置了故障转移，否则不会有任何东西替你切换服务商。[大模型 API 故障转移](https://broadrouter.com/zh/blog/llm-api-failover-fallback/)介绍了在客户端或 LiteLLM 中如何实现。[LiteLLM 代理指南](https://broadrouter.com/zh/guides/litellm-proxy-custom-provider/)给出了 BroadNet 的配置条目。关于这个术语的背景，请看 [OpenAI 兼容 API](https://broadrouter.com/zh/glossary/openai-compatible-api/)。

## BroadNet Inference 适合什么场景

如果你的代码已经在用对话补全接口，又想在一个密钥上使用开源模型、阿拉伯语和多语言语音转文字，或者固定价格的 DeepSeek 会话，BroadNet 很合适。如果你需要从同一家服务商获得 embeddings、Responses API 或图像生成，它就不合适；Together AI 和 Gemini 的文档覆盖了更多 OpenAI 接口。上线前请对照各服务商的文档核对我们的表格，因为这些 URL 和端点列表都会变。

相关免费工具（英文）

-   [OpenAI to BroadNet migration helper](https://broadrouter.com/tools/openai-to-broadnet-migration/) Paste OpenAI SDK code; get base URL, key and model edits, a diff and the checks that remain.
-   [max\_tokens calculator for reasoning models](https://broadrouter.com/tools/reasoning-token-budget/) Answer length + reasoning budget + margin = a max\_tokens that does not cut the answer off.
-   [JSON schema generator for LLM structured output](https://broadrouter.com/tools/json-schema-generator/) Sample JSON to strict schema, Pydantic, Zod and a ready request.
-   [LLM JSON output validator](https://broadrouter.com/tools/llm-json-output-validator/) Parse errors by line and column, safe repairs, cut-off detection and JSON Schema checks for model output.

[免费工具（英文）](https://broadrouter.com/tools/)

## 本文涉及的术语

[Base URL（base\_url）](https://broadrouter.com/zh/glossary/base-url/)

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

[嵌入向量（embeddings）](https://broadrouter.com/zh/glossary/embeddings/)

嵌入向量（embeddings）是模型为一段文本、一张图片或其他输入生成的浮点数列表（向量）。意思相近的输入会得到彼此接近的向量，因此可以用向量之间的距离来给搜索结果排序、对文档聚类或查找相关条目。

[Token（词元）](https://broadrouter.com/zh/glossary/token/)

token（词元）是大语言模型读写文本的基本单位：由模型的分词器切分出的一个词、词的一部分、一个标点或一段字节序列。大模型 API 按 token 计数、设定限制，通常也按 token 计费。

[按量付费（pay-as-you-go）](https://broadrouter.com/zh/glossary/pay-as-you-go/)

按量付费是一种计价模式：你只为实际用量付费，按 token、请求次数或音频分钟等单位计量，没有订阅费，也没有最低消费承诺。大多数大模型 API 都这样计费，从预付余额中扣减或定期开具账单。

[并发（concurrency）](https://broadrouter.com/zh/glossary/concurrency/)

并发（concurrency）是客户端在同一时刻正在进行中的请求数。大模型 API 往往按密钥或套餐单独限制并发，与每分钟请求数分开计算，因为每个未完成的请求在响应结束前都会占用 GPU 资源。

[大模型包月套餐（flat-rate LLM plan）](https://broadrouter.com/zh/glossary/flat-rate-llm-plan/)

大模型包月套餐（固定价格套餐）是按一个周期（如一个月）收取固定费用、提供大模型 API 使用权的计价方式，不按 token 计费。这类套餐通常会限制别的东西，如并发、速度、模型或使用时间窗口，所以限制条件和价格同样重要。

[工具调用（tool calling / function calling）](https://broadrouter.com/zh/glossary/tool-calling/)

工具调用（也叫函数调用，function calling）是大模型 API 的一项功能：模型返回一个结构化请求，要求执行开发者定义的某个函数，并附上 JSON 参数。应用执行该函数并把结果发回；模型自己从不执行代码。

[缓存输入 token（cached input tokens）](https://broadrouter.com/zh/glossary/cached-input-tokens/)

缓存输入 token 是大模型服务商近期已处理过、可以直接从缓存中复用而无需重新计算的提示词 token，通常是重复的前缀，例如系统提示词或文档。服务商对它们按低于新输入 token 的单价计费。

## 常见问题

### OpenAI API 的 base URL 是什么？

https://api.openai.com/v1。既没设置 baseURL、也没设置 OPENAI\_BASE\_URL 环境变量时，官方 Node SDK 就使用这个地址。

### base\_url 应该以 /v1 结尾，还是以 /chat/completions 结尾？

服务商文档写到哪里就到哪里为止，通常是 /v1。SDK 会自己加上 /chat/completions，所以如果 base URL 已经以 /chat/completions 结尾，就会得到 404。

### 可以用环境变量设置 base URL 吗？

可以。两个官方 OpenAI SDK 都会读取 OPENAI\_BASE\_URL，许多基于它们的工具也会。同时设置 OPENAI\_API\_KEY，并查看每个工具的文档，因为有些工具用的是自己的变量名。

### Claude API 兼容 OpenAI 吗？

部分兼容。Anthropic 为 OpenAI SDK 提供了 https://api.anthropic.com/v1/，但说明这一层主要用于测试和比较模型，不是长期的生产方案。它会忽略工具上的 strict，并拒绝音频和文件输入。

### BroadNet Inference 支持哪些端点？

它的文档列出了 POST /v1/chat/completions 和 POST /v1/audio/transcriptions，没有列出 embeddings、图像生成或 Responses API。

### 为什么请求在 OpenAI 上正常，换个服务商就报错？

通常是模型 ID 格式不对，或者用了服务商不接受的参数。比如 Groq 遇到 logprobs、logit\_bias、top\_logprobs 和 messages\[\].name 会返回 400。去掉可选参数，再用服务商给出的准确模型 ID 重试。

## 继续阅读

-   [迁移到 OpenAI 兼容 API：切换服务商检查清单](https://broadrouter.com/zh/blog/openai-compatible-api-migration-checklist/)
-   [如何选择大模型 API 服务商：20 项检查清单](https://broadrouter.com/zh/blog/choose-llm-api-provider-checklist/)
-   [切换服务商之前，如何评估大模型](https://broadrouter.com/zh/blog/evaluate-llm-before-switching/)
-   [大模型流式输出详解：SSE 分块、delta、用量与取消](https://broadrouter.com/zh/blog/llm-streaming-sse-explained/)
-   [BroadNet 的 GPU 硬件与推理部署方式（据 BroadNet 自述）](https://broadrouter.com/zh/blog/broadnet-gpu-fleet-and-serving/)
-   [缓存大模型 API 响应以降低成本：用 Python 实现精确匹配缓存](https://broadrouter.com/zh/blog/cache-llm-responses-cut-cost/)
-   [指南：用 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/)
-   [指南：用 curl 首次调用 BroadNet Inference API](https://broadrouter.com/zh/guides/curl-quickstart/)
-   [指南：用 LiteLLM 路由到 BroadNet Inference（SDK 与代理）](https://broadrouter.com/zh/guides/litellm-proxy-custom-provider/)

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

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

**来源**

-   [OpenAI Node SDK 源码 client.ts：默认 base URL 与 OPENAI\_BASE\_URL（2026-11-15 核对）](https://github.com/openai/openai-node/blob/master/src/client.ts)
-   [OpenAI Python SDK README：base\_url 与 OPENAI\_BASE\_URL（2026-11-15 核对）](https://github.com/openai/openai-python)
-   [Anthropic：OpenAI SDK 兼容性（2026-11-15 核对）](https://platform.claude.com/docs/en/api/openai-sdk)
-   [Google：Gemini 的 OpenAI 兼容性（2026-11-15 核对）](https://aistudio.google.com/docs/openai)
-   [DeepSeek API 文档：首次调用 API（2026-11-15 核对）](https://api-docs.deepseek.com/)
-   [Groq：OpenAI 兼容性（2026-11-15 核对）](https://console.groq.com/docs/openai)
-   [Together AI：OpenAI API 兼容性（2026-11-15 核对）](https://docs.together.ai/docs/openai-api-compatibility)
-   [Fireworks AI：OpenAI 兼容性（2026-11-15 核对）](https://docs.fireworks.ai/tools-sdks/openai-compatibility)
-   [DeepInfra：对话补全概述（2026-11-15 核对）](https://docs.deepinfra.com/chat/overview)
-   [Mistral AI API 参考（2026-11-15 核对）](https://docs.mistral.ai/api/)
-   [OpenRouter 快速入门（2026-11-15 核对）](https://openrouter.ai/docs/quickstart)
-   [xAI API 参考与对话指南（2026-11-15 核对）](https://docs.x.ai/docs/guides/chat)
-   [Z.ai：OpenAI Python SDK 指南（2026-11-15 核对）](https://docs.z.ai/guides/develop/openai/python)
-   [阿里云百炼（Model Studio）：OpenAI 兼容（2026-11-15 核对）](https://www.alibabacloud.com/help/en/model-studio/compatibility-of-openai-with-dashscope)
-   [BroadNet Inference API 参考（2026-11-15 核对）（英文）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-blog-openai-compatible-api-base-urls&utm_content=sources)
