通过 OpenAI Private Link,Azure 工作负载可以经由 Azure Private Link 访问 OpenAI API 区域端点,无需直接连接到公共 API 端点。为 OpenAI 提供的每个区域 Private Link 服务创建一个专用端点,在专用 DNS 中将该区域的主机名映射到对应专用端点的 IP 地址,然后按常规方式向该主机名发送经过身份验证的 API 请求。
如果您的组织严格要求流量只能经过 Azure 专用网络,请使用 Private Link。如果没有专用网络要求,OpenAI 公共端点的配置和运维更简单。Private Link 不兼容 IP 允许列表或双向 TLS(mTLS)。如果您在选择企业网络控制措施时需要帮助,请联系 OpenAI。
Private Link 目前尚未开放自助接入。请联系您的 OpenAI 对接人或联系销售团队,申请访问权限并获取所需的区域 Private Link 服务别名或资源标识符。
了解 Private Link 的工作原理
部分客户一直在使用旧版 Private Link 方案(v1)。在该方案中,每个专用端点都连接到一个特定的 OpenAI API 集群。当前的区域方案与旧版有以下区别:
| 旧版 Private Link(v1) | 区域 Private Link | |
|---|---|---|
| 主机名 | 按集群分配,例如 privatelink.enterprise.unified-1.api.openai.com |
按区域分配,例如 southcentralus.privatelink.api.openai.com |
| OpenAI 路由 | 固定路由到一个 OpenAI API 集群 | 区域专用边缘网关可将请求路由到多个后端 OpenAI API 集群 |
| 客户使用的健康检查 | 旧版 v1 健康检查路径 | GET /v2/privatelink_healthcheck |
请求依次经过以下环节:
- 您的应用程序通过专用 DNS 查询区域 Private Link 主机名。
- 专用 DNS 将该主机名解析为您虚拟网络中的 Azure 专用端点地址。
- 专用端点连接到该区域的 OpenAI Private Link 服务。
- Private Link 服务将请求发送到 OpenAI 的区域专用边缘网关。
- 网关将请求路由到该区域通道中已启用企业访问的后端 OpenAI API 集群。
在同一区域通道内,Private Link 可以绕过不可用的后端集群。OpenAI 也可以添加后端集群,无需您重新配置专用端点。发往所选区域主机名的流量不会自动转移到其他区域的专用端点。请勿假定 Private Link 会沿用 OpenAI 公共端点的路由行为。请为应用程序配置跨区域故障转移。
选择区域端点
接入时,OpenAI 会提供具体的 Private Link 服务别名或资源标识符。当前生产环境使用以下区域主机名:
| 区域名称 | 客户使用的主机名 |
|---|---|
| 美国中南部 | southcentralus.privatelink.api.openai.com |
| 美国西部 | westus.privatelink.api.openai.com |
| 美国东部 2 | eastus2.privatelink.api.openai.com |
| 西班牙中部 / 欧盟 | spaincentral.privatelink.api.openai.com |
发往西班牙中部 / 欧盟主机名的请求可以路由到其他欧盟区域(如北欧)的后端集群。
配置 Private Link
1. 提供接入信息
请向 OpenAI 提供以下信息:
- 需要访问 OpenAI Private Link 服务的 Azure 订阅 ID。
- 您的 OpenAI 组织 ID。
- 您需要接入的区域。
- 负责接收维护和区域流量切换通知的运维联系人。
OpenAI 会允许这些订阅查看并连接相应区域的 Private Link 服务,然后提供 Private Link 服务别名或资源标识符。
2. 创建专用端点
为每个选定区域创建一个专用端点。Azure 要求专用端点与您的虚拟网络位于同一区域。请将 --location 设置为虚拟网络所在的区域,该区域可能与 OpenAI Private Link 服务所在的区域不同。
以下命令使用 OpenAI 提供的 Private Link 服务资源标识符:
az network private-endpoint create \
--name openai-privatelink-southcentralus \
--resource-group <customer-resource-group> \
--location <customer-vnet-region> \
--vnet-name <customer-vnet> \
--subnet <customer-private-endpoint-subnet> \
--private-connection-resource-id <openai-provided-pls-resource-id> \
--connection-name openai-privatelink-southcentralus
如果 OpenAI 提供的是别名,请使用该别名并添加 --manual-request true:
az network private-endpoint create \
--name openai-privatelink-southcentralus \
--resource-group <customer-resource-group> \
--location <customer-vnet-region> \
--vnet-name <customer-vnet> \
--subnet <customer-private-endpoint-subnet> \
--private-connection-resource-id <openai-provided-pls-alias> \
--connection-name openai-privatelink-southcentralus \
--manual-request true
Azure 要求指定 --manual-request true 才能使用别名建立连接。如果订阅已列入访问列表,其连接请求仍可自动获批。
如果您的组织通过基础设施即代码来管理专用端点,可以在 Azure 门户或 Terraform 中按类似流程操作。
3. 在更改 DNS 前测试连接
待 OpenAI 批准专用端点且 Azure 完成预配后,记下该端点的专用 IP 地址。使用 curl --resolve 即可测试区域主机名,无需更改全局 DNS 配置:
curl -v \
--resolve southcentralus.privatelink.api.openai.com:443:<PRIVATE_ENDPOINT_IP> \
https://southcentralus.privatelink.api.openai.com/v2/privatelink_healthcheck
服务正常时会返回 HTTP 200,并附带类似以下内容的消息:
{ "message": "Service is up" }
请严格使用健康检查路径 /v2/privatelink_healthcheck。请控制自动健康检查的流量:除非 OpenAI 批准其他速率,否则每秒向每个区域端点最多发送 1 个健康检查请求。
4. 配置专用 DNS
创建专用 DNS 记录,使每个区域的 OpenAI Private Link 主机名在您的网络内都能解析为对应专用端点的 IP 地址:
| 主机名 | 专用端点 IP 地址 |
|---|---|
southcentralus.privatelink.api.openai.com |
<southcentralus-private-endpoint-ip> |
westus.privatelink.api.openai.com |
<westus-private-endpoint-ip> |
eastus2.privatelink.api.openai.com |
<eastus2-private-endpoint-ip> |
spaincentral.privatelink.api.openai.com |
<spaincentral-private-endpoint-ip> |
通过应用程序实际使用的网络路径检查 DNS 解析和连接:
nslookup southcentralus.privatelink.api.openai.com
curl -v https://southcentralus.privatelink.api.openai.com/v2/privatelink_healthcheck
5. 配置跨区域故障转移
Private Link 提供区域入口,但流量仍会发往您选择的区域主机名。请在客户端、服务网格、DNS 层或负载均衡层配置跨区域故障转移。
建议按以下方式处理:
- 使用
GET /v2/privatelink_healthcheck探测每个已配置的区域。 - 收到 HTTP
200时,将该区域视为可用。 - 收到
5xx响应、出现连接错误或 TLS 错误,或多次超时时,将该区域视为不可用。 - 连续出现几次错误后再执行故障转移,以免在区域之间反复切换。
- 在后台继续探测不可用的区域,并根据您的运维策略在区域恢复后切回。
区域健康检查反映专用边缘通道后端 OpenAI API 集群的健康状况。如果某个区域没有已知的后端集群、缺少健康检查配置,或健康的后端集群数量不足,健康检查就会返回错误。
如果您的路由决策取决于特定的 API 或模型,除了执行健康检查,还应通过同一网络路径低频发送模拟请求,调用相应的 API 和模型。
6. 更新应用程序的基础 URL
使用区域 Private Link 主机名设置 OpenAI API 的基础 URL:
from openai import OpenAI
client = OpenAI(
base_url="https://southcentralus.privatelink.api.openai.com/v1",
)SDK 会从您的环境中读取 OPENAI_API_KEY。
您也可以直接调用区域端点:
curl https://southcentralus.privatelink.api.openai.com/v1/responses \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6.2-astra",
"input": "Say hello from Private Link."
}'先在开发或预发布环境中测试,再逐步切换流量。
检查配置
接入或迁移到 Private Link 时,请逐项确认:
- OpenAI 已确认您的 Azure 订阅 ID 可以访问所选区域的 Private Link 服务。
- 您已为每个所选区域创建专用端点,且 OpenAI 已批准这些端点。
- 您已记录各专用端点的 IP 地址。
- 使用
curl --resolve访问/v2/privatelink_healthcheck成功。 - 在应用程序所在的网络中,专用 DNS 能将区域主机名解析为专用端点的 IP 地址。
- 应用程序可以通过区域主机名调用具有代表性的
/v1API 端点。 - 自动健康检查已设置速率限制,且会在出错时记录区域、状态码和错误类型。
- 您已在受控环境中强制将某个区域设为不健康状态,以测试应用程序的故障转移行为。
- 运维文档已明确哪些人员有权更改 DNS、专用端点配置和应用程序的区域路由。
检查端点兼容性
下表列出各公共 API 路由所对应服务的当前部署情况。您仍需在实际环境中验证:请在每个目标区域测试模型可用性、产品访问限制、下游依赖项、请求大小限制、流式传输行为和 WebSocket 行为。Yes(是)表示该区域通道中的每个后端集群都提供此路由;No(否)表示该通道未部署相应的后端服务。
| 端点类别 | 美国中南部 | 美国西部 | 美国东部 2 | 西班牙中部 / 欧盟 |
|---|---|---|---|---|
/v1/responses |
是 | 是 | 是 | 是 |
/v1/chat/completions |
是 | 是 | 是 | 是 |
/v1/completions |
是 | 是 | 是 | 是 |
/v1/embeddings |
是 | 是 | 是 | 是 |
/v1/audio/*(推理) |
是 | 是 | 是 | 是 |
/v1/audio/*(管理) |
是 | 否 | 否 | 是 |
/v1/models |
是 | 是 | 是 | 是 |
/v1/files、/v1/uploads |
是 | 是 | 是 | 是 |
/v1/batches |
是 | 是 | 是 | 是 |
/v1/images/* |
是 | 是 | 是 | 是 |
/v1/moderations |
是 | 是 | 是 | 是 |
/v1/vector_stores |
是 | 是 | 是 | 是 |
/v1/organization/audit_logs |
是 | 是 | 是 | 是 |
其他 /v1/organization/* 端点、/v1/usage |
是 | 否 | 否 | 是 |
/v1/realtime |
是 | 是 | 是 | 是 |
常见问题
Private Link 会自动执行跨区域故障转移吗?
不会。区域专用边缘通道可以在其已配置的后端集群之间路由请求,但不会自动将流量转移到其他区域的专用端点。请为应用程序配置故障转移,使其能在您使用的区域端点之间切换。
应使用哪种健康检查?
请向区域主机名发送 GET /v2/privatelink_healthcheck。旧版 v1 健康检查路径用于探测后端集群的健康检查通道,请勿将其用作客户端的健康探测路径。
应用程序应使用哪个 API 主机名?
请使用区域主机名,并搭配常规的 /v1 API 路径,例如 https://southcentralus.privatelink.api.openai.com/v1。
AWS 或 Google Cloud 工作负载可以通过 Private Link 连接吗?
不能直接连接。Private Link 连接仅适用于 Azure。AWS 或 Google Cloud 中的工作负载必须先通过您自行管理的网络连接到 Azure,例如使用 Azure 代理或跨云专用连接,然后才能从 Azure 通过 Azure Private Link 连接到 OpenAI。
Private Link 会改变身份验证方式吗?
不会。Private Link 仅更改网络路径。请求仍需按常规方式完成 OpenAI API 身份验证和授权。
Private Link 支持所有 OpenAI API 吗?
不支持所有 API。是否支持某个 API,取决于所选区域通道的每个后端集群是否都提供该 API。请先参考兼容性表,再在每个目标区域逐一测试您需要的 API 接口和模型。