HttpApiDeployConfig的AI API部署参数说明-API 网关-阿里云-API 网关(API Gateway)-阿里云帮助中心

名称	类型	描述	示例值
	object	AI API 相关配置。
environmentId	string	环境 ID。	env-xxx
backendScene	string	发布场景。	SingleService
enableSystemModels	boolean	是否启用网关系统模型。仅当发布场景为 AiAutoRouter 时生效，默认值为 false。该字段用于兼容旧客户端；未提交 systemModelTiers 时，true 表示三档系统模型全部启用，false 表示全部不启用。	true
systemModelTiers	array	显式启用的网关系统模型能力档位集合。仅当发布场景为 AiAutoRouter 时生效；支持 economy、standard、premium，显式空数组表示不启用任何系统模型。	["economy","standard","premium"]
	string	网关系统模型能力档位。	economy
autoDeploy	boolean	是否自动部署。	true
gatewayId	string	网关实例 ID。	gw-xx
dfpConfig	object	固定动态转发与 ExtProc 组合。REST API 在 Operation 的 deployConfigs 中提交，ModelAPI 在 API 的 deployConfigs 中提交；两者创建时都须在同一配置项提交 gatewayId 与 dfpConfig.serviceId。服务端校验网关与服务归属一致，并确定默认环境和后端。GetHttpApiOperation、ListHttpApiOperations、GetHttpApi 与 ListHttpApis 仅在对应资源精确挂载当前网关绑定插件时回显整个对象。普通 HTTP API 的 API 级配置不支持该字段。
serviceId	string	已导入的 ExtProc gRPC 服务 ID。REST Operation 或 ModelAPI 创建时必填；更新时必须与当前资源已绑定服务一致。	svc-cr8k0udlhtgt80sh7png
restApiRouteMode	string	REST API 当前线上路由模式。ordinary 表示逐 Operation 路由，compressed 表示 API 单条前缀路由。非 REST API 不返回该字段。	ordinary
routeBackend	Backend	后端服务信息。
gatewayInfo	GatewayInfo	网关信息。
mock	HttpApiMockContract	Mock 配置。
gatewayType	string	网关类型	API
customDomainIds	array	用户自定义域名 ID 列表。
	string	域名 ID。	d-xxx
envDomainIds	array	环境域名 ID 列表。未传表示绑定全部环境域名，空数组表示不绑定环境域名。
	string	环境域名 ID 列表	d-xxx
serviceConfigs	array	服务配置列表。
	object	已有服务配置。
serviceId	string	服务 ID。	svc-xxx
weight	integer	服务权重。	100
modelNamePattern	string	模型名称匹配规则	qwen-*
modelName	string	模型名称	qwen-max
capabilityTier	string	智能路由候选的能力档位。仅当发布场景为 AiAutoRouter 时填写，支持 economy、standard、premium。	standard
intentCode	string	意图编码	INQUIRY
match	HttpApiBackendMatchConditions	匹配条件。
port	integer	服务端口号	80
protocol	string	服务协议（HTTP/HTTPS）	HTTP
gatewayServiceId	string	网关服务 ID	gw-svc-abc123
name	string	服务显示名称	Qwen-Max-Service
version	string	服务版本标签	V2
multiServiceRouteStrategy	string	多服务路由策略类型	ByWeight
observabilityRouteConfig	object	观测指标路由配置
mode	string	路由模式	LeastBusy
rateLimit	number	单个服务最大流量占比	0.8
queueSize	integer	队列大小	100
policyConfigs	array	策略配置列表。
	HttpApiPolicyConfigs	策略配置列表。
customDomainInfos	array	用户自定义域名内容列表。
	object	用户自定义域名内容列表。
domainId	string	域名 ID。	d-cshee6dlhtgk******
name	string	域名名称。	hello-server.com
protocol	string	协议。	HTTP
envDomainInfos	array	环境域名内容列表。
	object	环境域名内容列表
domainId	string	域名 ID。	d-env-xxx
name	string	域名名称。	api.example.com
protocol	string	协议。	HTTPS
subDomains	array	二级域名内容列表。
	object	网络类型。
domainId	string	域名 ID。	d-csmn42um******
name	string	域名名称。	test
protocol	string	协议。	HTTP
networkType	string	网络类型。	Intranet
builtinRouteNames	array	内置路由名称列表
	string	列表	["chat","completions"]

