本文介绍自学习(viapi-regen)类目下的训练任务列表ListTrainTasks的语法及示例。
功能描述
通过生产空间ID查看此空间下训练任务详细数据。
- 您可以进入在线咨询获取在线人工帮助。
- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等,请通过钉钉群(23109592)加入阿里云视觉智能开放平台咨询群联系我们。
接入指引
1. 注册阿里云账号:打开阿里云官网,在阿里云官网右上角,单击立即注册,按照操作提示完成账号注册。
2. 开通能力:请确保您已开通自学习服务,若未开通服务请立即开通。
3. 创建AccessKey:请确保您已创建AccessKey,如果您使用的是子账号AccessKey,您需要给子账号赋予AliyunVIAPIFullAccess权限,具体操作,请参见RAM授权。
4. 在线调试(可选):您可以通过OpenAPI Explorer在线调试能力,查看完整的调用示例代码及SDK依赖信息,也可以下载完整的工程。
5. 开发接入步骤:
- 在SDK总览中选择您要接入使用的SDK语言。
- 在对应语言的SDK文档中找到AI类目为自学习(viapi-regen)类目的SDK包进行安装。
- 参考文档中提供的示例代码进行适当修改后调用。
6. 客户端直接调用:该能力常用的客户端调用方式包括以下几种。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ListTrainTasks | 系统规定参数。取值:ListTrainTasks。 |
CurrentPage | Long | 否 | 1 | 当前页数。 |
PageSize | Long | 否 | 10 | 每页数据显示条数。 |
Status | String | 否 | PREPARING | 训练任务状态。
|
WorkspaceId | Long | 是 | 63 | 生产空间ID。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | F8B71CDB-5DE9-0ACB-8D0F-FCEFBFF6B473 | 每个请求分配唯一的服务器请求ID。 |
Data | Object | 出参数据实体。 |
|
CurrentPage | Long | 1 | 当前页数。 |
PageSize | Long | 10 | 每页数据显示条数。 |
TotalPage | Long | 1 | 总页数。 |
TotalCount | Long | 2 | 总数据量。 |
Elements | Array of Object | 标注中的数据值。 |
Elements字段参数说明
字段 |
类型 |
是否必须 |
示例值 |
描述 |
---|---|---|---|---|
labelId |
Long |
否 |
228 |
标注ID。 |
modelId |
Long |
否 |
229 |
模型ID。 |
trainStatus |
String |
否 |
TRAIN_SUCCESS |
训练状态。取值如下:INIT:未训练;PREPARING:准备中;TRAINING:训练中;TRAIN_SUCCESS:训练成功;TRAIN_FAIL:训练失败。 |
datasetName |
String |
否 |
test1 |
数据集名称。 |
datasetId |
Long |
否 |
120 |
数据集ID。 |
description |
String |
否 |
test3描述 |
训练任务描述。 |
taskName |
String |
否 |
test3 |
训练任务名称。 |
id |
Long |
否 |
68 |
服务ID。 |
gmtCreate |
Long |
否 |
1634111691000 |
创建时间。 |
labelName |
String |
否 |
test3 |
标注名称。 |
modelEffect |
String |
否 |
[{"id":"TOP1_ACC","name":"top1准确率", "value":100.0}, "id":"TOP5_ACC","name":"top5准确率","value":100.0}] |
模型效果。 |
trainMode |
String |
否 |
COMMON |
训练模型。取值如下 :COMMON:均衡;HIGH_ACC:高精度;HIGH_PERF:高性能。 |
advancedParameters |
String |
否 |
{\"TestLabelId\":1266,\"TestDatasetId\":948,\"Lr\":0.5,\"width\":\"32\",\"ValidationLabelId\":1266,\"Epoch\":23,\"ValidationDatasetId\":948,\"height\":\"23\"} |
Epoch(学习轮数)、Lr(学习率)、height(图片高)、width(图片宽)、ValidationDatasetId(验证数据集)、IDValidationLabelId(验证标注集ID)、TestDatasetId(测试数据集ID)、TestLabelId(测试标注集ID) |
serviceId |
Long |
否 |
443 |
服务ID。 |
trainUseTime |
Long |
否 |
1260898 |
训练耗时。 |
failureReason |
String |
否 |
失败原因 |
训练失败原因。 |
PreTrainTaskId |
Long |
否 |
213 |
基于之前的训练任务ID。 |
PreTrainTaskName |
String |
否 |
任务213 |
基于之前的训练任务名称。 |
PreTrainTaskFlag |
Boolean |
否 |
true |
是否基于之前的训练任务开关。 |
SDK参考
阿里云视觉AI自学习类目下的训练任务列表能力推荐使用SDK调用,支持多种编程语言,调用时请选择AI类目为自学习(viapi-regen)的SDK包,文件参数通过SDK调用可支持本地文件及任意URL,具体可参见SDK总览。
示例
请求示例
http(s)://viapi-regen.cn-shanghai.aliyuncs.com/?Action=ListTrainTasks //更多关于访问域名(Endpoint)信息,请参见:https://help.aliyun.com/document_detail/143103.html
&CurrentPage=1
&PageSize=10
&Status=PREPARING
&WorkspaceId=63
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<ListTrainTasksResponse>
<RequestId>F8B71CDB-5DE9-0ACB-8D0F-FCEFBFF6B473</RequestId>
<Data>
<CurrentPage>1</CurrentPage>
<PageSize>10</PageSize>
<TotalPage>1</TotalPage>
<TotalCount>2</TotalCount>
<Elements>
<labelId>228</labelId>
<modelId>29</modelId>
<trainStatus>TRAIN_SUCCESS</trainStatus>
<datasetName>test1</datasetName>
<datasetId>120</datasetId>
<description>test3描述</description>
<taskName>test3</taskName>
<id>68</id>
<gmtCreate>1634111691000</gmtCreate>
<labelName>test3</labelName>
<modelEffect>[{"id": "TOP1_ACC", "name": "top1准确率", "value": 100.0}, {"id": "TOP5_ACC", "name": "top5准确率", "value": 100.0}]</modelEffect>
<trainMode>COMMON</trainMode>
</Elements>
<Elements>
<modelId>14</modelId>
<trainStatus>TRAIN_SUCCESS</trainStatus>
<datasetName>test1</datasetName>
<description>test1</description>
<gmtCreate>1631762402000</gmtCreate>
<modelEffect>[{"id": "TOP1_ACC", "name": "top1准确率", "value": 100.0}, {"id": "TOP5_ACC", "name": "top5准确率", "value": 100.0}]</modelEffect>
<trainMode>COMMON</trainMode>
<labelId>188</labelId>
<datasetId>120</datasetId>
<taskName>test1</taskName>
<id>43</id>
<labelName>test2</labelName>
<serviceId>21</serviceId>
</Elements>
</Data>
</ListTrainTasksResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "F8B71CDB-5DE9-0ACB-8D0F-FCEFBFF6B473",
"Data" : {
"CurrentPage" : 1,
"PageSize" : 10,
"TotalPage" : 1,
"TotalCount" : 2,
"Elements" : [ {
"labelId" : 228,
"modelId" : 29,
"trainStatus" : "TRAIN_SUCCESS",
"datasetName" : "test1",
"datasetId" : 120,
"description" : "test3描述",
"taskName" : "test3",
"id" : 68,
"gmtCreate" : 1634111691000,
"labelName" : "test3",
"modelEffect" : "[{\"id\": \"TOP1_ACC\", \"name\": \"top1准确率\", \"value\": 100.0}, {\"id\": \"TOP5_ACC\", \"name\": \"top5准确率\", \"value\": 100.0}]",
"trainMode" : "COMMON"
}, {
"modelId" : 14,
"trainStatus" : "TRAIN_SUCCESS",
"datasetName" : "test1",
"description" : "test1",
"gmtCreate" : 1631762402000,
"modelEffect" : "[{\"id\": \"TOP1_ACC\", \"name\": \"top1准确率\", \"value\": 100.0}, {\"id\": \"TOP5_ACC\", \"name\": \"top5准确率\", \"value\": 100.0}]",
"trainMode" : "COMMON",
"labelId" : 188,
"datasetId" : 120,
"taskName" : "test1",
"id" : 43,
"labelName" : "test2",
"serviceId" : 21
} ]
}
}
错误码
关于训练任务列表的错误码,详情请参见常见错误码。
安全声明
- 请确保上传的图片或文件来源符合相应的法律法规。
- 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。