本文介绍自学习（viapi-regen）类目下的创建训练任务CreateTrainTask的语法及示例。

功能描述

通过生产空间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 是 CreateTrainTask

系统规定参数。取值：CreateTrainTask。
WorkspaceId Long 是 63

工作空间ID。
Name String 是 test3

新建训练任务名称。
DatasetIds String 否 558,549

多训练集数据集ID的集合。
LabelIds String 否 971,955

多训练集标注集ID的集合。
Description String 否 test3

新建训练任务描述。
PreTrainTaskId Long 否 132

基于之前的训练任务ID。
TrainMode String 是 COMMON

训练模型。取值如下 ：

  • COMMON：均衡
  • HIGH_ACC：高精度
  • HIGH_PERF：高性能
AdvancedParameters String 否 { "Epoch": 23, "Lr": 0.5, "height": "23", "width": "32", "ValidationDatasetId": 948, "ValidationLabelId": 1266, "TestDatasetId": 948, "TestLabelId": 1266 }
  • Epoch：学习轮数
  • Lr：学习率
  • height：图片高
  • width：图片宽
  • ValidationDatasetId：验证数据集ID
  • ValidationLabelId：验证标注集ID
  • TestDatasetId：测试数据集ID
  • TestLabelId：测试标注集ID

返回数据

名称 类型 示例值 描述
RequestId String 7E55AE6C-F870-0BE4-9265-E0D9FCB1B2CB

每个请求分配唯一的服务器请求ID。
Data Object

出参数据实体。
Id Long 70

数据集ID。
GmtCreate Long 1634276162828

创建时间。
TaskName String test3

任务名称。
Description String test3

任务描述。
DatasetId Long 120

数据集ID。
DatasetName String test1

数据集名称。
LabelId Long 229

标注ID。
LabelName String test3

标注名称。
TrainMode String COMMON

训练模型。训练类型取值如下：

  • COMMON：均衡
  • HIGH_ACC：高精度
  • HIGH_PERF：高性能
RelyOnTaskId Long 213

基于之前的训练任务ID。
RelyOnTaskName String 任务213

基于之前的训练任务名称。
AdvancedParameters String {\"TestLabelId\":1266,\"TestDatasetId\":948,\"Lr\":0.5,\"width\":\"32\",\"ValidationLabelId\":1266,\"Epoch\":23,\"ValidationDatasetId\":948,\"height\":\"23\"}
  • Epoch：学习轮数
  • Lr：学习率
  • height：图片高
  • width：图片宽
  • ValidationDatasetId：验证数据集ID
  • ValidationLabelId：验证标注集ID
  • TestDatasetId：测试数据集ID
  • TestLabelId：测试标注集ID
TrainStatus String INIT

训练状态。取值如下：

  • INIT：未训练
  • PREPARING：准备中
  • TRAINING：训练中
  • TRAIN_SUCCESS：训练成功
  • TRAIN_FAIL：训练失败
ModelId Long 123

模型ID。
ModelEffect String [{"id": "TOP1_ACC", "name": "top1准确率", "value": 100.0}, {"id": "TOP5_ACC", "name": "top5准确率", "value": 100.0}]

模型效果。

SDK参考

阿里云视觉AI自学习类目下的创建训练任务能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为自学习（viapi-regen）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见SDK总览。

示例

请求示例

http(s)://viapi-regen.cn-shanghai.aliyuncs.com/?Action=CreateTrainTask      //更多关于访问域名（Endpoint）信息，请参见：https://help.aliyun.com/document_detail/143103.html
&WorkspaceId=63
&Name=test3
&DatasetIds=558,549
&LabelIds=971,955
&Description=test3
&PreTrainTaskId=132
&TrainMode=COMMON
&AdvancedParameters={ "Epoch": 23, "Lr": 0.5, "height": "23", "width": "32", "ValidationDatasetId": 948,"ValidationLabelId": 1266, 		"TestDatasetId": 948, "TestLabelId": 1266 	}
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateTrainTaskResponse>
    <RequestId>7E55AE6C-F870-0BE4-9265-E0D9FCB1B2CB</RequestId>
    <Data>
        <Id>70</Id>
        <GmtCreate>1634276162828</GmtCreate>
        <TaskName>test3</TaskName>
        <Description>test3</Description>
        <DatasetId>120</DatasetId>
        <DatasetName>test1</DatasetName>
        <LabelId>229</LabelId>
        <LabelName>test3</LabelName>
        <TrainMode>COMMON</TrainMode>
        <RelyOnTaskId>213</RelyOnTaskId>
        <RelyOnTaskName>任务213</RelyOnTaskName>
        <AdvancedParameters>{"TestLabelId":1266,"TestDatasetId":948,"Lr":0.5,"width":"32","ValidationLabelId":1266,"Epoch":23,"ValidationDatasetId":948,"height":"23"}</AdvancedParameters>
        <TrainStatus>INIT</TrainStatus>
        <ModelId>123</ModelId>
        <ModelEffect>[{"id": "TOP1_ACC", "name": "top1准确率", "value": 100.0}, {"id": "TOP5_ACC", "name": "top5准确率", "value": 100.0}]</ModelEffect>
    </Data>
</CreateTrainTaskResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "7E55AE6C-F870-0BE4-9265-E0D9FCB1B2CB",
  "Data" : {
    "Id" : 70,
    "GmtCreate" : 1634276162828,
    "TaskName" : "test3",
    "Description" : "test3",
    "DatasetId" : 120,
    "DatasetName" : "test1",
    "LabelId" : 229,
    "LabelName" : "test3",
    "TrainMode" : "COMMON",
    "RelyOnTaskId" : 213,
    "RelyOnTaskName" : "任务213",
    "AdvancedParameters" : "{\"TestLabelId\":1266,\"TestDatasetId\":948,\"Lr\":0.5,\"width\":\"32\",\"ValidationLabelId\":1266,\"Epoch\":23,\"ValidationDatasetId\":948,\"height\":\"23\"}",
    "TrainStatus" : "INIT",
    "ModelId" : 123,
    "ModelEffect" : "[{\"id\": \"TOP1_ACC\", \"name\": \"top1准确率\", \"value\": 100.0}, {\"id\": \"TOP5_ACC\", \"name\": \"top5准确率\", \"value\": 100.0}]"
  }
}

错误码

关于创建训练任务的错误码，详情请参见常见错误码。

安全声明

  • 请确保上传的图片或文件来源符合相应的法律法规。
  • 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。