object

AI API 相关配置。

environmentId

string

环境 ID。

env-xxx

backendScene

string

发布场景。

SingleService

enableSystemModels

boolean

是否启用网关系统模型。仅当发布场景为 AiAutoRouter 时生效，默认值为 false。该字段用于兼容旧客户端；未提交 systemModelTiers 时，true 表示三档系统模型全部启用，false 表示全部不启用。

true

systemModelTiers

array

显式启用的网关系统模型能力档位集合。仅当发布场景为 AiAutoRouter 时生效；支持 economy、standard、premium，显式空数组表示不启用任何系统模型。

["economy","standard","premium"]

string

网关系统模型能力档位。

economy

autoDeploy

boolean

是否自动部署。

true

gatewayId

string

网关实例 ID。

gw-xx

dfpConfig

object

固定动态转发与 ExtProc 组合。REST API 在 Operation 的 deployConfigs 中提交，ModelAPI 在 API 的 deployConfigs 中提交；两者创建时都须在同一配置项提交 gatewayId 与 dfpConfig.serviceId。服务端校验网关与服务归属一致，并确定默认环境和后端。GetHttpApiOperation、ListHttpApiOperations、GetHttpApi 与 ListHttpApis 仅在对应资源精确挂载当前网关绑定插件时回显整个对象。普通 HTTP API 的 API 级配置不支持该字段。

serviceId

string

已导入的 ExtProc gRPC 服务 ID。REST Operation 或 ModelAPI 创建时必填；更新时必须与当前资源已绑定服务一致。

svc-cr8k0udlhtgt80sh7png

restApiRouteMode

string

REST API 当前线上路由模式。ordinary 表示逐 Operation 路由，compressed 表示 API 单条前缀路由。非 REST API 不返回该字段。

ordinary

routeBackend

Backend

后端服务信息。

gatewayInfo

GatewayInfo

网关信息。

mock

HttpApiMockContract

Mock 配置。

gatewayType

string

网关类型

API

customDomainIds

array

用户自定义域名 ID 列表。

string

域名 ID。

d-xxx

envDomainIds

array

环境域名 ID 列表。未传表示绑定全部环境域名，空数组表示不绑定环境域名。

string

环境域名 ID 列表

d-xxx

serviceConfigs

array

服务配置列表。

object

已有服务配置。

serviceId

string

服务 ID。

svc-xxx

weight

integer

服务权重。

100

modelNamePattern

string

模型名称匹配规则

qwen-*

modelName

string

模型名称

qwen-max

capabilityTier

string

智能路由候选的能力档位。仅当发布场景为 AiAutoRouter 时填写，支持 economy、standard、premium。

standard

intentCode

string

意图编码

INQUIRY

match

HttpApiBackendMatchConditions

匹配条件。

port

integer

服务端口号

80

protocol

string

服务协议（HTTP/HTTPS）

HTTP

gatewayServiceId

string

网关服务 ID

gw-svc-abc123

name

string

服务显示名称

Qwen-Max-Service

version

string

服务版本标签

V2

multiServiceRouteStrategy

string

多服务路由策略类型

ByWeight

observabilityRouteConfig

object

观测指标路由配置

mode

string

路由模式

LeastBusy

rateLimit

number

单个服务最大流量占比

0.8

queueSize

integer

队列大小

100

policyConfigs

array

策略配置列表。

HttpApiPolicyConfigs

策略配置列表。

customDomainInfos

array

用户自定义域名内容列表。

object

用户自定义域名内容列表。

domainId

string

域名 ID。

d-cshee6dlhtgk******

name

string

域名名称。

hello-server.com

protocol

string

协议。

HTTP

envDomainInfos

array

环境域名内容列表。

object

环境域名内容列表

domainId

string

域名 ID。

d-env-xxx

name

string

域名名称。

api.example.com

protocol

string

协议。

HTTPS

subDomains

array

二级域名内容列表。

object

网络类型。

domainId

string

域名 ID。

d-csmn42um******

name

string

域名名称。

test

protocol

string

协议。

HTTP

networkType

string

网络类型。

Intranet

builtinRouteNames

array

内置路由名称列表

string

列表

["chat","completions"]