本文介绍自学习(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

训练任务状态。

  • INIT:未训练
  • PREPARING:准备中
  • TRAINING:训练中
  • TRAIN_SUCCESS:训练成功
  • TRAIN_FAIL:训练失败
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小时后会被系统自动清理删除。