查询团队标注的样本信息
功能介绍
查询团队标注的样本信息,只有在验收任务发起后才能正确调用。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
GET /v2/{project_id}/datasets/{dataset_id}/workforce-tasks/{workforce_task_id}/data-annotations/samples/{sample_id}
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
dataset_id | 是 | String | 数据集ID。 |
project_id | 是 | String | 用户项目ID。获取方法请参见获取项目ID和名称。 |
sample_id | 是 | String | 样本ID。 |
workforce_task_id | 是 | String | 标注任务ID。 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
locale | 否 | String | 语言。可选值如下:
|
sample_state | 否 | String | 样本状态。可选样本状态如下: |
worker_id | 否 | String | 标注成员ID。 |
请求参数
无
响应参数
状态码: 200
参数 | 参数类型 | 描述 |
|---|---|---|
check_accept | Boolean | 是否验收通过,用于团队标注。可选值如下: |
check_comment | String | 验收意见,用于团队标注。 |
check_score | String | 验收评分,用于团队标注。 |
deletion_reasons | Array of strings | 样本的删除原因,用于医疗。 |
hard_details | Map<String,HardDetail> | 疑难详情,包括:疑难描述,疑难原因,疑难建议。 |
labelers | Array of Worker objects | 样本分配的标注人列表,记录这张样本分给了哪些团队成员,用于团队标注。 |
labels | Array of SampleLabel objects | 样本标签列表。 |
metadata | SampleMetadata object | 样本metadata属性键值对。 |
review_accept | Boolean | 是否审核通过,用于团队标注。可选值如下: |
review_comment | String | 审核意见,用于团队标注。 |
review_score | String | 审核评分,用于团队标注。 |
sample_data | Array of strings | 样本数据列表。 |
sample_dir | String | 样本所在路径。 |
sample_id | String | 样本ID。 |
sample_name | String | 样本名称。 |
sample_size | Long | 样本大小或文本长度,单位是字节。 |
sample_status | String | 样本状态。可选样本状态如下: |
sample_time | Long | 样本时间,OBS最后修改时间。 |
sample_type | Integer | 样本类型。可选值如下: |
score | String | 综合评分,用于团队标注。 |
source | String | 样本数据源地址。 |
sub_sample_url | String | 子样本URL,用于医疗。 |
worker_id | String | 团队标注人员的ID,用于团队标注。 |
参数 | 参数类型 | 描述 |
|---|---|---|
create_time | Long | 创建时间。 |
description | String | 标注成员描述,长度为0-256位,不能包含^!<>=&"'特殊字符。 |
String | 标注成员邮箱。 | |
role | Integer | 角色。可选值如下: |
status | Integer | 标注成员的当前登录状态。可选值如下: |
update_time | Long | 更新时间。 |
worker_id | String | 标注成员ID。 |
workforce_id | String | 所属标注团队ID。 |
参数 | 参数类型 | 描述 |
|---|---|---|
annotated_by | String | 视频标注途径,用于区分标签是人工标注的还是自动标注的。可选值如下: |
id | String | 标签ID。 |
name | String | 标签名。 |
property | SampleLabelProperty object | 样本标签的属性键值对,如物体形状、形状特征等。 |
score | Float | 置信度,取值范围为[0,1] |
type | Integer | 标签类型。可选值如下: |
参数 | 参数类型 | 描述 |
|---|---|---|
@modelarts:content | String | 语音标签(包含语音内容和语音起止点)专用内置属性:语音文本内容。 |
@modelarts:end_index | Integer | 命名实体标签专用内置属性:文本的结束位置,但不包括end_index所指的字符。例如: |
@modelarts:end_time | String | 语音起止点标签专用内置属性:语音的结束时间,格式“hh:mm:ss.SSS”(其中hh表示小时,mm表示分钟,ss表示秒,SSS表示毫秒)。 |
@modelarts:feature | Object | 物体检测标签专用内置属性:形状特征,类型为List。以图片的左上角为坐标原点[0, 0],每个坐标点的表示方法为[x, y],x表示横坐标,y表示纵坐标(x和y均>=0)。每种形状的格式如下: |
@modelarts:from | String | 三元组关系标签专用内置属性:三元组关系标签的起始实体ID。 |
@modelarts:hard | String | 内置属性:标签级别是否难例。可选值为: |
@modelarts:hard_coefficient | String | 内置属性:标签级别难度系数。范围为[0,1]。 |
@modelarts:hard_reasons | String | 内置属性:标签级别难例原因。通过中划线间隔单个难例原因ID,例如:“3-20-21-19”。难例原因ID可选值如下: |
@modelarts:shape | String | 物体检测标签专用内置属性:物体形状,默认为空。可选值如下: |
@modelarts:source | String | 语音起止点标签专用内置属性:语音来源(例如说话人/旁白等)。 |
@modelarts:start_index | Integer | 命名实体标签专用内置属性:文本的起始位置,值从0开始,包括start_index所指的字符。 |
@modelarts:start_time | String | 语音起止点标签专用内置属性:语音的起始时间,格式“hh:mm:ss.SSS”(其中hh表示小时,mm表示分钟,ss表示秒,SSS表示毫秒)。 |
@modelarts:to | String | 三元组关系标签专用内置属性:三元组关系标签的指向实体ID。 |
参数 | 参数类型 | 描述 |
|---|---|---|
@modelarts:import_origin | Integer | 内置属性:样本来源。 |
@modelarts:hard | Double | 内置属性:样本级别是否难例。可选值为: |
@modelarts:hard_coefficient | Double | 内置属性:样本级别难度系数。范围为[0,1]。 |
@modelarts:hard_reasons | Array of integers | 内置属性:样本级别难例原因ID列表。难例原因ID可选值如下: |
@modelarts:size | Array of objects | 内置属性:图像尺寸(图像的宽度、高度、深度),类型为List[/topic/body/section/table/tgroup/tbody/row/entry/p/br {""}) (br]。列表中的第一个数字为宽度(像素),第二个数字为高度(像素),第三个数字为深度(深度可以没有,默认为3),如[100,200,3]和[100,200]均合法。 说明:只有当样本的标签列表包含物体检测标签时,此字段必选。 |
请求示例
查询团队标注的样本信息
GET https://{endpoint}/v2/{project_id}/datasets/{dataset_id}/workforce-tasks/{workforce_task_id}/data-annotations/samples/{sample_id} 响应示例
状态码: 200
OK
{
"sample_id" : "26c6dd793d80d3274eb89349ec76d678",
"sample_type" : 0,
"labels" : [ ],
"source" : "https://test-obs.obs.xxx.com:443/detect/data/dataset-car-and-person/IMG_kitti_0000_000016.png?AccessKeyId=4D34AYDTK93HUY79NSD7&Expires=1606300437&x-obs-security-token=gQpjbi1ub3J0aC03jELficNKUP87aSTIhvsHQAvImcyVbXlYTrU2XJIc28F7kiXanJ3TyJV39iXl0yi5mzQ...",
"metadata" : {
"@modelarts:import_origin" : 0,
"@modelarts:size" : [ 1242, 375, 3 ]
},
"sample_time" : 1598263639997,
"sample_status" : "UN_ANNOTATION",
"worker_id" : "8c15ad080d3eabad14037b4eb00d6a6f",
"labelers" : [ {
"email" : "xxx@xxx.com",
"worker_id" : "afdda13895bc66322ffbf36ae833bcf0",
"role" : 0
} ]
} 状态码
状态码 | 描述 |
|---|---|
200 | OK |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
错误码
请参见错误码。

