查看可评估模型列表

更新时间：2025-09-03

接口描述

本接口用于查看待评估对象列表接口、模型版本等评估对象列表查询需求。

鉴权说明

调用本文API，使用“基于安全认证AK/SK”进行签名计算鉴权，即使用安全认证中的Access Key ID和Secret Access Key进行鉴权，具体鉴权认证机制参考HTTP调用鉴权说明。

请求结构

Bash

POST /v2/eval?Action=DescribeEvalObjects HTTP/1.1
Host: qianfan.baidubce.com
Authorization: authorization string
Content-Type: application/json

{
    "objectType": "userModel",
}

请求头域

除公共头域外，无其它特殊头域。

请求参数

Query参数

名称	类型	必填	描述
Action	string	是	方法名称，固定值DescribeEvalObjects

Body参数

名称	类型	必填	描述
objectType	string	是	评估对象类型，可选值如下： · systemModel：预置模型 · customModel：用户模型
marker	string	否	本次查询的起始位置，默认从第一条数据开始
maxKeys	int	否	返回的列表长度最大为100，默认值是10，如果指定的值大于100，按100操作
pageReverse	bool	否	是否倒序，默认为false

响应头域

除公共头域外，无其它特殊头域。

响应参数

名称	类型	描述
requestId	string	请求ID，直接使用APIGateWay生成的请求ID，用于定位问题
code	string	错误码，接口报错时返回，HTTP状态码>=400
message	string	错误信息，接口报错时返回，HTTP状态码>=400
result	object	请求结果，接口请求成功时返回，HTTP状态码=200

result说明

名称	类型	描述
evalObjectList	List<object>	评估对象列表
pageInfo	object	分页信息

pageInfo说明

名称	类型	描述
marker	string	本次查询的起始位置
maxKeys	int	请求返回的最大数目
isTruncated	bool	指明是否只返回了部分数据，说明： · false：表示本次已经返回所有结果 · true：表示本次返回部分结果
nextMarker	string	当isTruncated为true时，该字段有效，作为下次查询marker的值

evalTaskList说明

名称	类型	描述
objectId	string	评估对象ID
objectName	string	评估对象名称
objectVersion	string	对象版本信息
objectType	string	评估对象类型，具体值如下： · presetModel · userModel
createTime	string	创建时间

请求示例

bash

# 替换下列示例中的Authorization值、x-bce-date值
curl -i --location 'https://qianfan.baidubce.com/v2/eval?Action=DescribeEvalObjects'\
--header 'Authorization: bce-auth-v1/047axxxxxxac/2024-09-20T02:31:36Z/1800/host;x-bce-date/badcdfxxxxxxxxxd7d11ef'\ 
--header 'Content-Type: application/json'\ 
--data '{
    "objectType": "userModel",
}'

响应示例

JSON

{
	"requestId": "55244c61-3b25-40be-af34-ee6c4675e965",
	"result": {
		"evalObjectList": [],
		"pageInfo": {
			"marker": "",
			"maxKeys": 100,
			"isTruncated": false
		}
	}
}

错误码

若请求错误，服务器将返回的JSON文本包含以下参数：

名称	描述
requestId	请求ID
code	错误码
message	错误描述信息，帮助理解和解决发生的错误

例如错误返回：

{
    "requestId":"6ba7b810-xxxc04fd430c8",
    "code":"AccessDenied",
    "message":"Access denied."
}

更多其他错误码，也可以查看错误码说明。