获取预置模型详情

更新时间：2025-09-15

功能介绍

用于获取预置模型详情。

使用说明

本文API支持通过Python SDK、Go SDK、Java SDK 和 Node.js SDK调用，调用流程请参考SDK安装及使用流程。

SDK调用

调用示例

import os
from qianfan  import resources

# 通过环境变量初始化认证信息
# 使用安全认证AK/SK调用，替换下列示例中参数，安全认证Access Key替换your_iam_ak，Secret Key替换your_iam_sk，如何获取请查看https://cloud.baidu.com/doc/Reference/s/9jwvz2egb
os.environ["QIANFAN_ACCESS_KEY"] = "your_iam_ak"
os.environ["QIANFAN_SECRET_KEY"] = "your_iam_sk"

resp = resources.console.utils.call_action(
    # 调用本文API，该参数值为固定值，无需修改；对应API调用文档-请求结构-请求地址的后缀
    "/v2/model", 
    # 调用本文API，该参数值为固定值，无需修改；对应API调用文档-请求参数-Query参数的Action 
    "DescribeSystemModelSet", 
    # 请查看本文请求参数说明，根据实际使用选择参数；对应API调用文档-请求参数-Body参数
    {
        "modelSetName":"ERNIE Lite"
    }
)
print(resp.body)

package main

import (
    "context"
    "fmt"
    "os"

    "github.com/baidubce/bce-qianfan-sdk/go/qianfan"
)

func main() {
     // 使用安全认证AK/SK鉴权，通过环境变量初始化；替换下列示例中参数，安全认证Access Key替换your_iam_ak，Secret Key替换your_iam_sk
    os.Setenv("QIANFAN_ACCESS_KEY", "your_iam_ak")
    os.Setenv("QIANFAN_SECRET_KEY", "your_iam_sk")
    
    ca := qianfan.NewConsoleAction()
    
    res, err := ca.Call(context.TODO(), 
     // 调用本文API，该参数值为固定值，无需修改；对应API调用文档-请求结构-请求地址的后缀
    "/v2/model",
    // 调用本文API，该参数值为固定值，无需修改；对应API调用文档-请求参数-Query参数的Action 
     "DescribeSystemModelSet",
     // 请查看本文请求参数说明，根据实际使用选择参数；对应API调用文档-请求参数-Body参数
      map[string]interface{}{
        "modelSetName":"ERNIE Lite",
    })
    if err != nil {
        panic(err)
    }
    fmt.Println(string(res.Body))
    
}

import com.baidubce.qianfan.Qianfan;
import com.baidubce.qianfan.model.console.ConsoleResponse;
import com.baidubce.qianfan.util.CollUtils;
import com.baidubce.qianfan.util.Json;
import java.util.Map;

public class Dome {
    public static void main(String args[]){
        // 使用安全认证AK/SK鉴权，替换下列示例中参数，安全认证Access Key替换your_iam_ak，Secret Key替换your_iam_sk
        Qianfan qianfan = new Qianfan("your_iam_ak", "your_iam_sk");
        
        ConsoleResponse<Map<String, Object>> response = qianfan.console()
                // 调用本文API，该参数值为固定值，无需修改；对应API调用文档-请求结构-请求地址的后缀
                .route("/v2/model")
                // 调用本文API，该参数值为固定值，无需修改；对应API调用文档-请求参数-Query参数的Action 
                .action("DescribeSystemModelSet")
                // 需要传入参数的场景，可以自行封装请求类，或者使用Map.of()来构建请求Body
                // Java 8可以使用SDK提供的CollUtils.mapOf()来替代Map.of()
                // 请查看本文请求参数说明，根据实际使用选择参数；对应API调用文档-请求参数-Body参数
                .body(CollUtils.mapOf(
                     "modelSetName","ERNIE Lite"
                ))
                .execute();

        System.out.println(Json.serialize(response));
    }
}

import {consoleAction, setEnvVariable} from "@baiducloud/qianfan";

// 使用安全认证AK/SK鉴权，通过环境变量初始化；替换下列示例中参数，安全认证Access Key替换your_iam_ak，Secret Key替换your_iam_sk
setEnvVariable('QIANFAN_ACCESS_KEY','your_iam_ak');
setEnvVariable('QIANFAN_SECRET_KEY','your_iam_sk');

