通过终端节点私网访问阿里云百炼模型或应用 API

​

工作原理

• 公网调用：直接访问公网 MaaS 域名 {WorkspaceId}.{RegionId}.maas.aliyuncs.com，流量经公网到达百炼。
• PrivateLink 私网连接：在百炼控制台为 VPC 添加私网连接后，通过私网域名访问百炼，流量全程走阿里云内网，不经过公网。

• 公共云：华北2（北京）、中国香港。

  其他地域暂不支持私网访问。

​

通过私网连接访问阿里云百炼 API

​

步骤一：在百炼控制台添加私网连接

1. 登录百炼控制台，在左侧导航栏选择管理 > 网络配置。
2. 首次使用时，在添加私网连接面板中按照指引完成以下准备：
   • 授权私网连接服务关联角色：单击立即授权，自动创建服务关联角色 AliyunServiceRoleForBackrouterAccessNet。
   • 开通私网连接：单击立即开通，开通私网连接（PrivateLink）服务。
3. 在VPC私网访问区域单击添加，配置以下各项参数，其他参数保持默认即可。
   • 地域：根据阿里云百炼服务地域选择，例如“华北2（北京）”。
   • VPC：选择计划用于访问阿里云百炼服务的 VPC。私网连接将被创建到该 VPC 内，仅该 VPC 内的 ECS、容器等资源才能通过私网域名访问阿里云百炼服务。如无可用 VPC，可单击创建VPC跳转至专有网络控制台创建。
   • 可用区与交换机：选择阿里云百炼支持且包含交换机的可用区及对应交换机。私网连接会占用所选可用区下交换机的一个内网 IP 地址，作为百炼私网域名的内网解析地址。最多可添加 2 个可用区与交换机组合，建议添加 2 个以实现高可用：当某个可用区发生故障时，流量可自动切换至其他可用区，避免服务中断。如无可用交换机，可单击创建交换机跳转至专有网络控制台创建。
   • 安全组：选择关联到私网连接的安全组，用于控制谁可以访问该私网连接。因此请确保安全组在入方向允许 443（https）访问。如无可用安全组，可单击创建安全组跳转至云服务器 ECS 控制台创建。
4. 单击确认，等待状态变为创建成功。添加完成后预计延迟 1～3min 生效，生效期间该 VPC 下任意云服务器均可使用私网域名访问百炼服务。

​

步骤二：关联业务空间

1. 在百炼控制台左侧导航栏选择业务空间管理，新建业务空间或编辑目标业务空间。
2. 在高级配置中，将私网连接设置为目标私网连接。下拉选项展示终端节点 ID 及其所属地域和 VPC；如无目标选项，可在下拉框中单击新建私网连接创建。关联后，该业务空间可通过对应 VPC 的私网连接访问百炼服务。
3. 如需解除关联：编辑业务空间并清空私网连接后保存；或在网络配置页面展开目标私网连接行，在关联业务空间中单击解绑，跳转至对应业务空间处理。已关联业务空间的私网连接需先解绑才能删除。

​

步骤三：获取私网域名

​

步骤四：调用验证

• 替换前：https://{WorkspaceId}.{RegionId}.maas.aliyuncs.com/compatible-mode/v1/chat/completions
• 替换后：https://{WorkspaceId}-{VpcId}.{RegionId}.maas.aliyuncs.com/compatible-mode/v1/chat/completions

# 将原始域名替换为上一步骤中获取到的私网域名
curl -X POST https://{WorkspaceId}-{VpcId}.{RegionId}.maas.aliyuncs.com/compatible-mode/v1/chat/completions \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "qwen-flash",
    "messages": [
        {
            "role": "system",
            "content": "You are a helpful assistant."
        },
        {
            "role": "user",
            "content": "你是谁？"
        }
    ]
}'

调用前，需要您已完成获取与配置 API Key。如需要直接传入 API Key，请将$DASHSCOPE_API_KEY 替换为您的 API Key。

​

计费说明

​

常见问题

1. 为什么我的 ECS 实例无法通过私网连接访问阿里云百炼 API？ 请按照以下步骤排查：
   1. 确认是否在同一 VPC。 如果ECS实例的 VPC，与配置私网连接的 VPC 不同，则无法通过私网访问阿里云百炼 API，需要先配置 VPC互连。
   2. 检查私网连接关联的安全组，确认已添加入方向规则，允许来自发起端ECS实例所在网段对 443（HTTPS）端口的访问。
   3. 确认私网连接状态。 私网连接状态为创建成功且已生效（添加完成后预计延迟 1～3min）后，才能通过私网域名访问阿里云百炼 API。
   4. 确认业务空间已关联。 私网域名在业务空间与私网连接关联后才生成。如果展开行的 Endpoint 列为空，请先按步骤二关联业务空间。
2. 终端节点能否从公网访问？ 不可以。私网连接（PrivateLink）仅用于在阿里云内网建立私有连接。终端节点不具备公网访问能力，终端节点网卡也无法绑定弹性公网IP (EIP)。
3. 通过旧方式创建的存量私网连接，还需要关联业务空间吗？ 不需要。此前在私网连接（专有网络 VPC）控制台创建接口终端节点所建立的存量私网连接，默认关联所有业务空间，可直接用于私网访问阿里云百炼 API，无需执行步骤二。 在网络配置页面展开存量私网连接，Endpoint 列展示 vpc-{地域ID}.dashscope.aliyuncs.com（例如 vpc-cn-beijing.dashscope.aliyuncs.com），关联业务空间列显示所有业务空间；这与新流程按业务空间逐条展示 {WorkspaceId}-{VpcId}.{地域ID}.maas.aliyuncs.com 不同。 旧方式已不再支持创建新的私网连接。如需新增，请按步骤一在百炼控制台创建，并按步骤二关联需要私网访问的业务空间。