获取预置模型详情
更新时间:2026-04-03
POST
https://qianfan.baidubce.com/v2/model?Action=DescribeSystemModelSet
本接口用于获取预置模型详情。
鉴权说明
调用本文API,使用“基于安全认证AK/SK”进行签名计算鉴权,即使用安全认证中的Access Key ID 和 Secret Access Key进行鉴权,具体鉴权认证机制参考HTTP调用鉴权说明。
请求参数
Headers 参数
除公共头域外,无其它特殊头域
Query 参数
Action
string
方法名称,固定值DescribeSystemModelSet
必选
Body 参数
modelSetName
string
模型名称,该字段与modelSetId不能同时使用,至少选择其中一个
可选
modelSetId
string
模型id,说明:
(1)该字段与modelSetName不能同时使用,至少选择其中一个
(2) 通过以下式获取该字段值:
调用获取预置模型列表接口,返回的modelSetId字段获取
可选
请求结构
POST /v2/model?Action=DescribeSystemModelSet HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: authorization string
Content-Type: application/json
{
"modelSetName": "ERNIE Lite"
}
示例代码
请求示例
curl -i --location 'https://qianfan.baidubce.com/v2/model?Action=DescribeSystemModelSet'\
--header 'Authorization: bce-auth-v1/f0ee7axxxx/2023-09-19T13:42:13Z/180000/host;x-bce-date/9a8cfb8ee58a8f44a21a5xxxx74525543'\
--header 'x-bce-date: 2023-09-19T13:37:10Z'\
--header 'Content-Type: application/json'\
--data '{
"modelSetName": "ERNIE Lite"
}'
返回响应
Headers 参数
除公共头域外,无其它特殊头域
返回参数
requestId
string
请求ID
可选
result
object {8}
可选
显示子属性
隐藏子属性
modelSetId
string
模型ID,字符串类型
可选
modelSetName
string
模型名称
可选
modelType
string
模型类型
可选
createTime
string
创建时间
可选
modifyTime
string
修改时间
可选
description
string
模型描述
可选
modelIds
array
模型拥有的模型ID列表
可选
显示子属性
隐藏子属性
items
string
modelNames
array
模型拥有的模型版本号列表
可选
显示子属性
隐藏子属性
items
string
成功示例
{
"requestId": "307ce086-f5b7-46e0-910b-806a4499e75a",
"result": {
"modelSetId": "am-ju3hi4ts39u9",
"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-irrrsmxabb6r",
"amv-k8npfy0yz90r",
"amv-b97au559tvvn"
],
"modelNames": [
"ERNIE-Lite-8K-0308",
"ERNIE-Lite-128K-0419",
"ERNIE-Lite-128K-0722"
]
}
}
错误码
若请求错误,服务器将返回的JSON文本包含以下参数:
| 名称 | 描述 |
|---|---|
requestId |
请求ID |
code |
错误码 |
message |
错误描述信息,帮助理解和解决发生的错误 |
例如错误返回:
text
{
"requestId":"6ba7b810-xxxc04fd430c8",
"code":"AccessDenied",
"message":"Access denied."
}
更多其他错误码,也可以查看错误码说明。
评价此篇文章
