添加服务
更新时间：2026-09-04
接口描述
向指定 AI 网关实例登记服务。支持 CCE、MSE、FIXED_IP、DNS_DOMAIN、CFC 和 AI_PROXY 服务；AI_PROXY 服务可配置 Qianfan 等模型供应商的 API Key。
OpenAPI Explorer
去调试
您可以在 OpenAPI Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer 可以自动生成 SDK 代码示例。
请求结构
Plain Text
1POST /v1/aigw/cluster/{instanceId}/serviceList HTTP/1.1
2Host: aigw.bj.baidubce.com
3X-Region: bj
4Authorization: authorization string
5Content-Type: application/json请求头域
除公共头域外，还需传入以下头域：
| 请求头 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| X-Region | String | 是 | 地域代码，如 bj、gz、su、cd、yq、bd |
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| instanceId | String | 是 | URL参数 | AI 网关实例 ID，位于路径中 |
| serviceSource | String | 是 | RequestBody参数 | 服务来源：CCE、MSE、FIXED_IP、DNS_DOMAIN、CFC、AI_PROXY |
| namespace | String | 是 | RequestBody参数 | 服务命名空间；AI_PROXY 默认 default |
| serviceName | String | 否 | RequestBody参数 | 固定 IP、DNS_DOMAIN 或 AI_PROXY 服务名称 |
| clusterId | String | 否 | RequestBody参数 | CCE 或托管集群 ID |
| clusterIds | List |
否 | RequestBody参数 | CCE 多集群绑定 ID 列表 |
| serviceList | List |
否 | RequestBody参数 | CCE/MSE/CFC 服务列表 |
| registryId | String | 否 | RequestBody参数 | MSE 服务注册中心 ID |
| serviceAddresses | List |
否 | RequestBody参数 | 固定 IP 或 DNS 地址列表，格式为 host:port |
| serviceProtocol | String | 否 | RequestBody参数 | HTTP、HTTPS 或 HTTP&HTTPS |
| provider | String | 否 | RequestBody参数 | AI_PROXY 模型供应商，如 QIANFAN、DEEPSEEK、OPENAI |
| endpoint | String | 否 | RequestBody参数 | 模型供应商端点；Qianfan 使用 https://qianfan.baidubce.com/v2 |
| apiKeys | List |
否 | RequestBody参数 | 模型供应商 API Key 列表；IAM 模式禁止传入 |
| credentialSource | String | 否 | RequestBody参数 | AI_PROXY 凭证来源：DEFAULT 或 IAM |
| credentialNames | List |
否 | RequestBody参数 | IAM CredentialProvider 名称列表 |
| failoverEnabled | Boolean | 否 | RequestBody参数 | 是否启用模型 Failover |
| failoverModel | String | 否 | RequestBody参数 | Failover 健康检查模型 |
返回状态码
成功返回 200；参数错误返回 400；实例不存在返回 404；服务创建失败返回 500。
返回头域
除公共头域外，无其他特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| addedCount | Integer | 成功登记的服务数量 |
请求示例
Plain Text
1POST /v1/aigw/cluster/aigw-example/serviceList HTTP/1.1
2Host: aigw.bj.baidubce.com
3X-Region: bj
4Authorization: authorization string
5Content-Type: application/json
6
7{
8 "serviceSource": "AI_PROXY",
9 "namespace": "default",
10 "serviceName": "qianfan-service",
11 "provider": "QIANFAN",
12 "endpoint": "https://qianfan.baidubce.com/v2",
13 "apiKeys": ["<QIANFAN_API_KEY>"]
14}返回示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json;charset=UTF-8
3
4{
5 "addedCount": 1
6}评价此篇文章