{"componentChunkName":"component---src-templates-acg-portal-new-template-tsx","path":"/Tmu9gumsx","result":{"data":{"markdownRemark":{"html":"

该接口用于在指定 AI 网关实例下创建服务，并为 Model 服务生成协议默认路由和所选域名配置。

\n

注意事项：

\n\n

请求结构

\n\n
\n
\n
\n Plain Text\n \n
\n
\n 
1POST /?action=CreateService HTTP/1.1\n2Host: bcc.bj.baidubce.com\n3Authorization: authorization string\n4\n5{\n6    "instanceId": instanceId,\n7    "serviceName": serviceName,\n8    "serviceType": serviceType,\n9    "modelScene": modelScene,\n10    "modelProtocol": modelProtocol,\n11    "modelProtocolRoutes" : [modelProtocolRoute],\n12    "modelBasePath": modelBasePath,\n13    "modelBasePathStrip": modelBasePathStrip,\n14    "domainIds" : [domainId],\n15    "fallbackEnabled": fallbackEnabled,\n16    "fallbackFirstTokenTimeoutMs": fallbackFirstTokenTimeoutMs,\n17    "fallbackTriggerScope": fallbackTriggerScope,\n18    "advancedPolicy": {\n19        "timeout": timeout,\n20        "timeoutTime": timeoutTime,\n21        "retries": retries,\n22        "attempts": attempts,\n23        "perTryTimeout": perTryTimeout,\n24        "retryOn" : [retryOn],\n25        "httpCodes" : [httpCode]\n26    },\n27    "modelBackendStrategy": modelBackendStrategy,\n28    "modelBackends" : [modelBackend]\n29}
\n
\n
\n
\n \n

请求头域

\n

除公共头域外，无其它特殊头域。

\n

请求参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
参数名称类型是否必需参数位置描述
instanceIdString是RequestBody参数网关实例 ID
serviceNameString是RequestBody参数服务名称
serviceTypeString否RequestBody参数服务类型：HTTP_SERVICE（HTTP 服务）/ MODEL_SERVICE（Model 服务）/ AGENT_SERVICE（Agent 服务）
modelSceneString否RequestBody参数模型场景：TEXT_GENERATION / IMAGE_GENERATION / OTHER / VIDEO_GENERATION / EMBEDDING / RERANK / AUDIO，仅 MODEL_SERVICE 时生效
modelProtocolString否RequestBody参数Model 服务协议：OPENAI_COMPATIBLE / ANTHROPIC_COMPATIBLE / QIANFAN / CUSTOM_HTTP / CUSTOM_WEBSOCKET / DOUBAO / BAILIAN / ORIGINAL，仅 MODEL_SERVICE 时生效
modelProtocolRoutesList<ModelProtocolRouteReq>否RequestBody参数Model 服务协议路由列表
modelBasePathString否RequestBody参数Model 服务 basePath
modelBasePathStripBoolean否RequestBody参数转发时是否剥离 basePath
domainIdsList<String>否RequestBody参数绑定的自定义域名 ID 列表
fallbackEnabledBoolean否RequestBody参数是否启用 Fallback
fallbackFirstTokenTimeoutMsint否RequestBody参数Fallback 首 Token 超时时间，单位毫秒，取值不小于 0
fallbackTriggerScopeString否RequestBody参数Fallback 触发范围，目前仅支持 BACKEND_ERROR_ONLY
advancedPolicyAdvancedPolicyReq否RequestBody参数Service 级默认高级策略，仅 MODEL_SERVICE 支持
modelBackendStrategyString否RequestBody参数Model 服务默认路由后端分流策略：SINGLE / MODEL_NAME / WEIGHT
modelBackendsList<ModelBackendBindReq>否RequestBody参数Model 服务默认路由的 upstream/fallback 后端绑定
\n

返回头域

\n

除公共头域，无其它特殊头域。

\n

返回参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
参数名称类型描述
serviceIdString服务 ID
\n

错误码

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
错误码错误描述HTTP状态码中文解释
MethodArgumentNotValidExceptionMethodArgumentNotValidException: serviceName must not be blank400必填参数缺失或格式不合法，instanceId、serviceName 不能为空
HttpMessageNotReadableHttp Message Not Readable: JSON parse error400请求体不是合法 JSON，无法解析，请检查 JSON 语法和字段类型
AiGwAccountNotAuthorizedExceptionAccount not authorized.401当前账号无权限执行该操作
InstanceNotExistInstance not exist.404instanceId 对应的网关实例不存在、不属于当前账号或已释放
DomainNotExistDomain not exist.404domainIds 中存在不存在、不属于当前账号或已绑定其它服务的域名
BackendNotExistBackend not exist.404modelBackends 中存在不存在或不属于当前实例的后端
ServiceNameRepeatedExceptionService name repeated.413同一实例下服务名称已被占用
QuotaCheckErrorService count exceed quota {quota}.413该实例下服务数量已达配额上限 {quota}
ParamCheckErrorInvalid model backend strategy.413服务配置校验不通过，如后端分流策略、Fallback 参数或高级策略取值不合法
HttpMediaTypeExceptionHttpMediaTypeException: Content-Type 'text/plain' is not supported415请求的 Content-Type 不受支持，请使用 application/json
InternalServerErrorInternal Server Error.500服务内部异常，创建过程中发生未预期错误
\n

请求示例

\n\n
\n
\n
\n Plain Text\n \n
\n
\n 
1POST /?action=CreateService HTTP/1.1\n2Host: bcc.bj.baidubce.com\n3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de\n4\n5{\n6    "instanceId": "gw-a1b2c3d4",\n7    "serviceName": "对话服务",\n8    "serviceType": "MODEL_SERVICE",\n9    "modelScene": "TEXT_GENERATION",\n10    "modelProtocol": "OPENAI_COMPATIBLE",\n11    "modelBasePath": "/v1",\n12    "modelBasePathStrip": false,\n13    "domainIds": [\n14        "dm-a1b2c3d4"\n15    ],\n16    "fallbackEnabled": true,\n17    "fallbackFirstTokenTimeoutMs": 3000,\n18    "fallbackTriggerScope": "BACKEND_ERROR_ONLY",\n19    "advancedPolicy": {\n20        "timeout": true,\n21        "timeoutTime": 30000,\n22        "retries": true,\n23        "attempts": 2,\n24        "perTryTimeout": 5000,\n25        "retryOn": [\n26            "5xx"\n27        ],\n28        "httpCodes": [\n29            502,\n30            503\n31        ]\n32    },\n33    "modelBackendStrategy": "SINGLE",\n34    "modelBackends": [\n35        {\n36            "backendId": "bd-a1b2c3d4",\n37            "backendRole": "PRIMARY",\n38            "weight": 10000\n39        }\n40    ]\n41}
\n
\n
\n
\n \n

返回示例

\n\n
\n
\n
\n Plain Text\n \n
\n
\n 
1HTTP/1.1 200 OK\n2x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50\n3Date: Wed, 03 Dec 2014 06:42:19 GMT\n4Content-Type: application/json;charset=UTF-8\n5Server: BWS\n6\n7{\n8    "serviceId": "svc-a1b2c3d4"\n9}
\n
\n
\n
\n ","fields":{"slug":"Tmu9gumsx","title":"创建服务","date":"2026-09-21","extractedHeadings":[]},"headings":[]}},"pageContext":{"isCreatedByStatefulCreatePages":false,"slug":"Tmu9gumsx","prev":{"id":"Fmu9gumm0","name":"校验服务名称是否重复","path":"Fmu9gumm0","filePath":"API网关专享版/API参考/服务相关接口/校验服务名称是否重复.md","seo":null,"parentIds":["Omspw9n4x","9mtlbl1tb","Vmu9gumgk"],"parents":[{"id":"Omspw9n4x","documentId":"cbb7cda2-d4b2-4774-9c2f-c637554847d6","name":"API网关专享版","repoName":"APIGW","filePath":"API网关专享版","disabled":false,"path":"Omspw9n4x","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"9mtlbl1tb","documentId":"4a413222-fb8a-4a99-a3ad-3a8b027a3b08","name":"API参考","repoName":"APIGW","filePath":"API网关专享版/API参考","disabled":false,"path":"9mtlbl1tb","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Vmu9gumgk","documentId":"bbd43863-ce74-40a9-a349-e5d901541c47","name":"服务相关接口","repoName":"APIGW","filePath":"API网关专享版/API参考/服务相关接口","disabled":false,"path":"Vmu9gumgk","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}]},"next":{"id":"0mu9gumjl","name":"查询服务详情","path":"0mu9gumjl","filePath":"API网关专享版/API参考/服务相关接口/查询服务详情.md","seo":null,"parentIds":["Omspw9n4x","9mtlbl1tb","Vmu9gumgk"],"parents":[{"id":"Omspw9n4x","documentId":"cbb7cda2-d4b2-4774-9c2f-c637554847d6","name":"API网关专享版","repoName":"APIGW","filePath":"API网关专享版","disabled":false,"path":"Omspw9n4x","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"9mtlbl1tb","documentId":"4a413222-fb8a-4a99-a3ad-3a8b027a3b08","name":"API参考","repoName":"APIGW","filePath":"API网关专享版/API参考","disabled":false,"path":"9mtlbl1tb","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Vmu9gumgk","documentId":"bbd43863-ce74-40a9-a349-e5d901541c47","name":"服务相关接口","repoName":"APIGW","filePath":"API网关专享版/API参考/服务相关接口","disabled":false,"path":"Vmu9gumgk","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}]},"parents":[{"id":"Omspw9n4x","documentId":"cbb7cda2-d4b2-4774-9c2f-c637554847d6","name":"API网关专享版","repoName":"APIGW","filePath":"API网关专享版","disabled":false,"path":"Omspw9n4x","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"9mtlbl1tb","documentId":"4a413222-fb8a-4a99-a3ad-3a8b027a3b08","name":"API参考","repoName":"APIGW","filePath":"API网关专享版/API参考","disabled":false,"path":"9mtlbl1tb","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Vmu9gumgk","documentId":"bbd43863-ce74-40a9-a349-e5d901541c47","name":"服务相关接口","repoName":"APIGW","filePath":"API网关专享版/API参考/服务相关接口","disabled":false,"path":"Vmu9gumgk","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}],"specificSeo":null}}}