async function main() {
  //base_api_route:调用本文API，该参数值为固定值，无需修改；对应API调用文档-请求结构-请求地址的后缀
  //action:调用本文API，该参数值为固定值，无需修改；对应API调用文档-请求参数-Query参数的Action 
  //data:请查看本文请求参数说明，根据实际使用选择参数；对应API调用文档-请求参数-Body参数
  const res = await consoleAction({base_api_route: '/v2/model', action: 'DescribeSystemModelSet', data: {
         "modelSetName":"ERNIE Lite"
  });    
    
  console.log(res);
}

main();

返回示例

{
    "requestId": "dd0a6526-13ba-41bf-9d5b-67bdbebab228",
    "result": {
        "modelSetId": "am-juxxxxu9",
        "modelSetName": "ERNIE Lite",
        "modelType": "Text2Text",
        "createTime": "2023-06-15T14:46:33+08:00",
        "modifyTime": "2025-08-22T14:05:04+08:00",
        "description": "百度自研的轻量级大语言模型，兼顾优异的模型效果与推理性能，适合低算力AI加速卡推理使用。",
        "modelIds": [
            "amv-irxxxx6r",
            "amv-k8xxxx0r",
            "amv-b9xxxxvn"
        ],
        "modelNames": [
            "ERNIE-Lite-8K-0308",
            "ERNIE-Lite-128K-0419",
            "ERNIE-Lite-128K-0722"
        ]
    }
}

{
    "requestId": "dd0a6526-13ba-41bf-9d5b-67bdbebab228",
    "result": {
        "modelSetId": "am-juxxxxu9",
        "modelSetName": "ERNIE Lite",
        "modelType": "Text2Text",
        "createTime": "2023-06-15T14:46:33+08:00",
        "modifyTime": "2025-08-22T14:05:04+08:00",
        "description": "百度自研的轻量级大语言模型，兼顾优异的模型效果与推理性能，适合低算力AI加速卡推理使用。",
        "modelIds": [
            "amv-irxxxx6r",
            "amv-k8xxxx0r",
            "amv-b9xxxxvn"
        ],
        "modelNames": [
            "ERNIE-Lite-8K-0308",
            "ERNIE-Lite-128K-0419",
            "ERNIE-Lite-128K-0722"
        ]
    }
}

{
    "requestId": "dd0a6526-13ba-41bf-9d5b-67bdbebab228",
    "result": {
        "modelSetId": "am-juxxxxu9",
        "modelSetName": "ERNIE Lite",
        "modelType": "Text2Text",
        "createTime": "2023-06-15T14:46:33+08:00",
        "modifyTime": "2025-08-22T14:05:04+08:00",
        "description": "百度自研的轻量级大语言模型，兼顾优异的模型效果与推理性能，适合低算力AI加速卡推理使用。",
        "modelIds": [
            "amv-irxxxx6r",
            "amv-k8xxxx0r",
            "amv-b9xxxxvn"
        ],
        "modelNames": [
            "ERNIE-Lite-8K-0308",
            "ERNIE-Lite-128K-0419",
            "ERNIE-Lite-128K-0722"
        ]
    }
}

{
    requestId: dd0a6526-13ba-41bf-9d5b-67bdbebab228,
    result: {
        modelSetId: 'am-juxxxxu9',
        modelSetName: 'ERNIE Lite',
        modelType: 'Text2Text',
        createTime: '2023-06-15T14:46:33+08:00',
        modifyTime: '2025-08-22T14:05:04+08:00',
        description: '百度自研的轻量级大语言模型，兼顾优异的模型效果与推理性能，适合低算力AI加速卡推理使用。',
        modelIds: [
            'amv-irxxxx6r',
            'amv-k8xxxx0r',
            'amv-b9xxxxvn'
        ],
        modelNames: [
            'ERNIE-Lite-8K-0308',
            'ERNIE-Lite-128K-0419',
            'ERNIE-Lite-128K-0722'
        ]
    }
}

请求参数

名称	类型	必填	描述
modelSetName	string	否	模型名称，该字段与modelSetId不能同时使用，至少选择其中一个
modelSetId	string	否	模型id，说明：（1）该字段与modelSetName不能同时使用，至少选择其中一个（2）通过以下式获取该字段值：调用获取预置模型列表接口，返回的modelSetId字段获取

返回参数

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

result说明

名称	类型	描述
modelSetId	string	模型id，字符串类型
modelSetName	string	模型名称
modelType	string	模型类型
createTime	string	创建时间
modifyTime	string	修改时间
description	string	模型描述
modelIds	List<string>	模型拥有的模型id列表
modelNames	List<string>	模型拥有的模型版本号列表

获取预置模型列表

获取预置模型版本详情