文档首页/魔坊（ModelArts）模型训推平台/API参考/历史API/数据管理（旧版）/创建团队标注任务
更新时间：2025-06-30 GMT+08:00
查看PDF
分享

创建团队标注任务

功能介绍

创建团队标注任务。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

POST /v2/{project_id}/datasets/{dataset_id}/workforce-tasks

表1 路径参数

参数

是否必选

参数类型

描述

dataset_id

是

String

数据集ID。

project_id

是

String

用户项目ID。获取方法请参见获取项目ID和名称。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

auto_sync_dataset

否

Boolean

团队标注任务的标注结果是否自动同步至数据集。可选值如下：

  • true：团队标注任务的标注结果自动同步至数据集（默认值）

  • false：团队标注任务的标注结果不自动同步至数据集

data_sync_type

否

Integer

同步类型。可选值如下：

  • 0：不同步

  • 1：同步数据

  • 2：同步标签

  • 3：同步数据和标签

repetition

否

Integer

团队标注任务每个样本可以由多少人标注，最少为1。

sample_conditions

否

String

数据集样本的筛选条件，筛选出符合条件的样本进行团队标注。

synchronize_auto_labeling_data

否

Boolean

团队标注任务是否同步智能标注结果。可选值如下：

  • true：执行完智能标注后，将待确认结果同步至团队成员。

  • false：不同步智能标注结果（默认值）。

workforces_config

否

WorkforcesConfig object

团队标注任务团队信息：委托团队管理员分配，或指定团队自行分配。

task_name

否

String

团队标注任务名称

synchronize_data

否

Boolean

是否同步更新新增数据

表3 WorkforcesConfig

参数

是否必选

参数类型

描述

agency

否

String

管理员。

workforces

否

Array of WorkforceConfig objects

执行标注任务的团队列表。

表4 WorkforceConfig

参数

是否必选

参数类型

描述

workers

否

Array of Worker objects

标注成员列表。

workforce_id

否

String

标注团队ID。

workforce_name

否

String

标注团队名称，名称不能包含!<>=&"'，长度为0-1024位。

表5 Worker

参数

是否必选

参数类型

描述

create_time

否

Long

创建时间。

description

否

String

标注成员描述，长度为0-256位，不能包含^!<>=&"'特殊字符。

email

否

String

标注成员邮箱。

role

否

Integer

角色。可选值如下：

  • 0：打标者

  • 1：审核者

  • 2：团队管理者

  • 3：数据集拥有者

status

否

Integer

标注成员的当前登录状态。可选值如下：

  • 0：未发送邀请邮件

  • 1：已发送邀请邮件但未登录

  • 2：已登录

  • 3：标注成员已删除

update_time

否

Long

更新时间。

worker_id

否

String

标注成员ID。

workforce_id

否

String

所属标注团队ID。

响应参数

状态码： 200

表6 响应Body参数

参数

参数类型

描述

task_id

String

团队标注任务ID。

请求示例

创建团队标注任务。设置任务名称为“task-eb17”，同步更新新增数据为“false”，团队标注任务是否同步智能标注结果为“false”。

{
  "task_name" : "task-eb17",
  "synchronize_data" : false,
  "synchronize_auto_labeling_data" : false,
  "workforces_config" : {
    "workforces" : [ {
      "workforce_id" : "feSUo5NUIUnQAQNNTiS",
      "workers" : [ {
        "email" : "xxx@xxx.com"
      }, {
        "email" : "xxx@xxx.com"
      }, {
        "email" : "xxx@xxx.com"
      } ]
    } ]
  },
  "auto_sync_dataset" : false
}

响应示例

状态码： 200

OK

{
  "task_id" : "6phXEto29utpaMwbQkg"
}

状态码

状态码

描述

200

OK

401

Unauthorized

403

Forbidden

404

Not Found

错误码

请参见错误码。