Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Referencia de la API de Etiquetas personalizadas de Amazon Rekognition
La API de Etiquetas personalizadas de Amazon Rekognition viene incluida en la documentación como parte del contenido de referencia de la API de Amazon Rekognition. Esta es una lista de las operaciones de la API de Etiquetas personalizadas de Amazon Rekognition con enlaces al tema de referencia de la API de Amazon Rekognition correspondiente. Además, con los enlaces de referencia a las API de este documento se accede al tema de referencia correspondiente de la API de la Guía para desarrolladores de Amazon Rekognition. Para obtener más información sobre del uso de la API, consulte [ Qué es Etiquetas personalizadas de Amazon RekognitionQué es Etiquetas personalizadas de Amazon Rekognition En esta sección, se ofrece una descripción general del flujo de trabajo para entrenar y usar un modelo de etiquetas personalizadas de Amazon Rekognition con la consola y el SDK. AWS Etiquetas personalizadas de Amazon Rekognition se encarga de administrar los conjuntos de datos de un proyecto. Puede crear conjuntos de datos para sus proyectos con la consola y el SDK. AWS Si ha utilizado anteriormente Etiquetas personalizadas de Amazon Rekognition, es posible que tenga que asociar sus conjuntos de datos antiguos a un proyecto nuevo. Para obtener más información, consulte [Paso 6: (Opcional) Asociar conjuntos de datos anteriores a nuevos proyectos](su-associate-prior-dataset.md). Cómo decidir el tipo de modelo Primero debe decidir qué tipo de modelo quiere entrenar, lo que depende de sus objetivos empresariales. Por ejemplo, puede entrenar un modelo para que encuentre un logotipo en las publicaciones de las redes sociales, identifique sus productos en las estanterías de las tiendas o clasifique las piezas de una máquina en una línea de montaje. Etiquetas personalizadas de Amazon Rekognition puede entrenar los siguientes tipos de modelos: [Buscar objetos, escenas y conceptos](#tm-classification) [Buscar ubicaciones de objetos](#tm-object-localization) [Buscar ubicación de marcas](#tm-brand-detection-localization) Para ayudarle a decidir qué tipo de modelo podría entrenar, Etiquetas personalizadas de Amazon Rekognition incluye algunos ejemplos de proyectos que puede utilizar. Para obtener más información, consulte [Introducción a Etiquetas personalizadas de Amazon Rekognition](getting-started.md). Buscar objetos, escenas y conceptos El modelo clasifica los objetos, las escenas y los conceptos que están asociados a una imagen completa. Por ejemplo, puede entrenar un modelo para que determine si una imagen contiene una *atracción turística* o no. Para ver un proyecto de ejemplo, consulte [Clasificación de imágenes](getting-started.md#gs-image-classification-example). La siguiente imagen de un lago es un ejemplo del tipo de imagen en la que se pueden reconocer objetos, escenas y conceptos.
![\[Lago tranquilo que refleja nubes y montañas al atardecer o al amanecer.\]](http://docs.aws.amazon.com/es_es/rekognition/latest/customlabels-dg/images/pateros.jpg)
También tiene la opción de entrenar un modelo que clasifique las imágenes en varias categorías. Por ejemplo, la imagen anterior puede incluir categorías como el *color del cielo*, un *reflejo* o un *lago*. Para ver un proyecto de ejemplo, consulte [Clasificación de imágenes de etiquetas múltiples](getting-started.md#gs-multi-label-image-classification-example). Buscar ubicaciones de objetos El modelo predice la ubicación de un objeto en una imagen. La predicción incluye información del cuadro delimitador en la ubicación del objeto y una etiqueta que identifica el objeto dentro del cuadro delimitador. Por ejemplo, en la siguiente imagen aparecen unos cuadros delimitadores alrededor de varios componentes de una placa de circuito, como un *comparador* o un *potenciómetro*.
![\[Imagen de componentes que muestra un LED IR, un potenciómetro y un chip comparador en una placa de circuito.\]](http://docs.aws.amazon.com/es_es/rekognition/latest/customlabels-dg/images/localization-circuit-board.png)
En el proyecto de ejemplo [Localización de objetos](getting-started.md#gs-object-localization-example), se ve cómo Etiquetas personalizadas de Amazon Rekognition utiliza cuadros delimitadores etiquetados para entrenar un modelo que busca ubicaciones de objetos. Buscar ubicación de marcas Etiquetas personalizadas de Amazon Rekognition puede entrenar un modelo para que busque la ubicación de marcas, como los logotipos, en una imagen. La predicción incluye información del cuadro delimitador en la ubicación de la marca y una etiqueta que identifica el objeto dentro del cuadro delimitador. Para ver un proyecto de ejemplo, consulte [Detección de marcas](getting-started.md#gs-brand-detection-example). La siguiente imagen es un ejemplo de algunas de las marcas que el modelo puede detectar.
![\[Diagrama que muestra el servicio Lambda introduciendo la actividad de usuarios en Amazon Pinpoint para obtener recomendaciones.\]](http://docs.aws.amazon.com/es_es/rekognition/latest/customlabels-dg/images/brand-detection-lambda.png)
Crear un modelo El procedimiento para crear un modelo consiste en crear un proyecto, crear conjuntos de datos de entrenamiento y de prueba y entrenar el modelo. Crear un proyecto Un proyecto de Etiquetas personalizadas de Amazon Rekognition es un grupo de recursos necesarios para crear y administrar un modelo. El proyecto gestiona lo siguiente: **Conjuntos de datos**: las imágenes y las etiquetas de imagen que se utilizan para entrenar un modelo. Un proyecto incluye un conjunto de datos de entrenamiento y un conjunto de datos de prueba. **Modelos**: un modelo es un software que se entrena para buscar los conceptos, las escenas y los objetos que son exclusivos de su empresa o negocio. Puede haber varias versiones de un modelo en un proyecto. Le recomendamos que utilice un proyecto para una sola aplicación práctica, como buscar componentes en una placa de circuito. Puede crear un proyecto con la consola Amazon Rekognition Custom Labels y con la API. [CreateProject](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateProject) Para obtener más información, consulte [Creación de un proyecto](mp-create-project.md). Crear conjuntos de datos de entrenamiento y de prueba Un conjunto de datos es un conjunto de imágenes y etiquetas que describen esas imágenes. Dentro del proyecto, se crea un conjunto de datos de entrenamiento y un conjunto de datos de prueba que Etiquetas personalizadas de Amazon Rekognition utiliza para entrenar y probar el modelo. Una etiqueta identifica un objeto, una escena, un concepto o un cuadro delimitador alrededor del objeto de una imagen. Las etiquetas se asignan a una imagen completa (*image-level*) o se asignan a un cuadro delimitador que rodea el objeto de una imagen. La forma en que etiquete las imágenes en sus conjuntos de datos determina el tipo de modelo que se crea en Etiquetas personalizadas de Amazon Rekognition. Por ejemplo, para entrenar un modelo que busca objetos, escenas y conceptos, debe asignar etiquetas de imagen a las imágenes de sus conjuntos de datos de entrenamiento y de prueba. Para obtener más información, consulte [Finalidad de los conjuntos de datos](md-dataset-purpose.md). Las imágenes deben estar en formato PNG y JPEG y se deben seguir las recomendaciones de las imágenes de entrada. Para obtener más información, consulte [Preparación de imágenes](md-prepare-images.md). Crear conjuntos de datos de entrenamiento y de prueba (consola) Puede empezar con un proyecto que tenga un único conjunto de datos o un proyecto que tenga conjuntos de datos de entrenamiento y de prueba independientes. Si empieza con un único conjunto de datos, Etiquetas personalizadas de Amazon Rekognition lo divide durante el entrenamiento para crear un conjunto de datos de entrenamiento (80 %) y un conjunto de datos de prueba (20 %) para su proyecto. Comience con un único conjunto de datos si quiere que Etiquetas personalizadas de Amazon Rekognition decida qué imágenes se van a usar para el entrenamiento y las pruebas. Para tener un control total sobre el entrenamiento, las pruebas y el nivel de rendimiento, le recomendamos que inicie el proyecto con conjuntos de datos de entrenamiento y de prueba independientes. Para crear los conjuntos de datos para un proyecto, importe las imágenes a través de uno de los siguientes métodos: Importar imágenes de un ordenador local. Importar imágenes de un bucket de S3. Etiquetas personalizadas de Amazon Rekognition puede etiquetar las imágenes con los nombres de las carpetas que contienen las imágenes. Importa un archivo de manifiesto de Amazon SageMaker AI Ground Truth. Copiar un conjunto de datos existente de Etiquetas personalizadas de Amazon Rekognition. Para obtener más información, consulte [Creación de conjuntos de datos de entrenamiento y prueba](md-create-dataset.md). Según el lugar desde el que importe las imágenes, es posible que no vengan etiquetadas. Por ejemplo, las imágenes importadas de un ordenador local no están etiquetadas. Las imágenes importadas de un archivo de manifiesto de Amazon SageMaker AI Ground Truth están etiquetadas. Puede utilizar la consola de Etiquetas personalizadas de Amazon Rekognition para agregar, cambiar y asignar etiquetas. Para obtener más información, consulte [Etiquetado de imágenes](md-labeling-images.md). Para crear sus conjuntos de datos de entrenamiento y de prueba en la consola, consulte [Creación de conjuntos de datos de entrenamiento y prueba](md-create-dataset.md). Si quiere ver el tutorial sobre cómo crear conjuntos de datos de entrenamiento y de prueba, consulte [Clasificación de imágenes](tutorial-classification.md). Crear conjuntos de datos de entrenamiento y prueba (SDK) Puede crear sus conjuntos de datos de entrenamiento y de prueba, use la API de `CreateDataset`. Puede crear un conjunto de datos mediante un archivo de manifiesto en formato Amazon SageMaker o copiando un conjunto de datos de Etiquetas personalizadas de Amazon Rekognition existente. Para obtener más información, consulte [Crear conjuntos de datos de entrenamiento y prueba (SDK)](md-create-dataset.md#cd-create-dataset-sdk). Si es necesario, puede crear su propio archivo de manifiesto. Para obtener más información, consulte [Creación de un archivo de manifiesto](md-create-manifest-file.md). Entrenar su modelo Entrene su modelo con el conjunto de datos de entrenamiento. Se creará una nueva versión del modelo cada vez que se entrena. Durante el entrenamiento, Etiquetas personalizadas de Amazon Rekognition comprueba el rendimiento del modelo entrenado. Puede utilizar los resultados para evaluar y mejorar el modelo. El entrenamiento tarda un tiempo en realizarse. Solo se le cobrará cuando termine de entrenarse por completo un modelo. Para obtener más información, consulte [Entrenamiento de un modelo de Etiquetas personalizadas de Amazon Rekognition](training-model.md). Si el entrenamiento del modelo presenta problemas, Etiquetas personalizadas de Amazon Rekognition le dará información sobre la depuración de errores que puede utilizar. Para obtener más información, consulte [Depuración de un modelo de entrenamiento con errores](tm-debugging.md). Entrenar el modelo (consola) Para entrenar su modelo a través de la consola, consulte [Entrenamiento de un modelo (consola)](training-model.md#tm-console). Entrenamiento de un modelo (SDK) Puedes entrenar a un modelo de Amazon Rekognition Custom Labels llamando. [CreateProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateProjectVersion) Para obtener más información, consulte [Entrenamiento de un modelo (SDK)](training-model.md#tm-sdk). Mejorar el modelo Durante las pruebas, Etiquetas personalizadas de Amazon Rekognition genera métricas de evaluación que puede usar para mejorar el modelo entrenado. Evaluar el modelo Evalúe el rendimiento del modelo mediante las métricas de rendimiento creadas durante las pruebas. Las métricas de rendimiento, como la puntuación F1, las de precisión y las de exhaustividad, le permiten conocer el rendimiento del modelo entrenado y decidir si es posible usarlo en la fase de producción. Para obtener más información, consulte [Métricas para evaluar su modelo](im-metrics-use.md). Evaluar un modelo (consola) Para ver las métricas de rendimiento, consulte [Acceso a las métricas de evaluación (consola)](im-access-training-results.md). Evaluar un modelo (SDK) Para obtener las métricas de rendimiento, llama [DescribeProjectVersions](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DescribeProjectVersions)para obtener los resultados de las pruebas. Para obtener más información, consulte [Acceso a las métricas de evaluación de Etiquetas personalizadas de Amazon Rekognition (SDK)](im-metrics-api.md). Los resultados de las pruebas se representan con métricas que no están disponibles en la consola, como una matriz de confusión para los resultados de la clasificación. Los resultados de las pruebas se devuelven en los siguientes formatos: Puntuación F1: un valor único que refleja el rendimiento general de precisión y exhaustividad del modelo. Para obtener más información, consulte [F1](im-metrics-use.md#im-f1-metric). Ubicación del archivo de resumen: el resumen de las pruebas incluye una serie de métricas de evaluación acumuladas de todo el conjunto de datos de pruebas y las métricas de cada etiqueta por separado. `DescribeProjectVersions` devuelve la ubicación del bucket de S3 y de la carpeta del archivo de resumen. Para obtener más información, consulte [Acceder al archivo de resumen del modelo](im-summary-file-api.md). Ubicación del resumen del manifiesto de evaluación: este resumen incluye los detalles sobre los resultados de las pruebas, como los índices de confianza y los resultados de las pruebas de clasificación binaria, como los falsos positivos. `DescribeProjectVersions` devuelve la ubicación del bucket de S3 y de la carpeta de los archivos de resumen. Para obtener más información, consulte [Interpretación de la instantánea del manifiesto de evaluación](im-evaluation-manifest-snapshot-api.md). Mejorar el modelo Si se necesitan mejoras, puede agregar más imágenes de entrenamiento o mejorar el etiquetado de los conjuntos de datos. Para obtener más información, consulte [Mejora de un modelo de Etiquetas personalizadas de Amazon Rekognition](tr-improve-model.md). También puede aportar sus observaciones sobre las predicciones que haga su modelo y utilizarlos para mejorarlo. Para obtener más información, consulte [Mejora de un modelo con Model feedback](ex-feedback.md). Mejorar el modelo (consola) Para agregar imágenes a un conjunto de datos, consulte [Agregar más imágenes a un conjunto de datos](md-add-images.md). Para agregar o cambiar etiquetas, consulte [Etiquetado de imágenes](md-labeling-images.md). Para volver a entrenar el modelo, consulte [Entrenamiento de un modelo (consola)](training-model.md#tm-console). Mejorar el modelo (SDK) Para agregar imágenes a un conjunto de datos o cambiar el etiquetado de una imagen, usa la API de `UpdateDatasetEntries`. `UpdateDatasetEntries` actualiza o agrega líneas JSON a un archivo de manifiesto. Cada línea JSON contiene la información de una sola imagen, como las etiquetas asignadas o la información de los cuadros delimitadores. Para obtener más información, consulte [Agregar más imágenes (SDK)](md-add-images.md#md-add-images-sdk). Para ver las entradas de un conjunto de datos, usa la API de `ListDatasetEntries`. Para volver a entrenar el modelo, consulte [Entrenamiento de un modelo (SDK)](training-model.md#tm-sdk-datasets). Iniciar el modelo Antes de poder usar el modelo, debe iniciarlo a través de la consola de Etiquetas personalizadas de Amazon Rekognition o la API de `StartProjectVersion`. Se le cobrará por la cantidad de tiempo en que se ejecute el modelo. Para obtener más información, consulte [Ejecución de un modelo de Etiquetas personalizadas de Amazon Rekognition](running-model.md). Iniciar el modelo (consola) Para iniciar el modelo con la consola, consulte [Inicio de un modelo de Etiquetas personalizadas de Amazon Rekognition (consola)](rm-start.md#rm-start-console). Iniciar el modelo Empiezas a llamar a tu modelo [StartProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartProjectVersion). Para obtener más información, consulte [Inicio de un modelo de Etiquetas personalizadas de Amazon Rekognition (SDK)](rm-start.md#rm-start-sdk). Analizar una imagen Para analizar una imagen con el modelo, use la API de `DetectCustomLabels`. Puede indicar una imagen local o una imagen almacenada en un bucket de S3. La operación también requiere el nombre de recurso de Amazon (ARN) del modelo que desee utilizar. Si el modelo encuentra objetos, escenas y conceptos, la respuesta incluirá una lista de etiquetas de imagen que se encuentran en la imagen. Por ejemplo, la siguiente imagen muestra las etiquetas de imagen que se encuentran en el proyecto de ejemplo *Habitaciones*.
![\[Sala de estar con chimenea, sofá marrón, sillón, mesas de café y obras de arte escénicas en la pared. Las puertas conducen a un patio exterior.\]](http://docs.aws.amazon.com/es_es/rekognition/latest/customlabels-dg/images/rooms.jpg)
Si el modelo encuentra ubicaciones de objetos, la respuesta incluirá una lista de los cuadros delimitadores etiquetados que se encuentran en la imagen. Un cuadro delimitador representa la ubicación de un objeto en una imagen. Puede utilizar la información del cuadro delimitador para dibujar un cuadro delimitador alrededor de un objeto. Por ejemplo, en la siguiente imagen aparecen unos cuadros delimitadores alrededor de los componentes de una placa de circuito que se han encontrado por medio del proyecto de ejemplo *Placas de circuito*.
![\[Placa de circuito con LED IR, fototransistor y potenciómetro para ajustes.\]](http://docs.aws.amazon.com/es_es/rekognition/latest/customlabels-dg/images/circuitboardparts.jpg)
Para obtener más información, consulte [Análisis de una imagen con un modelo entrenado](detecting-custom-labels.md). Detener el modelo Se le cobrará por el tiempo de ejecución del modelo. Si ya no va a usar el modelo, deténgalo en la consola de Etiquetas personalizadas de Amazon Rekognition o mediante la API de `StopProjectVersion`. Para obtener más información, consulte [Detención de un modelo de Etiquetas personalizadas de Amazon Rekognition](rm-stop.md). Detener el modelo (consola) Para detener la ejecución de un modelo con la consola, consulte [Detención de un modelo de Etiquetas personalizadas de Amazon Rekognition (consola)](rm-stop.md#rm-stop-console). Detener el modelo (SDK) Para detener a una modelo en marcha, llama [StopProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StopProjectVersion). Para obtener más información, consulte [Detención de un modelo de Etiquetas personalizadas de Amazon Rekognition (SDK)](rm-stop.md#rm-stop-sdk). ](understanding-custom-labels.md).
## Entrenamiento del modelo
### Proyectos
+ [CreateProject](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateProject)— Crea su proyecto Amazon Rekognition Custom Labels, que es una agrupación lógica de recursos (imágenes, etiquetas, modelos) y operaciones (formación, evaluación y detección).
+ [DeleteProject](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DeleteProject)— Elimina un proyecto de Amazon Rekognition Custom Labels.
+ [DescribeProjects](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DescribeProjects)— Devuelve una lista de todos tus proyectos de Amazon Rekognition Custom Labels.
### Políticas de proyecto
+ [PutProjectPolicy](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_PutProjectPolicy)— Adjunta una política de proyecto a un proyecto de Amazon Rekognition Custom Labels en una cuenta de confianza. AWS
+ [ListProjectPolicies](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_ListProjectPolicies)— Devuelve una lista de las políticas de proyecto adjuntas a un proyecto.
+ [DeleteProjectPolicy](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DeleteProjectPolicy)— Elimina una política de proyecto existente.
### Conjuntos de datos
+ [CreateDataset](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateDataset)— Crea un conjunto de datos de etiquetas personalizadas de Amazon Rekognition.
+ [DeleteDataset](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DeleteDataset)— Elimina un conjunto de datos de etiquetas personalizadas de Amazon Rekognition.
+ [DescribeDataset](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DescribeDataset)— Describe un conjunto de datos de etiquetas personalizadas de Amazon Rekognition.
+ [DistributeDatasetEntries](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DistributeDatasetEntries)— Distribuye las entradas (imágenes) de un conjunto de datos de entrenamiento entre el conjunto de datos de entrenamiento y el conjunto de datos de prueba de un proyecto.
+ [ListDatasetEntries](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_ListDatasetEntries)— Devuelve una lista de entradas (imágenes) de un conjunto de datos de etiquetas personalizadas de Amazon Rekognition.
+ [ListDatasetLabels](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_ListDatasetLabels)— Devuelve una lista de etiquetas asignadas a un conjunto de datos de etiquetas personalizadas de Amazon Rekognition.
+ [UpdateDatasetEntries](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_UpdateDatasetEntries)— Añade o actualiza entradas (imágenes) en un conjunto de datos de etiquetas personalizadas de Amazon Rekognition.
### Modelos
+ [CreateProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateProjectVersion)— Entrena tu modelo de etiquetas personalizadas Amazon Rekognition.
+ [CopyProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CopyProjectVersion)— Copia tu modelo de etiquetas personalizadas Amazon Rekognition.
+ [DeleteProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DeleteProjectVersion)— Elimina un modelo de Amazon Rekognition Custom Labels.
+ [DescribeProjectVersions](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DescribeProjectVersions)— Devuelve una lista de todos los modelos de Amazon Rekognition Custom Labels de un proyecto específico.
### Etiquetas
+ [TagResource](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_TagResource)— Añade una o más etiquetas clave-valor a un modelo de etiquetas personalizadas de Amazon Rekognition.
+ [UntagResource](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_UntagResource)— Elimina una o más etiquetas de un modelo de Amazon Rekognition Custom Labels.
## Uso del modelo
+ [DetectCustomLabels](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DetectCustomLabels)— Analiza una imagen con su modelo de etiquetas personalizadas.
+ [StartProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartProjectVersion)— Inicia su modelo de etiquetas personalizadas.
+ [StopProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StopProjectVersion)— Detiene su modelo de etiquetas personalizadas.