获取预置模型列表
更新时间:2024-03-20
功能介绍
本接口用于用于查看预置模型列表。
注意事项
- 调用本文API,使用“安全认证/Access Key ”中的Access Key ID 和 Secret Access Key等进行鉴权,无法使用获取Access Token的方式鉴权,具体鉴权认证机制参考鉴权认证机制。
请求说明
基本信息
请求地址: https://qianfan.baidubce.com/wenxinworkshop/modelrepo/model/preset/list
请求方式: POST
Header参数
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
Content-Type | string | 是 | 固定值:application/json |
x-bce-date | string | 否 | 当前时间,遵循ISO8601规范,格式如2016-04-06T08:23:49Z |
Authorization | string | 是 | 用于验证请求合法性的认证信息,更多内容请参考鉴权认证机制,签名工具可参考IAM签名工具 |
Body参数
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
nameFilter | string | 否 | 名称过滤器 |
modelType | int[] | 否 | 模型类型,可选值如下: · 0:文本生成 · 1:图像生成 · 4:向量表示模型 · 5:图像理解模型 · 6:行业大模型 |
languageSupport | string[] | 否 | 语言支持,可选值如下: · 中文 · 英文 · 小语种 |
modelVersionVendor | string[] | 否 | 模型版本厂商,通过以下方法获取该字段值: 在千帆控制台-模型广场页面,查看厂商,例如百度,如下图所示: |
ctxLength | string[] | 否 | 上下文长度,可选值如下: · <4k · 4k-16k · >16k |
expansion | string[] | 否 | 模型扩展能力,通过以下方法获取该字段值: 在千帆控制台-模型广场页面,查看模型扩展能力,例如人设增强,如下图所示: |
orderBy | string | 否 | 排序,可选值: · modifyTime:按更新时间(新-旧) · modelName:按模型名称(A-Z) · default:综合排序 |
pageNo | int | 是 | 页码,最小值为1 |
pageSize | int | 是 | 每页大小,必须大于0 |
响应说明
名称 | 类型 | 描述 |
---|---|---|
log_id | int | 请求ID |
result | object | 请求结果 |
result 说明
名称 | 类型 | 描述 |
---|---|---|
total | int | 数据条数 |
items | object[] | 分页数据 |
items 说明
名称 | 类型 | 描述 |
---|---|---|
modelId | int | 模型数字ID,注意:该字段后续可能废弃,如需使用模型ID,请使用modelIdStr |
modelIdStr | string | 模型字符串ID |
modelName | string | 模型名称 |
modelType | int | 模型类型 |
description | string | 描述 |
versionCount | int | 版本数量 |
modifyTime | time | 最后修改时间 |
isStarModel | bool | 是否为星标模型 |
isNewest | bool | 是否为最新的 |
versionSummaries | PresetAIModelVersionItem[] | 模型版本列表 |
PresetAIModelVersionItem 说明
名称 | 类型 | 描述 |
---|---|---|
versionId | int | 版本ID,int类型 |
versionIdStr | string | 版本ID,string类型 |
version | string | 版本 |
algorithm | string | 算法 |
framework | string | 框架 |
apiDocLink | string | 模型版本API文档链接 |
presetService | string | 预置模型版本对应的预置服务名称 |
supportOptions | string[] | 支持的操作选项,说明: · Deploy:部署 · Evaluation:评估 · Acceleration:加速 · APIDoc:文档跳转 · OnlineTest:在线测试 · Export:模型导出 · FineTuning:模型微调 |
示例
请求示例
# 替换下列示例中的Authorization、x-bce-date
curl 'https://qianfan.baidubce.com/wenxinworkshop/modelrepo/model/preset/list' \
--header 'Authorization: bce-auth-v1/f0ee7axxxx/2023-09-19T13:42:13Z/180000/host;x-bce-date/9a8cfb8ee58a8f44a21a52640015de61bc55ca2e6d8cc23d080016e374525543' \
--header 'x-bce-date: 2023-09-19T13:37:10Z' \
--header 'Content-Type: application/json' \
--data '{
"pageNo": 1,
"pageSize": 2,
"modelType": [
0,
1
],
"modelVersionVendor": [
"百度"
"Meta",
"智谱AI"
]
}'
响应示例
{
"log_id": "2873535885",
"result": {
"total": 5,
"items": [
{
"modelId": 385,
"modelIdStr":"am-gn7tsua99zbf",
"modelName": "ERNIE-Bot 4.0",
"modelType": 0,
"description": "百度最新发布的自研⼤语⾔模型,实现了基础模型的全面升级,在理解、生成、逻辑和记忆能力上都有着显著提升。",
"versionCount": 1,
"modifyTime": "2023-11-07T15:25:51+08:00",
"isStarModel": true,
"isNewest": false,
"versionSummaries": [
{
"versionId": 539,
"versionIdStr": "amv-1h46ebugstv3",
"version": "ERNIE-Bot 4.0",
"algorithm": "-",
"framework": "paddle",
"apiDocLink": "https://cloud.baidu.com/doc/WENXINWORKSHOP/s/clntwmv7t",
"presetService": "ERNIE-Bot 4.0",
"supportOptions": [
"APIDoc",
"OnlineTest"
]
}
]
},
{
"modelId": 413,
"modelIdStr":"am-gh0azfeb9adu",
"modelName": "ERNIE-xxx",
"modelType": 0,
"description": "百度⾃⾏研发的⼤语⾔模型,覆盖海量中⽂数据,具有更强的对话问答、内容创作⽣成等能⼒。",
"versionCount": 1,
"modifyTime": "2023-11-21T17:28:11+08:00",
"isStarModel": false,
"isNewest": false,
"versionSummaries": [
{
"versionId": 577,
"versionIdStr": "amv-7q01a2teqtic",
"version": "ERNIE-xxx",
"algorithm": "",
"framework": "paddle",
"apiDocLink": "https://cloud.baidu.com/doc/WENXINWORKSHOP/s/6lp69is2a",
"presetService": "ERNIE-xxx,
"supportOptions": [
"APIDoc",
"OnlineTest"
]
}
]
}
]
}
}
错误码
若请求错误,服务器将返回的JSON文本包含以下参数:
名称 | 描述 |
---|---|
error_code | 错误码 |
error_msg | 错误描述信息,帮助理解和解决发生的错误 |
例如参数错误返回:
{
"error_code": 500001,
"error_msg": "param invalid"
}
更多千帆大模型平台其他错误码,也可以查看错误码说明。