获取预置模型版本详情

更新时间：2025-09-22

接口描述

本接口用于获取预置模型版本详情。

鉴权说明

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

请求结构

Bash

POST /v2/model?Action=DescribeSystemModel HTTP/1.1
Host: qianfan.baidubce.com
Authorization: authorization string
Content-Type: application/json

{
     "modelId":"amv-jkxxxxx75x5j"
}

请求头域

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

请求参数

Query参数

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

Body参数

名称	类型	必填	描述
modelId	string	是	模型版本id，通过调用获取预置模型列表接口，返回的modelIds字段获取该字段值

响应头域

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

响应参数

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

result说明

名称	类型	描述
modelSetId	string	模型id
modelId	string	模型版本id
modelName	string	模型版本名称
status	string	状态，说明： · Ready：已就绪 · Creating：创建中 · Fail：创建失败
description	string	模型版本描述
createTime	string	模型版本创建时间
modifyTime	string	模型版本修改时间
modelApplicationType	string	输入输出模式，说明： · chat：对话模式 · completion：续写模式 · embedding：向量模式 · reranker：重排序模式 · Text-to-Image：文生图模式 · Image-to-Text：图生文模式 · video：视频生成模式 · voice：语音生成
tokenLimitations	object	输入输出长度限制
isSupportDeploy	bool	是否支持部署
isSupportModelComp	bool	是否支持压缩
isSupportEvaluation	bool	是否支持评估
capabilities	[]string	模型支持的能力： · reasoning：支持推理思考能力 · function_call：支持工具调用能力 · web_search：支持联网检索增强
modelProviders	[]string	模型提供商，返回参考MB模型广场首页筛选项

tokenLimitations说明

名称	类型	描述
trivial	object	modelApplicationType非reranker类型的模型上下文限制
reranker	object	modelApplicationType为reranker类型的模型上下文限制

trivial说明

名称	类型	描述
inputTokens	int	输入tokens限制
outputTokens	int	输出tokens限制
characterLimit	int	字符数限制

reranker说明

名称	类型	描述
queryTokens	int	query的tokens限制
queryCharacterLimit	int	query的字符数限制
documentTokens	int	document的tokens限制
documentCharacterLimit	int	document的字符数限制

请求示例

Bash

# 替换下列示例中的Authorization值、x-bce-date值
curl -i --location 'https://qianfan.baidubce.com/v2/model?Action=DescribeSystemModel'\
--header 'Authorization: bce-auth-v1/f0ee7axxxx/2025-09-19T08:31:34Z/180000/host;x-bce-date/9a8cfb8eexxxxxxx74525543'\ 
--header 'x-bce-date: 2025-09-19T08:31:34Z'\
--header 'Content-Type: application/json'\ 
--data '{
      "modelId":"amv-jkxxxxx75x5j"
}'

响应示例

JSON

HTTP/1.1 200 OK
{
    "requestId": "ddeeeb8b-xxxx-4e5d-xxxx-3d61404acb59",
    "result": {
        "modelSetId": "am-anxxxxxiy92d",
        "modelId": "amv-jkxxxxx75x5j",
        "modelName": "ERNIE-X1-Turbo-32K",
        "status": "Ready",
        "modelApplicationType": "chat",
        "tokenLimitations": {
            "trivial": {
                "inputTokens": 23552,
                "outputTokens": 28160,
                "characterLimit": 0
            }
        },
        "createTime": "2025-04-24T23:27:08+08:00",
        "modifyTime": "2025-09-04T18:03:29+08:00",
        "isSupportDeploy": false,
        "isSupportModelComp": false,
        "isSupportEvaluation": false,
        "resourceType": null,
        "capabilities": [
            "reasoning",
            "function_call"
        ],
        "modelProviders": [
            "百度"
        ]
    }
}

错误码

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

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

例如错误返回：

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

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

获取预置模型详情

模型压缩