资讯 文档
技术能力
语音技术
文字识别
人脸与人体
图像技术
语言与知识
视频技术

查看模型评估结果导出任务详情

接口描述

本接口用于获取模型评估导出任务详情,包括导出任务ID、评估任务ID和导出类型等。

权限说明

调用本文API,需符合以下权限要求,权限介绍及分配,请查看角色与权限控制列表账号创建与权限分配。需具有以下任一权限:

  • 完全控制千帆大模型平台的权限:QianfanFullControlAccessPolicy
  • 只读访问千帆大模型平台的权限:QianfanReadAccessPolicy
  • 完全控制千帆大模型平台模型调优的权限:QianfanModelTuningFullControlAccessPolicy
  • 只读访问千帆大模型平台模型调优的权限:QianfanModelTuningReadAccessPolicy

鉴权说明

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

请求结构

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

{
    "taskId":"amemt-gmqxxxxxcm"
}

请求头域

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

请求参数

  • Query参数
名称 类型 必填 描述
Action string 方法名称,固定值DescribeEvalResultExportTask
  • Body参数
名称 类型 必填 描述
taskId string 导出任务ID,通过调用发起模型评估结果导出任务接口,返回的字段taskId获取

响应头域

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

响应参数

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

result说明

名称 类型 描述
taskId string 导出任务字符串id
evalId string 评估任务ID
exportContent string[] 导出内容,可选值如下:
· prompt:prompt
· prediction:预测结果
· completion:预期回答
· metrics:评估指标
· system:人设字段
state string 导出任务状态,用户只需检查任务是否Fail/Done:
· Queued:任务待执行
· Running:进行中
· Failed:导出失败
· Succeeded:导出成功
storageType string 导出类型,说明:
(1)仅针对模型评估,用于存储评估过程中产生的推理结果集
(2)可选值如下:
· BOS:对象存储BOS
· sysStorage:平台共享存储
storagePath string 当导出类型为对象存储BOS,即storageType=BOS时,对应路径为完整存储路径
downloadUrl string 下载链接,导出到系统bos时返回

请求示例

# 替换下列示例中的Authorization值
curl -i --location 'https://qianfan.baidubce.com/v2/eval?Action=DescribeEvalResultExportTask' \
--header 'Authorization: bce-auth-v1/f0ee7axxxx/2023-09-19T13:42:13Z/180000/host;x-bce-date/9a8cfb8ee58axxxxxxx4525543' \
--header 'Content-Type: application/json' \
--data '{
    "taskId":"amemt-gmqxxxxxcm"
}' 

响应示例

{
    "requestId": "a65523c0-c329-4694-9809-922007558dce",
    "result": {
        "taskId": "amemt-qsrx****mt47",
        "evalId": "ame-xvbi****r1dr",
        "state": "Succeeded",
        "exportContent": "prompt,prediction,completion,metrics",
        "storageType": "sysStorage",
        "downloadUrl": "https://aipe-dragonboat.bj.bcebos.com/****"
    }
}

错误码

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

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

例如错误返回:

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

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

上一篇
发起模型评估结果导出任务
下一篇
模型评估V1