Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda> ModelArts> Referencia de la API> Gestión de datos> Gestión de etiquetas> Creación de una etiqueta de conjunto de datos

Actualización más reciente 2022-11-14 GMT+08:00

Ver PDF

Creación de una etiqueta de conjunto de datos

Función

Esta API se utiliza para crear una etiqueta de conjunto de datos.

URI

POST /v2/{project_id}/datasets/{dataset_id}/data-annotations/labels

**Tabla 1** Parámetros de ruta
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.

Parámetros de solicitud

**Tabla 2** Parámetros de body de solicitud
Parámetro	Obligatorio	Tipo	Descripción
labels	No	Array of Label objects	Lista de etiquetas que se van a crear.

**Tabla 3** Label
Parámetro	Obligatorio	Tipo	Descripción
attributes	No	Array of LabelAttribute objects	Atributo multidimensional de una etiqueta. Por ejemplo, si la etiqueta es música, se pueden incluir atributos como el estilo y el artista.
name	No	String	Nombre de la etiqueta.
property	No	LabelProperty object	Par clave-valor de atributo básico de una etiqueta, como el color y las teclas de método abreviado.
type	No	Integer	Tipo de etiqueta. Opciones: 0: clasificación de imágenes 1: detección de objetos 3: segmentación de la imagen 100: Clasificación del texto 101: reconocimiento de entidad nombrada 102: Relación de trillizos de texto 103: Entidad triplete de texto 200: clasificación de sonido 201: Etiquetado de voz 202: Etiquetado de párrafo de discurso 600: etiquetado de vídeo

**Tabla 4** LabelAttribute
Parámetro	Obligatorio	Tipo	Descripción
default_value	No	String	Valor predeterminado de un atributo de etiqueta.
id	No	String	ID de atributo de etiqueta.
name	No	String	Nombre del atributo de etiqueta.
type	No	String	Tipo de atributo de etiqueta. Opciones: text: texto select: lista desplegable de una sola opción
values	No	Array of LabelAttributeValue objects	Lista de valores de atributo de etiqueta.

**Tabla 5** LabelAttributeValue
Parámetro	Obligatorio	Tipo	Descripción
id	No	String	ID de valor de atributo de etiqueta.
value	No	String	Valor del atributo de etiqueta.

**Tabla 6** LabelProperty
Parámetro	Obligatorio	Tipo	Descripción
@modelarts:color	No	String	Atributo predeterminado: Color de etiqueta, que es un código hexadecimal del color. De forma predeterminada, este parámetro se deja en blanco. Ejemplo: #FFFFF0.
@modelarts:default_shape	No	String	Atributo predeterminado: forma predeterminada de una etiqueta de detección de objeto (atributo dedicado). De forma predeterminada, este parámetro se deja en blanco. Opciones: bndbox: rectángulo polygon: polígono circle: círculo line: línea recta dashed: línea de puntos point: punto polyline: polilínea
@modelarts:from_type	No	String	Atributo por defecto: Tipo de la entidad de cabecera en la etiqueta de relación de triplete. Este atributo debe especificarse cuando se crea una etiqueta de relación. Este parámetro solo se utiliza para el conjunto de datos de texto triplete.
@modelarts:rename_to	No	String	Atributo predeterminado: el nuevo nombre de la etiqueta.
@modelarts:shortcut	No	String	Atributo predeterminado: Tecla de método abreviado de etiqueta. De forma predeterminada, este parámetro se deja en blanco. Por ejemplo: D.
@modelarts:to_type	No	String	Atributo por defecto: Tipo de la entidad de cola en la etiqueta de relación de triplete. Este atributo debe especificarse cuando se crea una etiqueta de relación. Este parámetro solo se utiliza para el conjunto de datos de texto triplete.

Parámetros de respuesta

Código de estado: 200

**Tabla 7** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
error_code	String	Código de error.
error_msg	String	Mensaje de error.
results	Array of BatchResponse objects	Body de respuesta para crear una etiqueta.
success	Boolean	Compruebe si la operación se ha realizado correctamente. Opciones: true: La operación se realiza correctamente. false: se ha producido un error en la operación.

**Tabla 8** BatchResponse
Parámetro	Tipo	Descripción
error_code	String	Código de error.
error_msg	String	Mensaje de error.
success	Boolean	Compruebe si la operación se ha realizado correctamente. Opciones: true: La operación se realiza correctamente. false: se ha producido un error en la operación.

Solicitudes de ejemplo

Creación de una etiqueta de conjunto de datos

{
  "labels" : [ {
    "name" : "Cat",
    "property" : {
      "@modelarts:color" : "#3399ff",
      "@modelarts:default_shape" : "bndbox"
    }
  } ]
}