本文介绍自学习（viapi-regen）类目下的创建标注集CreateLabelset的语法及示例。

功能描述

通过数据集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 是 CreateLabelset

系统规定参数。取值：CreateLabelset。
DatasetId Long 是 120

数据集ID。
Name String 是 test3

标注名称。
Description String 否 test3

标注描述。
PreLabelId Long 否 123

预标注标识。仅在Type=USE_LABEL_SYSTEM时生效。
Type String 是 UPLOAD_FILE

标注类型。取值如下：

  • UPLOAD_FILE：上传标注文件
  • SELECT_FILE：选择标注文件
  • USE_LABEL_SYSTEM：选择标注系统
ObjectKey String 否 daily/label/120/1634196189161_1631762324685_1631174016651_small.csv

Object名。使用UTF-8编码；长度在1-1023之间；不能以“/”“\”开头。
UserOssUrl String 否 oss://regen-test-bucket/jhdtest/picture/

用户选择的OSS路径。
TagSettings String 否 {"tags":["红绿灯","信号灯"]}

打标设置。
TagUserList String 否 ["123123434341","3423423424324"]

打标人列表。

返回数据

名称 类型 示例值 描述
RequestId String F2C4BA2A-C1A5-0565-BFE9-28A1FE7C6CE3

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

出参数据实体。
Id Long 229

标注ID。
GmtCreate Long 1634196198553

创建时间。
Name String test3

标注名称。
Description String test3

标注描述。
LabelType String UPLOAD_FILE

标注类型。取值如下：

  • UPLOAD_FILE：上传标注文件
  • SELECT_FILE：选择标注文件
  • USE_LABEL_SYSTEM：选择标注系统
Status String FILE_CHECKING

标注状态。取值如下：

  • FILE_CHECKING：文件格式校验中
  • FILE_CHECK_SUCCESS：文件格式校验成功
  • FILE_CHECK_FAIL：文件格式校验失败

SDK参考

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

示例

请求示例

http(s)://viapi-regen.cn-shanghai.aliyuncs.com/?Action=CreateLabelset          //更多关于访问域名（Endpoint）信息，请参见：https://help.aliyun.com/document_detail/143103.html
&DatasetId=120
&Name=test3
&Description=test3
&Type=UPLOAD_FILE
&ObjectKey=daily/label/120/1634196189161_1631762324685_1631174016651_small.csv
&公共请求参数

正常返回示例

XML格式

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

<CreateLabelsetResponse>
    <RequestId>F2C4BA2A-C1A5-0565-BFE9-28A1FE7C6CE3</RequestId>
    <Data>
        <Id>229</Id>
        <GmtCreate>1634196198553</GmtCreate>
        <Name>test3</Name>
        <Description>test3</Description>
        <LabelType>UPLOAD_FILE</LabelType>
        <Status>FILE_CHECKING</Status>
    </Data>
</CreateLabelsetResponse>

JSON格式

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

{
  "RequestId" : "F2C4BA2A-C1A5-0565-BFE9-28A1FE7C6CE3",
  "Data" : {
    "Id" : 229,
    "GmtCreate" : 1634196198553,
    "Name" : "test3",
    "Description" : "test3",
    "LabelType" : "UPLOAD_FILE",
    "Status" : "FILE_CHECKING"
  }
}

错误码

关于创建标注集的错误码，详情请参见常见错误码。

安全声明

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