Consulta de detalles acerca de una muestra
Función
Consultar detalles sobre una muestra.
URI
GET /v2/{project_id}/datasets/{dataset_id}/data-annotations/samples/{sample_id}
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
dataset_id |
Sí |
String |
ID de conjunto de datos. |
project_id |
Sí |
String |
ID del proyecto. Para obtener más información sobre cómo obtener el ID de proyecto, consulte Obtención de un ID de proyecto. |
sample_id |
Sí |
String |
ID de muestra. |
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
locale |
No |
String |
Idioma. Opciones:
|
sample_state |
No |
String |
Estado de la muestra. Opciones:
|
worker_id |
No |
String |
ID de un miembro del equipo de etiquetado. |
Parámetros de solicitud
Ninguno
Parámetros de respuesta
Código de estado: 200
Parámetro |
Tipo |
Descripción |
---|---|---|
check_accept |
Boolean |
Si se aprueba la aceptación, que se utiliza para el etiquetado del equipo. Opciones:
|
check_comment |
String |
Comentario de aceptación, que se utiliza para el etiquetado del equipo. |
check_score |
String |
Puntuación de aceptación, que se utiliza para el etiquetado de equipos. |
deletion_reasons |
Array of strings |
Motivo para eliminar una muestra, que se utiliza para la atención médica. |
hard_details |
Map<String,HardDetail> |
Detalles sobre las dificultades, incluyendo descripción, causas y sugerencias de problemas difíciles. |
labelers |
Array of Worker objects |
Lista de personal de etiquetado de asignación de muestra. Las etiquetadoras registran los miembros del equipo a los que se asigna la muestra para el etiquetado del equipo. |
labels |
Array of SampleLabel objects |
Lista de etiquetas de muestra. |
metadata |
SampleMetadata object |
Par clave-valor del atributo de muestra metadata. |
review_accept |
Boolean |
Si se acepta la revisión, que se utiliza para el etiquetado del equipo. Opciones:
|
review_comment |
String |
Comentario de revisión, que se utiliza para el etiquetado de equipos. |
review_score |
String |
Puntuación de revisión, que se utiliza para el etiquetado de equipos. |
sample_data |
Array of strings |
Lista de datos de muestra. |
sample_dir |
String |
Ruta de muestra. |
sample_id |
String |
ID de muestra. |
sample_name |
String |
Nombre de muestra. |
sample_size |
Long |
Tamaño de muestra o longitud del texto, en bytes. |
sample_status |
String |
Estado de la muestra. Opciones:
|
sample_time |
Long |
Tiempo de muestra, cuando OBS se modifica por última vez. |
sample_type |
Integer |
Tipo de muestra. Opciones:
|
score |
String |
Puntuación integral, que se utiliza para el etiquetado de equipos. |
source |
String |
Dirección de origen de los datos de muestra. |
sub_sample_url |
String |
URL de la submuestra, que se utiliza para el cuidado de la salud. |
worker_id |
String |
ID de un miembro del equipo de etiquetado, que se utiliza para el etiquetado del equipo. |
Parámetro |
Tipo |
Descripción |
---|---|---|
alo_name |
String |
Alias. |
id |
Integer |
ID de razón. |
reason |
String |
Descripción de razón. |
suggestion |
String |
Sugerencia de manejo. |
Parámetro |
Tipo |
Descripción |
---|---|---|
create_time |
Long |
Tiempo de creación. |
description |
String |
Descripción del miembro del equipo de etiquetado. El valor contiene de 0 a 256 caracteres y no admite los siguientes caracteres especiales: ^!<>=&"' |
|
String |
Dirección de correo electrónico de un miembro del equipo de etiquetado. |
role |
Integer |
Rol. Opciones:
|
status |
Integer |
Estado actual de inicio de sesión de un miembro del equipo de etiquetado. Opciones:
|
update_time |
Long |
Tiempo de actualización. |
worker_id |
String |
ID de un miembro del equipo de etiquetado. |
workforce_id |
String |
ID de un equipo de etiquetado. |
Parámetro |
Tipo |
Descripción |
---|---|---|
annotated_by |
String |
Método de etiquetado de vídeo, que se utiliza para distinguir si un vídeo se etiqueta manualmente o automáticamente. Opciones:
|
id |
String |
ID de la etiqueta. |
name |
String |
Nombre de la etiqueta. |
property |
SampleLabelProperty object |
Par de atributo clave-valor de la etiqueta de ejemplo, como la forma del objeto y características de forma. |
score |
Float |
Confianza. |
type |
Integer |
Tipo de etiqueta. Opciones:
|
Parámetro |
Tipo |
Descripción |
---|---|---|
@modelarts:content |
String |
Contenido de texto de voz, que es un atributo predeterminado dedicado a la etiqueta de voz . (incluido el contenido del habla y los puntos de inicio y final del habla). |
@modelarts:end_index |
Integer |
Posición final del texto, que es un atributo predeterminado dedicado a la etiqueta de entidad con nombre. La posición final no incluye el carácter correspondiente al valor de end_index. Los ejemplos son los siguientes.- Si el contenido del texto es "Barack Hussein Obama II (born August 4, 1961) is an American attorney and politician.", los valores start_index y end_index de "Barack Hussein Obama II" son 0 y 23, respectivamente.- Si el contenido del texto es "By the end of 2018, the company has more than 100 employees.", los valores start_index y end_index de "By the end of 2018" son 0 y 18, respectivamente. |
@modelarts:end_time |
String |
Tiempo de finalización de voz, que es un atributo por defecto dedicado a la etiqueta de punto de inicio/fin de voz, en el formato de hh:mm:ss.SSS. (hh indica la hora; mm indica el minuto; ss indica el segundo; y SSS indica el milisegundo.) |
@modelarts:feature |
Object |
Característica de forma, que es un atributo predeterminado dedicado a la etiqueta de detección de objetos, con tipo de List. La esquina superior izquierda de una imagen se utiliza como el origen de coordenadas [0,0]. Cada punto de coordenada está representado por [x, y]. x indica la coordenada horizontal e y indica la coordenada vertical . (tanto x como y son mayores o iguales a 0). El formato de cada forma es el siguiente: - bndbox: consta de dos puntos, por ejemplo, [[0,10],[50,95]]. El primer punto se encuentra en la esquina superior izquierda del rectángulo y el segundo punto se encuentra en la esquina inferior derecha del rectángulo. Es decir, la coordenada X del primer punto debe ser menor que la del segundo punto, y la coordenada Y del segundo punto debe ser menor que la del primer punto.- polygon: consiste en múltiples puntos que están conectados en secuencia para formar un polígono, por ejemplo, [[0,100],[50,95],[10,60],[500,400]].- circle: consiste en el punto central y el radio, por ejemplo, [[100,100],[50]].- line: consta de dos puntos, por ejemplo, [[0,100],[50,95]]. El primer punto es el punto de inicio, y el segundo punto es el punto final.- dashed: consta de dos puntos, por ejemplo, [[0,100],[50,95]]. El primer punto es el punto inicial, y el segundo punto es el punto final.- point: consiste en un punto, por ejemplo, [[0,100]].- polyline: consiste en múltiples puntos, por ejemplo, [[0,100],[50,95],[10,60],[500,400]]. |
@modelarts:from |
String |
ID de la entidad de cabeza en la etiqueta de relación de triplete, que es un atributo por defecto dedicado a la etiqueta de relación de triplete. |
@modelarts:hard |
String |
Muestra etiquetada como muestra dura o no, que es un atributo predeterminado. Opciones:
|
@modelarts:hard_coefficient |
String |
Coeficiente de dificultad de cada nivel de etiqueta, que es un atributo predeterminado. El rango de valores es [0,1]. |
@modelarts:hard_reasons |
String |
Razones por las que la muestra es una muestra dura, que es un atributo predeterminado. Utilice un guion (-) para separar cada dos ID de motivos de muestra dura, por ejemplo, 3-20-21-19. Opciones:
|
@modelarts:shape |
String |
Forma de objeto, que es un atributo predeterminado dedicado a la etiqueta de detección de objetos y se deja vacía de forma predeterminada. Opciones:
|
@modelarts:source |
String |
Fuente de voz, que es un atributo por defecto dedicado a la etiqueta de punto de inicio/fin de voz y que puede ajustarse a un altavoz o narrador. |
@modelarts:start_index |
Integer |
Posición inicial del texto, que es un atributo predeterminado dedicado a la etiqueta de entidad con nombre. El valor inicial comienza desde 0, incluyendo el carácter correspondiente al valor de start_index. |
@modelarts:start_time |
String |
Tiempo de inicio de voz, que es un atributo por defecto dedicado a la etiqueta de punto de inicio/fin de voz, en el formato de hh:mm:ss.SSS. (hh indica la hora; mm indica el minuto; ss indica el segundo; y SSS indica el milisegundo.) |
@modelarts:to |
String |
ID de la entidad de cola en la etiqueta de relación de triplete, que es un atributo por defecto dedicado a la etiqueta de relación de triplete. |
Parámetro |
Tipo |
Descripción |
---|---|---|
@modelarts:import_origin |
Integer |
Fuente de ejemplo, que es un atributo integrado. |
@modelarts:hard |
Double |
Si la muestra está etiquetada como muestra dura, que es un atributo predeterminado. Opciones:
|
@modelarts:hard_coefficient |
Double |
Coeficiente de dificultad de cada nivel de muestra, que es un atributo predeterminado. El rango de valores es [0,1]. |
@modelarts:hard_reasons |
Array of integers |
ID de una razón de ejemplo difícil, que es un atributo predeterminado. Opciones:
|
@modelarts:size |
Array of objects |
Tamaño de la imagen (ancho, alto y profundidad de la imagen), que es un atributo predeterminado, con tipo de List. En la lista, el primer número indica la anchura (píxeles), el segundo número indica la altura (píxeles) y el tercer número indica la profundidad . (la profundidad puede dejarse en blanco y el valor predeterminado es 3). Por ejemplo, [100,200,3] y [100,200] son válidos. Nota: Este parámetro sólo es obligatorio cuando la lista de etiquetas de ejemplo contiene la etiqueta de detección de objetos. |
Solicitudes de ejemplo
Consulta de detalles acerca de una muestra
GET https://{endpoint}/v2/{project_id}/datasets/{dataset_id}/data-annotations/samples/{sample_id}
Ejemplo de respuestas
Código de estado: 200
OK
{ "sample_id" : "012f99f3cf405860130b6ed2350c2228", "sample_type" : 0, "labels" : [ { "name" : "car", "type" : 0, "property" : { } } ], "source" : "https://test-obs.obs.xxx.com:443/image/aifood/%E5%86%B0%E6%BF%80%E5%87%8C/36502.jpg?AccessKeyId=RciyO7RHmhNTfOZVryUH&Expires=1606297079&Signature=Ju4FYpEu973ii%2FAdUVLTfpLCTbg%3D", "metadata" : { "@modelarts:import_origin" : 0 }, "sample_time" : 1589190552106, "sample_status" : "MANUAL_ANNOTATION", "labelers" : [ { "email" : "xxx@xxx.com", "worker_id" : "5d8d4033b428fed5ac158942c33940a2", "role" : 0 } ] }
Códigos de estado
Código de estado |
Descripción |
---|---|
200 |
OK |
401 |
Unauthorized |
403 |
Forbidden |
404 |
Not Found |
Códigos de error
Consulte Códigos de error.