查询智能标注的样本列表
功能介绍
查询数据集中智能标注的样本列表。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
GET /v2/{project_id}/datasets/{dataset_id}/auto-annotations/samples
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
dataset_id | 是 | String | 数据集ID。 |
project_id | 是 | String | 用户项目ID。获取方法请参见获取项目ID和名称。 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
high_score | 否 | String | 置信度上界,默认为1。 |
label_name | 否 | String | 标签名。 |
label_type | 否 | Integer | 标注类型。可选值如下: |
limit | 否 | Integer | 指定每一页返回的最大条目数,取值范围[1,100],默认为10。 |
low_score | 否 | String | 置信度下界,默认为0。 |
offset | 否 | Integer | 分页列表的起始页,默认为0。 |
order | 否 | String | 指定查询的排序顺序。可选值如下: |
process_parameter | 否 | String | 图像缩略设置,同OBS缩略图设置,详见OBS缩略图设置。如:image/resize,m_lfit,h_200表示等比缩放目标缩略图并设置高度为200像素。 |
search_conditions | 否 | String | URL编码后的多维筛选条件(多个SearchCondition之间为and的关系)。 |
请求参数
无
响应参数
状态码: 200
参数 | 参数类型 | 描述 |
|---|---|---|
sample_count | Integer | 样本数量。 |
samples | Array of DescribeSampleResp objects | 样本列表。 |
参数 | 参数类型 | 描述 |
|---|---|---|
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}/auto-annotations/samples 响应示例
状态码: 200
OK
{
"sample_count" : 1,
"samples" : [ {
"sample_id" : "10de574cbf0f09d4798b87ba0eb34e37",
"sample_type" : 0,
"labels" : [ {
"name" : "sunflowers",
"type" : 0,
"id" : "1",
"property" : {
"@modelarts:hard_coefficient" : "0.0",
"@modelarts:hard" : "false"
},
"score" : 1.0
} ],
"source" : "https://test-obs.obs.xxx.com:443/animals/8_1597649054631.jpeg?AccessKeyId=alRn0xskf5luJaG2jBJe&Expires=1606299230&x-image-process=image%2Fresize%2Cm_lfit%2Ch_200&Signature=MNAAjXz%2Fmwn%2BSabSK9wkaG6b6bU%3D",
"metadata" : {
"@modelarts:hard_coefficient" : 1.0,
"@modelarts:hard" : true,
"@modelarts:import_origin" : 0,
"@modelarts:hard_reasons" : [ 8, 6, 5, 3 ]
},
"sample_time" : 1601432758000,
"sample_status" : "UN_ANNOTATION"
} ]
} 状态码
状态码 | 描述 |
|---|---|
200 | OK |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
错误码
请参见错误码。

