获取模型精调任务列表
更新时间:2024-04-07
功能介绍
用于获取模型精调任务列表。
注意事项
调用本文API,需使用安全认证AK/SK鉴权,调用流程及鉴权介绍详见SDK安装及使用流程。
调用示例
import os
from qianfan import resources
# 使用安全认证AK/SK鉴权,通过环境变量方式初始化;替换下列示例中参数,安全认证Access Key替换your_iam_ak,Secret Key替换your_iam_sk
os.environ["QIANFAN_ACCESS_KEY"] = "your_iam_ak"
os.environ["QIANFAN_SECRET_KEY"] = "your_iam_sk"
# 将示例中的job_id替换为实际使用值
list_task_resp = resources.FineTune.V2.task_list(job_id="job-6ucxxxx8q0")
print(list_task_resp.body)
返回示例
QfResponse(code = 200, headers = {
...
},
body = {
'requestId': 'be893522-7b63-4795-b449-2cxxx4bc1',
'result':
{
'pageInfo':
{
'isTruncated': False, 'marker': '',
'maxKeys': 100
},
'taskList': [
{
'createTime': '2024-02-29T08:29:17Z',
'finishTime': '0000-00-00T00:00:00Z',
'jobDescription': 'ebspxxxasks',
'jobId': 'job-6ucxxx8q0',
'jobName': 'job1',
'model': 'ERNIE-Speed',
'parameterScale': 'FullFineTuning',
'runStatus': 'Running',
'taskId': 'task-2jsxxxi9a',
'trainMode': 'SFT'
}]
}
}
)
参数说明
请求参数
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
job_id | string | 是 | 作业ID,说明: (1)该参数只支持Post-pretrain、SFT 下的训练任务 (2)可以通过以下方式获取该参数值,以SFT为例,在千帆控制台-模型精调页面,查看ID,如下图所示: |
max_keys | string | 否 | 本次查询的起始位置,默认从第一条数据开始 |
maxKeys | int | 否 | 说明: (1)默认值是10 (2)返回的列表长度最大为100 (3)如果指定的值大于100,按100操作 |
page_reverse | bool | 否 | 是否倒序,默认为false |
返回参数
名称 | 类型 | 描述 |
---|---|---|
requestId | string | 请求ID |
result | object | 请求结果 |
result说明
名称 | 类型 | 描述 |
---|---|---|
taskList | List<task> | 任务列表 |
pageInfo | object | 分页信息 |
task说明
名称 | 类型 | 描述 |
---|---|---|
taskId | string | 任务ID |
jobId | string | 作业ID |
jobName | string | 作业名称 |
jobDescription | string | 作业描述 |
model | string | 基础模型版本 |
trainMode | string | 调优的训练模式 |
parameterScale | string | 调优的参数规模 |
runStatus | string | 任务运行状态,说明: · Running:运行中 · Done:运行完成 · Stopped:运行中止 · Failed:运行失败 |
metrics | object | 评估指标,运行完成才会返回,目前只支持文本生成类型 |
checkpointList | List<checkpointItem> | checkpoint信息 |
createTime | string | 任务创建时间 |
finishTime | string | 任务结束时间 |
metrics说明
名称 | 类型 | 描述 |
---|---|---|
BLEU-4 | string | 评估指标BLEU-4 |
ROUGE-1 | string | 评估指标ROUGE-1 |
ROUGE-2 | string | 评估指标ROUGE-2 |
ROUGE-L | string | 评估指标ROUGE-L |
checkpointItem说明
名称 | 类型 | 描述 |
---|---|---|
step | int | step |
perplexity | float | perplexity |
trainingLoss | float | trainingLoss |
pageInfo说明
名称 | 类型 | 描述 |
---|---|---|
marker | string | 本次查询的起始位置 |
maxKeys | int | 请求返回的最大数目 |
isTruncated | bool | 是否只返回了部分数据,说明: · false:表示本次已经返回所有结果 · true:表示本次还没有返回所有结果 |
nextMarker | string | 当isTruncated为true时,返回此参数,作为下次查询marker的值 |