创建服务

更新时间：2024-11-04

注意： 为提升开发者使用体验，本文内容已合并至对应API文档，请查看API鉴权及调用-模型服务-模型服务V1-创建服务；本文档已于2024年6月28日在平台文档中心下线，内容不再更新。

功能介绍

用于创建发布模型服务，可以将某个模型发布成可对外访问的服务。

注意事项

调用本文API，需使用安全认证AK/SK鉴权，调用流程及鉴权介绍详见SDK安装及使用流程。

调用示例

Python

import os
from qianfan import resources
from qianfan.resources.console.consts import DeployPoolType

# 使用安全认证AK/SK鉴权，通过环境变量方式初始化；替换下列示例中参数，安全认证Access Key替换your_iam_ak，Secret Key替换your_iam_sk
os.environ["QIANFAN_ACCESS_KEY"] = "your_iam_ak"
os.environ["QIANFAN_SECRET_KEY"] = "your_iam_sk"

# 创建服务
svc = resources.Service.create(
    model_id=123,
    model_version_id=456,
    name="sdk_test",
    uri="svc_uri",
    replicas=1,
    pool_type=DeployPoolType.PrivateResource,
)
print(svc)

返回示例

Python

QfResponse(code=200, headers={
...
}, 
body={
    "log_id": "2771697584",
    "result": {
        "result": true,
        "serviceId": 164,
        "serviceUuid": "xxx"
     }
 })

参数说明

请求参数

名称	类型	必填	描述
model_id	int	是	模型ID，说明：（1）当前参数仅支持int类型，即之前使用获取的模版ID为int类型，如下图所示：（2）当前通过控制台新创建的模型ID为string类型，暂不支持，后续将支持
model_version_id	int	是	模型版本id，说明：（1）当前参数仅支持int类型，即之前使用以下方式获取的int值：（2）当前通过控制台新创建的模型版本ID为string类型，暂不支持，后续将支持
name	string	是	服务名称，字符串长度为 [2, 20]
uri	string	是	服务URI，字符串长度为 [2, 20]
replicas	int	是	副本数，设置多副本可提高服务性能
pool_type	DeployPoolType	是	资源池类型，可选值如下： DeployPoolType.PrivateResource：私有资源池，默认值为PrivateResource DeployPoolType.PublicResource：公有资源池，只有ernieBotLite-v200-ptuning模型支持公有资源池，返回该字段
description	string	否	服务描述，字符串长度为 [0, 500]

返回参数

名称	类型	描述
log_id	string	请求ID
result	dict	请求结果

result说明

名称	类型	描述
result	bool	创建服务结果，说明： true：成功 false：失败
serviceId	int	创建的服务的ID

百度智能云

千帆大模型服务与开发平台ModelBuilder