获取预置模型列表
更新时间：2026-04-03
POST
https://qianfan.baidubce.com/v2/model?Action=DescribeSystemModelSets
本接口用于获取预置模型列表。
鉴权说明
调用本文API，使用"基于安全认证AK/SK"进行签名计算鉴权，即使用安全认证中的Access Key ID 和 Secret Access Key进行鉴权，具体鉴权认证机制参考HTTP调用鉴权说明。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Query 参数
Action
string
方法名称，固定值DescribeSystemModelSets
必选
Body 参数
marker
string
本次查询的起始位置，默认从第一条数据开始
可选
maxKeys
integer
（1）默认值是10
（2）返回的列表长度最大为100，如果指定的值大于100，按100操作。
可选
pageReverse
boolean
是否倒序，默认为false。默认值: false
可选
请求结构
POST /v2/model?Action=DescribeSystemModelSets HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: authorization string
Content-Type: application/json
{
"marker": "am-n50xxx"
}示例代码
请求示例
curl -i --location 'https://qianfan.baidubce.com/v2/model?Action=DescribeSystemModelSets' \
--header 'Authorization: bce-auth-v1/f0ee7axxxx/2023-09-19T13:42:13Z/180000/host;x-bce-date/9a8cfb8ee58a8f44xxxxxxxxxxx6d8c543' \
--header 'x-bce-date: 2023-09-19T13:37:10Z' \
--header 'Content-Type: application/json' \
--data '{
"marker":"am-n50985crhqq3"
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
requestId
string
请求ID
可选
code
string
错误码，接口报错时返回，HTTP状态码≥400
可选
message
string
错误信息，接口报错时返回，HTTP状态码≥400
可选
result
object {2}
可选
显示子属性
隐藏子属性
systemModelSetList
array
模型信息列表
可选
显示子属性
隐藏子属性
items
object {8}
显示子属性
隐藏子属性
modelSetId
string
模型ID
可选
modelSetName
string
模型名称
可选
modelType
string
模型类型
可选
description
string
模型描述
可选
modelCount
integer
版本数量
可选
modelIds
array
属于当前模型的模型版本ID列表
可选
显示子属性
隐藏子属性
items
string
modifyTime
string
修改时间
可选
modelNames
array
模型拥有的模型版本号列表
可选
显示子属性
隐藏子属性
items
string
pageInfo
object {4}
分页信息
可选
显示子属性
隐藏子属性
marker
string
本次查询的起始位置
可选
maxKeys
integer
请求返回的最大数目
可选
isTruncated
boolean
是否只返回了部分数据，说明：
· false：表示本次已经返回所有结果
· true：表示本次未返回所有结果
可选
nextMarker
string
当isTruncated为true时，才返回此项，作为下次查询marker的值
可选
JSON
{
"requestId":"1bef3f87-c5b2-4419-936b-50f9884f10d4",
"result": {
"systemModelSetList": [
{
"modelSetId": "am-j05zi5ebfqf1",
"modelSetName": "bce-reranker-base",
"modelType": "",
"description": "由网易有道开发的跨语种语义表征算法模型，擅长优化语义搜索结果和语义相关顺序精排，支持中英日韩四门语言，覆盖常见业务领域，支持长package rerank(512~32k)。[了解更多\u003e](https://huggingface.co/maidalun1020/bce-reranker-base_v1)",
"modelCount": 1,
"modifyTime": "2024-03-22T17:13:33+08:00",
"modelIds":[
"amv-4u0rw8juur1p"
],
"modelNames": [
"bce-reranker-base_v1"
]
}
],
"pageInfo":{
"marker":"am-n50985crhqq3",
"maxKeys":1,
"isTruncated":false
}
}
}错误码
若请求错误，服务器将返回的JSON文本包含以下参数：
| 名称 | 描述 |
|---|---|
requestId |
请求ID |
code |
错误码 |
message |
错误描述信息，帮助理解和解决发生的错误 |
例如错误返回：
text
{
"requestId":"6ba7b810-xxxc04fd430c8",
"code":"AccessDenied",
"message":"Access denied."
}
更多其他错误码，也可以查看错误码说明。
评价此篇文章