Querying Details About an Auto Labeling Sample
Function
This API is used to query details about an auto labeling sample.
Debugging
You can debug this API through automatic authentication in API Explorer or use the SDK sample code generated by API Explorer.
URI
GET /v2/{project_id}/datasets/{dataset_id}/auto-annotations/samples/{sample_id}
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
dataset_id |
Yes |
String |
Dataset ID. |
project_id |
Yes |
String |
Project ID. For details about how to obtain a project ID, see Obtaining a Project ID and Name. |
sample_id |
Yes |
String |
Sample ID. |
Request Parameters
None
Response Parameters
Status code: 200
Parameter |
Type |
Description |
---|---|---|
check_accept |
Boolean |
Whether the acceptance is passed, which is used for team labeling. Options:
|
check_comment |
String |
Acceptance comment, which is used for team labeling. |
check_score |
String |
Acceptance score, which is used for team labeling. |
deletion_reasons |
Array of strings |
Reason for deleting a sample, which is used for healthcare. |
hard_details |
Map<String,HardDetail> |
Details about difficulties, including description, causes, and suggestions of difficult problems. |
labelers |
Array of Worker objects |
Labeling personnel list of sample assignment. The labelers record the team members to which the sample is allocated for team labeling. |
labels |
Array of SampleLabel objects |
Sample label list. |
metadata |
SampleMetadata object |
Key-value pair of the sample metadata attribute. |
review_accept |
Boolean |
Whether to accept the review, which is used for team labeling. Options:
|
review_comment |
String |
Review comment, which is used for team labeling. |
review_score |
String |
Review score, which is used for team labeling. |
sample_data |
Array of strings |
Sample data list. |
sample_dir |
String |
Sample path. |
sample_id |
String |
Sample ID. |
sample_name |
String |
Sample name. |
sample_size |
Long |
Sample size or text length, in bytes. |
sample_status |
String |
Sample status. The options are as follows:
|
sample_time |
Long |
Sample time, when OBS is last modified. |
sample_type |
Integer |
Sample type. Options:
|
score |
String |
Comprehensive score, which is used for team labeling. |
source |
String |
Source address of sample data. |
sub_sample_url |
String |
Subsample URL, which is used for healthcare. |
worker_id |
String |
ID of a labeling team member, which is used for team labeling. |
Parameter |
Type |
Description |
---|---|---|
alo_name |
String |
Alias. |
id |
Integer |
Reason ID. |
reason |
String |
Reason description. |
suggestion |
String |
Handling suggestion. |
Parameter |
Type |
Description |
---|---|---|
create_time |
Long |
Creation time. |
description |
String |
Labeling team member description. The value contains 0 to 256 characters and does not support the following special characters: ^!<>=&"' |
|
String |
Email address of a labeling team member. |
role |
Integer |
Role. Options:
|
status |
Integer |
Current login status of a labeling team member. Options:
|
update_time |
Long |
Update time. |
worker_id |
String |
ID of a labeling team member. |
workforce_id |
String |
ID of a labeling team. |
Parameter |
Type |
Description |
---|---|---|
annotated_by |
String |
Video labeling method, which is used to distinguish whether a video is labeled manually or automatically. Options:
|
id |
String |
Label ID. |
name |
String |
Label name. |
property |
SampleLabelProperty object |
Attribute key-value pair of the sample label, such as the object shape and shape feature. |
score |
Float |
Confidence. The value range is [0,1]. |
type |
Integer |
Label type. Options:
|
Parameter |
Type |
Description |
---|---|---|
@modelarts:content |
String |
Speech text content, which is a default attribute dedicated to the speech label (including the speech content and speech start and end points). |
@modelarts:end_index |
Integer |
End position of the text, which is a default attribute dedicated to the named entity label. The end position does not include the character corresponding to the value of end_index. Example:
|
@modelarts:end_time |
String |
Speech end time, which is a default attribute dedicated to the speech start/end point label, in the format of hh:mm:ss.SSS. (hh indicates hour; mm indicates minute; ss indicates second; and SSS indicates millisecond.) |
@modelarts:feature |
Object |
Shape feature, which is a default attribute dedicated to the object detection label, with type of List. The upper left corner of the image is used as the coordinate origin [0, 0]. Each coordinate point is represented by [x, y], where x indicates the horizontal coordinate and y indicates the vertical coordinate (both x and y are >=0). The format of each shape is as follows:
|
@modelarts:from |
String |
ID of the head entity in the triplet relationship label, which is a default attribute dedicated to the triplet relationship label. |
@modelarts:hard |
String |
Sample labeled as a hard sample or not, which is a default attribute. Options:
|
@modelarts:hard_coefficient |
String |
Coefficient of difficulty of each label level, which is a default attribute. The value range is [0,1]. |
@modelarts:hard_reasons |
String |
Reasons that the sample is a hard sample, which is a default attribute. Use a hyphen (-) to separate every two hard sample reason IDs, for example, 3-20-21-19. Options:
|
@modelarts:shape |
String |
Object shape, which is a default attribute dedicated to the object detection label and is left empty by default. Options:
|
@modelarts:source |
String |
Speech source, which is a default attribute dedicated to the speech start/end point label and can be set to a speaker or narrator. |
@modelarts:start_index |
Integer |
Start position of the text, which is a default attribute dedicated to the named entity label. The start value begins from 0, including the character corresponding to the value of start_index. |
@modelarts:start_time |
String |
Speech start time, which is a default attribute dedicated to the speech start/end point label, in the format of hh:mm:ss.SSS. (hh indicates hour; mm indicates minute; ss indicates second; and SSS indicates millisecond.) |
@modelarts:to |
String |
ID of the tail entity in the triplet relationship label, which is a default attribute dedicated to the triplet relationship label. |
Parameter |
Type |
Description |
---|---|---|
@modelarts:import_origin |
Integer |
Sample source, which is a built-in attribute. |
@modelarts:hard |
Double |
Whether the sample is labeled as a hard sample, which is a default attribute. Options:
|
@modelarts:hard_coefficient |
Double |
Coefficient of difficulty of each sample level, which is a default attribute. The value range is [0,1]. |
@modelarts:hard_reasons |
Array of integers |
ID of a hard sample reason, which is a default attribute. Options:
|
@modelarts:size |
Array of objects |
Image size (width, height, and depth of the image), which is a default attribute, with type of List<Integer>. In the list, the first number indicates the width (pixels), the second number indicates the height (pixels), and the third number indicates the depth (the depth can be left blank and the default value is 3). For example, [100,200,3] and [100,200] are both valid. Note: This parameter is mandatory only when the sample label list contains the object detection label. |
Example Requests
Querying Details About an Auto Labeling Sample
GET https://{endpoint}/v2/{project_id}/datasets/{dataset_id}/auto-annotations/samples/{sample_id}
Example Responses
Status code: 200
OK
{ "sample_id" : "0059c1b9458a2da9443af684b5099b4e", "sample_type" : 0, "labels" : [ { "name" : "Bees", "type" : 0, "id" : "1", "property" : { "@modelarts:hard_coefficient" : "0.0", "@modelarts:hard" : "false" }, "score" : 0.66 } ], "source" : "https://test-obs.obs.xxx.com:443/data/3_1597649054631.jpg?AccessKeyId=RciyO7RHmhNTfOZVryUH&Expires=1606299474&Signature=anOLGOHPSrj3WXUHVc70tAxWlf4%3D", "metadata" : { "@modelarts:hard_coefficient" : 0.0, "@modelarts:hard" : false, "@modelarts:import_origin" : 0, "@modelarts:hard_reasons" : [ ] }, "sample_time" : 1600490651933, "sample_status" : "UN_ANNOTATION" }
Status Codes
Status Code |
Description |
---|---|
200 |
OK |
401 |
Unauthorized |
403 |
Forbidden |
404 |
Not Found |
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot