Actualización de etiquetas de muestras de etiquetado de equipos en lotes
Función
Esta API se utiliza para actualizar etiquetas de muestras de etiquetado de equipos en lotes.
URI
PUT /v2/{project_id}/datasets/{dataset_id}/workforce-tasks/{workforce_task_id}/data-annotations/samples
| 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. |
| workforce_task_id | Sí | String | ID de una tarea de etiquetado. |
Parámetros de solicitud
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| | No | String | Dirección de correo electrónico de un miembro del equipo de etiquetado. |
| samples | No | Array of SampleLabels objects | Lista de muestra actualizada. |
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| labels | No | Array of SampleLabel objects | Lista de etiquetas de muestra. Si este parámetro se deja en blanco, se eliminan todas las etiquetas de ejemplo. |
| metadata | No | SampleMetadata object | Par clave-valor del atributo de muestra metadata. |
| sample_id | No | String | ID de muestra. |
| sample_type | No | Integer | Tipo de muestra. Opciones:
|
| sample_usage | No | String | Uso de la muestra. Opciones:
|
| source | No | String | Dirección de origen de los datos de muestra. |
| worker_id | No | String | ID de un miembro del equipo de etiquetado. |
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| annotated_by | No | 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 | No | String | ID de la etiqueta. |
| name | No | String | Nombre de la etiqueta. |
| property | No | SampleLabelProperty object | Par de atributo clave-valor de la etiqueta de ejemplo, como la forma del objeto y características de forma. |
| score | No | Float | Confianza. |
| type | No | Integer | Tipo de etiqueta. Opciones:
|
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| @modelarts:content | No | 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 | No | 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 | No | 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 | No | 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 | No | 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 | No | String | Muestra etiquetada como muestra dura o no, que es un atributo predeterminado. Opciones:
|
| @modelarts:hard_coefficient | No | String | Coeficiente de dificultad de cada nivel de etiqueta, que es un atributo predeterminado. El rango de valores es [0,1]. |
| @modelarts:hard_reasons | No | 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 | No | 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 | No | 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 | No | 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 | No | 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 | No | 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 | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| @modelarts:import_origin | No | Integer | Fuente de ejemplo, que es un atributo integrado. |
| @modelarts:hard | No | Double | Si la muestra está etiquetada como muestra dura, que es un atributo predeterminado. Opciones:
|
| @modelarts:hard_coefficient | No | Double | Coeficiente de dificultad de cada nivel de muestra, que es un atributo predeterminado. El rango de valores es [0,1]. |
| @modelarts:hard_reasons | No | Array of integers | ID de una razón de ejemplo difícil, que es un atributo predeterminado. Opciones:
|
| @modelarts:size | No | 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. |
Parámetros de respuesta
Código de estado: 200
| Parámetro | Tipo | Descripción |
|---|---|---|
| error_code | String | Código de error. |
| error_msg | String | Mensaje de error. |
| results | Array of BatchResponse objects | Lista de respuestas para actualizar etiquetas de muestra en lotes. |
| success | Boolean | Si la operación es exitosa. Opciones:
|
Solicitudes de ejemplo
Actualización de etiquetas de muestras de etiquetado de equipos en lotes
{
"samples" : [ {
"sample_id" : "0a0939d6d3c48a3d2a2619245943ac21",
"worker_id" : "8c15ad080d3eabad14037b4eb00d6a6f",
"labels" : [ {
"name" : "tulips"
} ]
}, {
"sample_id" : "0e1b5a16a5a577ee53aeb34278a4b3e7",
"worker_id" : "8c15ad080d3eabad14037b4eb00d6a6f",
"labels" : [ {
"name" : "tulips"
} ]
} ]
} Ejemplo de respuestas
Código de estado: 200
OK
{
"success" : true
} 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.