获取定制服务详情

更新时间：2024-11-08

功能介绍

本接口用于获取服务详情。

权限说明

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

管理员权限：QianfanFullControlAccessPolicy
模型服务运维权限：QianfanServiceOperateAccessPolicy
模型服务只读权限：QianfanServiceReadAccessPolicy

HTTP调用

鉴权说明

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

请求说明

基本信息

请求地址： https://qianfan.baidubce.com/v2/service

请求方式： POST

Header参数

名称	类型	必填	描述
Content-Type	string	是	固定值：application/json
x-bce-date	string	否	当前时间，遵循ISO8601规范，格式如2016-04-06T08:23:49Z
Authorization	string	是	用于验证请求合法性的认证信息，更多内容请参考鉴权认证机制，签名工具可参考IAM签名工具

Query参数

名称	类型	必填	描述
Action	string	是	方法名称，固定值DescribeService

Body参数

名称	类型	必填	描述
serviceId	string	是	服务ID，可以通过任一方式获取：方式一：通过调用接口创建服务，返回参数serviceId获取方式二：通过控制台-在线服务-我的服务页面，点击某服务详情查看，如下图所示：

响应说明

名称	类型	描述
requestId	string	请求ID
result	object	请求结果

result说明

名称	类型	描述
serviceId	string	服务ID
baseModel	string	基础模型版本
modelSetId	string	模型ID
modelId	string	模型版本ID
name	string	服务名称
description	string	服务描述
url	string	服务URL
serviceType	string	服务类型
runStatus	string	服务状态，说明： · New：待发布 · Deploying：发布中 · Serving：已发布 · Failed：发布失败 · Stopped：暂停服务
chargeType	string	付费类型，说明： · ComputingUnit: 算力单元使用时长 · Tokens: Tokens调用量
payType	string	付费方式，说明： · Prepay: 预付费 · Postpay: 后付费 · Prepay,Postpay: 预付费+后付费
chargeStatus	string	付费状态，说明： · NotOpen · Opened · Free
resourceConfig	object	资源配置
isModelUpdating	bool	模型版本是否更新中
enableLogs	bool	是否绑定日志投递
logStoreConfig	object	日志投递信息
creator	string	创建人
createTime	string	创建时间

resourceConfig说明

名称	类型	描述
type	string	资源类型，说明： · GPU-I-2：AI加速卡-I型-2算力单元 · GPU-I-4：AI加速卡-I型-4算力单元 · CPU-I-2：CPU-I型-2算力单元
qps	float	单副本QPS
replicasCount	int	购买副本数量
region	string	资源地域，说明： · bj：北京 · bd：保定 · gz：广州 · su：苏州 · nj：南京

logStoreConfig说明

名称	类型	描述
logRegion	string	日志集所在地域。当enableLogs为true，显示logRegion
logProject	string	日志组名称。当enableLogs为true，显示logProject
logStoreName	string	日志集名称。当enableLogs为true，显示logStoreName

请求示例

Bash

curl --location 'https://qianfan.baidubce.com/v2/service?Action=DescribeService' \
--header 'Authorization: bce-auth-v1/047ab241bad24166b42a4d2e3e28b1ac/2024-01-10T08:39:09Z/180000/host;x-bce-date/eae9855604c2e3xxxxxa3f0a7318bb94f17f7e03cfcbaff' \
--header 'x-bce-date: 2024-01-10T08:37:40Z' \
--header 'Content-Type: application/json' \
--data '{
    "serviceId":"svco-dywitgcxaq6j"
}'

响应示例

JSON

{
    "requestId": "1bef3f87-c5b2-4419-936b-50f9884f10d4",
    "result": {
        "serviceId": "svco-dywitgcxaq6j",
        "baseModel": "ERNIE-Character-8K-0321",
        "modelSetId": "am-jb0kzci16x14",
        "modelId": "amv-0590vsgisd6d6",
        "name": "yige",
        "description": "ttt",
        "url": "https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/text2image/a0cj0hci_yige_v1",
        "serviceType": "text2image",
        "runStatus": "Failed",
        "chargeType": "ComputingUnit",
        "payType": "Prepay",
        "chargeStatus": "Free",
        "resourceConfig": {
            "region":"bj",
            "type": "GPU-1-1",
            "replicasCount": 1,
            "qps": 10
        },
        "isModelUpdating":true,
        "enableLogs": true,
        "logStoreConfig": {
            "logRegion": "bj",
            "logProject": "default",
            "logStoreName": "test02"
        },
        "creator":"accountName",
        "createTime": "2024-01-08T15:29:27Z"
    }
}

SDK调用

平台支持通过Python SDK、Go SDK、Java SDK 和 Node.js SDK调用本文API，SDK调用说明文档请参考获取定制服务详情。

错误码

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

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

例如错误返回：

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

更多相关错误码，请查看错误码说明。

获取定制服务列表

查询服务调用情况

百度智能云

百度智能云千帆大模型服务与开发平台ModelBuilder