{"componentChunkName":"component---src-templates-acg-portal-new-template-tsx","path":"/Wmwbl48j0","result":{"data":{"markdownRemark":{"html":"\n
\n
\n
\n
\n
POST
\n
\nhttps://qianfan.baidubce.com/v2/service?Action=CreateService\n
\n
\n
\n

本接口用于创建定制服务。

\n
\n
\n

权限说明

\n

调用本文API，需符合以下权限要求，权限介绍及分配，请查看角色与权限控制列表、账号创建与权限分配。需具有以下任一权限：

\n\n

鉴权说明

\n

调用本文API，使用“基于安全认证AK/SK”进行签名计算鉴权，即使用安全认证中的Access Key ID 和 Secret Access Key进行鉴权，具体鉴权认证机制参考HTTP调用鉴权说明。

\n
\n
\n

请求参数

\n
\n
\n
\n
\n
Headers 参数
\n
除公共头域外，无其它特殊头域
\n
\n
\n
\n
\n
Query 参数
\n
\n
\n
\n
\n
\n\nAction\n\nstring\n
\n

方法名称，固定值CreateService

\n
\n
必选
\n
\n
\n
\n
\n
\n
\n
Body 参数
\n
\n
\n
\n
\n
\n\nmodelSetId\n\nstring\n
\n

模型ID，说明：通过以下方法获取该字段值：在控制台-我的模型查看

\n
\n
必选
\n
\n
\n
\n\nmodelId\n\nstring\n
\n

模型版本ID，说明：通过以下方式获取该字段值：· 方式一，通过调用获取模型详情接口，返回的modelVersionIdStr字段获取 · 方式二，在控制台-我的模型-点击某模型详情

\n
\n
必选
\n
\n
\n
\n\nname\n\nstring\n
\n

服务名称，说明：取值范围：字符串长度为 [2, 20]

\n
\n
必选
\n
\n
\n
\n\ndescription\n\nstring\n
\n

服务描述，说明：取值范围：字符串长度为 [0, 500]

\n
\n
可选
\n
\n
\n
\n\nurlSuffix\n\nstring\n
\n

服务URL后缀，说明：（1）取值范围：字符串长度为 [2, 20]（2）字符规则：支持小写英文字母、数字、下划线（_）、短横线（-），首尾必须为字母或数字

\n
\n
必选
\n
\n
\n
\n\ndeploymentConfig\n\nobject {4}\n
\n

表示使用已有资源部署，说明：当新购资源部署时，必须同时填写 resourceConfig 和 billing参数

\n
\n
可选
\n
\n\n
\n\n显示子属性\n隐藏子属性\n
\n\n
\n
\n
\n\ndeploymentComputeUnitList\n\narray\n
\n

部署使用算力单元列表，说明：（1）填写用于部署该模型的算力单元实例ID （2）列表为空时，按照新购资源部署模型处理

\n
\n
必选
\n
\n\n
\n\n显示子属性\n隐藏子属性\n
\n\n
\n
\n
\n\nitems\n\nobject {2}\n
\n
\n
\n\n
\n\n显示子属性\n隐藏子属性\n
\n\n
\n
\n
\n\ninstanceId\n\nstring\n
\n

资源实例ID

\n
\n
必选
\n
\n
\n
\n\ndeploymentReplicasCount\n\ninteger\n
\n

资源申请副本数量

\n
\n
必选
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n\nreplicasCount\n\ninteger\n
\n

资源申请副本数量

\n
\n
必选
\n
\n
\n
\n\nqps\n\nnumber\n
\n

单副本QPS，不填系统默认使用模型预估QPS取值范围：(0, 50]，精确到0.01

\n
\n
可选
\n
\n
\n
\n\nreplicaComputeUnitCount\n\ninteger\n
\n

单副本算力单元，仅对HF模型有效

\n
\n
可选
\n
\n
\n
\n
\n
\n
\n\nresourceConfig\n\nobject {4}\n
\n

资源配置，说明：（1）当新购资源，该参数必填 （2）付费资源类型为Tokens，即chargeType=Tokens时，该字段非必填

\n
\n
可选
\n
\n\n
\n\n显示子属性\n隐藏子属性\n
\n\n
\n
\n
\n\nregion\n\nstring\n
\n

资源地域，说明：（1）如果不填写该字段，系统默认获取满足资源的region （2）如果填写该字段，可选值如下：· bj：北京 · bd：保定。

\n
\n
可选
\n
\n
\n
\n\ntype\n\nstring\n
\n

资源类型，说明：（1）可选值如下：· CPU I型：CPU-1-1 · 加速卡I型：GPU-1-1、GPU-1-2、GPU-1-4、GPU-1-8 · 加速卡V型：GPU-5-1、GPU-5-2 · 加速卡VI型：GPU-6-1、GPU-6-2 · 加速卡VII型：GPU-7-1、GPU-7-2 （2）付费资源类型为ComputingUnit，即chargeType=ComputingUnit时，该字段必填。

\n
\n
可选
\n
\n
\n
\n\nqps\n\nnumber\n
\n

单副本QPS，说明：（1）不填此字段，默认使用模型预估QPS（2）取值范围：(0, 50]，精确到0.01

\n
\n
可选
\n
\n
\n
\n\nreplicasCount\n\ninteger\n
\n

购买副本数量

\n
\n
必选
\n
\n
\n
\n
\n
\n
\n\nbilling\n\nobject {4}\n
\n

订单、计费相关参数，说明：当新购资源，该参数必填

\n
\n
可选
\n
\n\n
\n\n显示子属性\n隐藏子属性\n
\n\n
\n
\n
\n\npaymentTiming\n\nstring\n
\n

付费类型。可选值: Prepaid, Postpaid

\n
\n
必选
\n
\n
\n
\n\nreservation\n\nobject {5}\n
\n

保留信息，说明：（1）只有当付费类型为预付费，即paymentTiming值为Prepaid时，该字段必填 （2）付费类型为后付费，无需填写此参数

\n
\n
必选
\n
\n\n
\n\n显示子属性\n隐藏子属性\n
\n\n
\n
\n
\n\nreservationTimeUnit\n\nstring\n
\n

时间单位。可选值: Month

\n
\n
必选
\n
\n
\n
\n\nreservationLength\n\ninteger\n
\n

购买时长，说明：时间单位为月，取值范围 [1-12]

\n
\n
必选
\n
\n
\n
\n\nautoRenew\n\nboolean\n
\n

是否自动续费，可选值：· true：是 · false：否，默认值为false。默认值: false

\n
\n
可选
\n
\n
\n
\n\nautoRenewTimeUnit\n\nstring\n
\n

自动续费周期时间单位，默认值为Month。可选值: Month。默认值: Month

\n
\n
可选
\n
\n
\n
\n\nautoRenewTime\n\ninteger\n
\n

自动续费时长，说明：（1）单位：月 （2）默认值为1，取值范围：[1,6]。默认值: 1

\n
\n
可选
\n
\n
\n
\n
\n
\n
\n\nchargeType\n\nstring\n
\n

付费资源类型，说明：（1）只有当付费类型为后付费，即paymentTiming值为Postpaid时，该字段必填，可选值如下：· ComputingUnit：算力单元，默认值为ComputingUnit · Tokens：Tokens消耗量 （2）付费类型为预付费，无需填写此参数。

\n
\n
可选
\n
\n
\n
\n\nreleaseTime\n\nstring\n
\n

定时释放时间，说明：（1）只有当付费类型为后付费，即paymentTiming值为Postpaid时，该字段有效（2）支持RFC3339格式和标准格式，如2030-01-25T12:30:30+08:00、2030-01-25 12:30:30

\n
\n
可选
\n
\n
\n
\n
\n
\n
\n\nprotocolVersion\n\ninteger\n
\n

服务版本。可选值: 1, 2。默认值: 2

\n
\n
可选
\n
\n
\n
\n
\n
\n
\n
\n
\n
请求结构
\n\n
\n
\n\n
\n
POST /v2/service?Action=CreateService HTTP/1.1\nHost: qianfan.baidubce.com\nAuthorization: authorization string\nContent-Type: application/json\n\n{\n    \"modelSetId\": \"am-3aa2***5c9\",\n    \"modelId\": \"amv-ur1u1***722s\",\n    \"name\": \"apitest_1226_3\",\n    \"urlSuffix\": \"apitest_1226_3\",\n    \"deploymentConfig\": {\n        \"qps\": 1,\n        \"replicaComputeUnitCount\": 1,\n        \"replicasCount\":1,\n        \"deploymentComputeUnitList\": [\n            {\n                \"instanceId\": \"unit-gdqb1Fot\",\n                \"deploymentReplicasCount\": 2\n            }\n        ]\n    },\n    \"protocolVersion\": 1\n}
\n
\n
\n
\n
\n
\n
\n
\n

示例代码

\n
\n
\n\n\n
\n
\n
\n
\n\n
\n
\n
\n
curl
\n\n
\n
\n\n
\n
curl --location 'https://qianfan.baidubce.com/v2/service?Action=CreateService' \\\n--header 'Authorization: bce-auth-v1/047ab***3e28b1ac/2024-01-10T08:39:09Z/180000/host;x-bce-date/817d842c4243xx***304cb01' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"modelSetId\": \"am-3aa2***5c9\",\n    \"modelId\": \"amv-ur1u1***722s\",\n    \"name\": \"apitest_1226_3\",\n    \"urlSuffix\": \"apitest_1226_3\",\n    \"deploymentConfig\": {\n        \"qps\": 1,\n        \"replicaComputeUnitCount\": 1,\n        \"replicasCount\":1,\n        \"deploymentComputeUnitList\": [\n            {\n                \"instanceId\": \"unit-gdqb1Fot\",\n                \"deploymentReplicasCount\": 2\n            }\n        ]\n    },\n    \"protocolVersion\": 1\n}'
\n
\n
\n
\n
\n\n
\n
\n
\n
curl
\n\n
\n
\n\n
\n
curl --location 'https://qianfan.baidubce.com/v2/service?Action=CreateService' \\\n--header 'Authorization: bce-auth-v1/047ab***3e28b1ac/2024-01-10T08:39:09Z/180000/host;x-bce-date/817d842c4243xx***304cb01' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"modelSetId\": \"am-3aa232bah5c9\",\n    \"modelId\": \"amv-ur1u1bez722s\",\n    \"name\": \"apitest_1226_7\",\n    \"urlSuffix\": \"apitest_1226_7\",   \n    \"resourceConfig\": {\n        \"region\": \"bj\",\n        \"type\": \"GPU-1-1\",\n        \"qps\": 1,\n        \"replicasCount\": 1\n    },\n    \"billing\": {\n        \"paymentTiming\": \"Postpaid\"\n        \n    },\n    \"protocolVersion\": 1\n}'
\n
\n
\n
\n
\n
\n
\n
\n

返回响应

\n
\n
\n
\n
\n
Headers 参数
\n
除公共头域外，无其它特殊头域
\n
\n
\n
\n
\n
返回参数
\n
\n
\n
\n
\n
\n\nrequestId\n\nstring\n
\n

请求ID

\n
\n
必选
\n
\n
\n
\n\nresult\n\nobject {3}\n
\n
\n
必选
\n
\n\n
\n\n显示子属性\n隐藏子属性\n
\n\n
\n
\n
\n\nserviceId\n\nstring\n
\n

服务ID

\n
\n
必选
\n
\n
\n
\n\ninstanceId\n\nstring\n
\n

实例ID，说明：只有新购资源，返回该字段

\n
\n
可选
\n
\n
\n
\n\norderId\n\nstring\n
\n

订单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
JSON
\n\n
\n
\n\n
\n
{\n    \"requestId\": \"18a7c588-7157-4184-b911-e4ccfe5f719b\",\n    \"result\": {\n        \"serviceId\": \"svco-juw***j1\"\n    }\n}
\n
\n
\n
\n
\n\n
\n
\n
\n
JSON
\n\n
\n
\n\n
\n
{\n    \"requestId\": \"34cee53b-7064-418c-843b-fd0594536c3d\",\n    \"result\": {\n        \"instanceId\": \"unit-zO***0Ck\",\n        \"orderId\": \"98cd9fb0e1524db6854ff05c471e6d62\",\n        \"serviceId\": \"svco-hc5***jumb\"\n    }\n}
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n

错误码

\n

若请求错误，服务器将返回的JSON文本包含以下参数：

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
名称描述
requestId请求ID
code错误码
message错误描述信息，帮助理解和解决发生的错误
\n

例如错误返回：

\n
text
{\n    \"requestId\":\"6ba7b810-xxxc04fd430c8\",\n    \"code\":\"AccessDenied\",\n    \"message\":\"Access denied.\"\n}\n
\n

更多其他错误码，也可以查看错误码说明。

\n
\n
","fields":{"slug":"Wmwbl48j0","title":"创建定制服务","date":"2026-11-11","extractedHeadings":[{"value":"权限说明","depth":2},{"value":"鉴权说明","depth":2},{"value":"请求参数","depth":2},{"value":"示例代码","depth":2},{"value":"返回响应","depth":2},{"value":"错误码","depth":2}]},"headings":[]}},"pageContext":{"isCreatedByStatefulCreatePages":false,"slug":"Wmwbl48j0","prev":{"id":"gmwbl48h7","name":"查询服务调用详情","path":"gmwbl48h7","filePath":"模型/服务管控 API（控制面）/服务管理/定制服务/查询服务调用详情.md","seo":null,"parentIds":["Zmwbl43s8","pmwbl462b","vmwbl47sm","6mwbl482g"],"parents":[{"id":"Zmwbl43s8","documentId":"0098c3f5-6f86-4ca0-ba61-8c65e07a87a5","name":"模型","repoName":"qianfan-api","filePath":"模型","disabled":false,"path":"Zmwbl43s8","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"pmwbl462b","documentId":"fb83bfba-52fc-4de6-a545-c8ff91c9744b","name":"管控 API（管控面）","repoName":"qianfan-api","filePath":"模型/服务管控 API（控制面）","disabled":false,"path":"pmwbl462b","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":{"title":null,"keywords":null,"description":null,"serviceType":null},"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"vmwbl47sm","documentId":"c84c9a87-1d9c-4557-ab78-3f7a2cf4a930","name":"服务管理","repoName":"qianfan-api","filePath":"模型/服务管控 API（控制面）/服务管理","disabled":false,"path":"vmwbl47sm","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"6mwbl482g","documentId":"51e9d3ee-5b2e-4cc6-aa93-e586869dd0eb","name":"定制服务","repoName":"qianfan-api","filePath":"模型/服务管控 API（控制面）/服务管理/定制服务","disabled":false,"path":"6mwbl482g","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}]},"next":{"id":"Cmwbl46ns","name":"数据管理","path":"Cmwbl46ns","filePath":"模型/服务管控 API（控制面）/数据管理（待展开核对）/数据集管理/获取数据集版本详情.md","seo":null,"parentIds":["Zmwbl43s8","pmwbl462b","Umwbl46nd","amwbl46nk"],"parents":[{"id":"Zmwbl43s8","documentId":"0098c3f5-6f86-4ca0-ba61-8c65e07a87a5","name":"模型","repoName":"qianfan-api","filePath":"模型","disabled":false,"path":"Zmwbl43s8","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"pmwbl462b","documentId":"fb83bfba-52fc-4de6-a545-c8ff91c9744b","name":"管控 API（管控面）","repoName":"qianfan-api","filePath":"模型/服务管控 API（控制面）","disabled":false,"path":"pmwbl462b","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":{"title":null,"keywords":null,"description":null,"serviceType":null},"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Umwbl46nd","documentId":"6aa8ac00-2abf-4864-a15b-ba43d301e2f6","name":"数据管理","repoName":"qianfan-api","filePath":"模型/服务管控 API（控制面）/数据管理（待展开核对）","disabled":false,"path":"Umwbl46nd","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":{"title":null,"keywords":null,"description":null,"serviceType":null},"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"amwbl46nk","documentId":"511e04f9-02a9-45e9-8a0c-12063bca4e14","name":"数据集管理","repoName":"qianfan-api","filePath":"模型/服务管控 API（控制面）/数据管理（待展开核对）/数据集管理","disabled":false,"path":"amwbl46nk","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}]},"parents":[{"id":"Zmwbl43s8","documentId":"0098c3f5-6f86-4ca0-ba61-8c65e07a87a5","name":"模型","repoName":"qianfan-api","filePath":"模型","disabled":false,"path":"Zmwbl43s8","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"pmwbl462b","documentId":"fb83bfba-52fc-4de6-a545-c8ff91c9744b","name":"管控 API（管控面）","repoName":"qianfan-api","filePath":"模型/服务管控 API（控制面）","disabled":false,"path":"pmwbl462b","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":{"title":null,"keywords":null,"description":null,"serviceType":null},"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"vmwbl47sm","documentId":"c84c9a87-1d9c-4557-ab78-3f7a2cf4a930","name":"服务管理","repoName":"qianfan-api","filePath":"模型/服务管控 API（控制面）/服务管理","disabled":false,"path":"vmwbl47sm","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"6mwbl482g","documentId":"51e9d3ee-5b2e-4cc6-aa93-e586869dd0eb","name":"定制服务","repoName":"qianfan-api","filePath":"模型/服务管控 API（控制面）/服务管理/定制服务","disabled":false,"path":"6mwbl482g","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}],"specificSeo":null}}}