获取预置模型版本详情
更新时间：2026-04-03
POST
https://qianfan.baidubce.com/v2/model?Action=DescribeSystemModel
本接口用于获取预置模型版本详情。
鉴权说明
调用本文API，使用"基于安全认证AK/SK"进行签名计算鉴权，即使用安全认证中的Access Key ID 和 Secret Access Key进行鉴权，具体鉴权认证机制参考HTTP调用鉴权说明。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Query 参数
Action
string
方法名称，固定值DescribeSystemModel
必选
Body 参数
请求结构
POST /v2/model?Action=DescribeSystemModel HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: authorization string
Content-Type: application/json
{
"modelId": "amv-jkxxxxx75x5j"
}示例代码
请求示例
curl -i --location 'https://qianfan.baidubce.com/v2/model?Action=DescribeSystemModel'\
--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 '{
"modelId": "amv-jkxxxxx75x5j"
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
requestId
string
请求ID
可选
result
object {14}
可选
显示子属性
隐藏子属性
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 {2}
输入输出长度限制
可选
显示子属性
隐藏子属性
trivial
object {3}
modelApplicationType非reranker类型的模型上下文限制
可选
显示子属性
隐藏子属性
inputTokens
integer
输入tokens限制
可选
outputTokens
integer
输出tokens限制
可选
characterLimit
integer
字符数限制
可选
reranker
object {4}
modelApplicationType为reranker类型的模型上下文限制
可选
显示子属性
隐藏子属性
queryTokens
integer
query的tokens限制
可选
queryCharacterLimit
integer
query的字符数限制
可选
documentTokens
integer
document的tokens限制
可选
documentCharacterLimit
integer
document的字符数限制
可选
isSupportDeploy
boolean
是否支持部署
可选
isSupportModelComp
boolean
是否支持压缩
可选
isSupportEvaluation
boolean
是否支持评估
可选
capabilities
array
模型支持的能力：
· reasoning：支持推理思考能力
· function_call：支持工具调用能力
· web_search：支持联网检索增强
可选
显示子属性
隐藏子属性
items
string
成功示例
{
"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,
"capabilities": [
"reasoning",
"function_call"
],
"modelProviders": [
"百度"
]
}
}错误码
若请求错误，服务器将返回的JSON文本包含以下参数：
| 名称 | 描述 |
|---|---|
requestId |
请求ID |
code |
错误码 |
message |
错误描述信息，帮助理解和解决发生的错误 |
例如错误返回：
text
{
"requestId":"6ba7b810-xxxc04fd430c8",
"code":"AccessDenied",
"message":"Access denied."
}
更多其他错误码，也可以查看错误码说明。
评价此篇文章