Operaciones de imágenes y vídeo

Amazon Rekognition ofrece dos conjuntos de API principales para el análisis de imágenes y vídeos:

• Amazon Rekognition Image: esta API está diseñada para analizar imágenes.

• Amazon Rekognition Video: esta API se centra en analizar los vídeos almacenados y en streaming.

Ambas API pueden detectar diversas entidades, como rostros y objetos. Para obtener una comprensión completa de los tipos de comparación y detección compatibles, consulte la sección sobreTipos de análisis.

Operaciones de Amazon Rekognition Image

Las operaciones de Amazon Rekognition Image son sincrónicas. La entrada y la respuesta se encuentran en formato JSON. Las operaciones de Amazon Rekognition Image analizan una imagen de entrada que está en formato de imagen .jpg o .png. La imagen se transfiere a una operación de Amazon Rekognition Image que puede almacenarse en un bucket de Amazon S3. Si no utiliza la AWS CLI, también puede pasar bytes de imágenes codificadas en Base64 directamente a una operación de Amazon Rekognition. Para obtener más información, consulte Trabajar con imágenes.

Operaciones de Amazon Rekognition Video

La API Amazon Rekognition Video facilita el análisis de los vídeos almacenados en un bucket de Amazon S3 o transmitidos a través de Amazon Kinesis Video Streams.

Para las operaciones de vídeo almacenado, tenga en cuenta lo siguiente:

• Las operaciones son asíncronas.

• El análisis debe iniciarse con una operación de «Inicio» (por ejemplo, StartFaceDetectionpara la detección de rostros en los vídeos almacenados).

• El estado de finalización del análisis se publica en un tema de Amazon SNS.

• Para recuperar los resultados de un análisis, utilice la operación «Obtener» correspondiente (por ejemplo, GetFaceDetection).

• Para obtener más información, consulte Trabajar con el análisis de vídeo almacenado.

Para el análisis de vídeo en streaming:

• Las capacidades incluyen la búsqueda de rostros en las colecciones de Rekognition Video y la detección de etiquetas (objetos o conceptos).

• Los resultados del análisis de las etiquetas se envían como notificaciones de Amazon SNS y Amazon S3.

• Los resultados de la búsqueda de rostros se envían a una transmisión de datos de Kinesis.

• La gestión del análisis de vídeo en streaming se realiza mediante un procesador de streaming Amazon Rekognition Video (por ejemplo, se crea un procesador con). CreateStreamProcessor

• Para obtener más información, consulte Trabajar con eventos de streaming de vídeo.

Cada operación de análisis de vídeo devuelve metadatos sobre el vídeo que se está analizando, así como un identificador de trabajo y una etiqueta de trabajo. Operaciones como la detección de etiquetas y la moderación del contenido de los vídeos permiten ordenar por marca de tiempo o nombre de etiqueta y agregar los resultados por marca de tiempo o por segmento.

Operaciones basadas en almacenamiento y no almacenamiento

Las operaciones de Amazon Rekognition se agrupan en las siguientes categorías.

• Operaciones API sin almacenamiento: en estas operaciones, Amazon Rekognition no conserva ninguna información. Usted proporciona las imágenes y vídeos de entrada, la operación realiza el análisis y devuelve los resultados, pero no se guarda nada en Amazon Rekognition. Para obtener más información, consulte Operaciones sin almacenamiento.

• Operaciones API basadas en almacenamiento: los servidores de Amazon Rekognition pueden almacenar información facial detectada en contenedores conocidos como colecciones. Amazon Rekognition ofrece operaciones API adicionales que puede utilizar para buscar rostros coincidentes en la información de rostros almacenados. Para obtener más información, consulte Operaciones de API con almacenamiento.

Uso del SDK de AWS o HTTP para llamar a operaciones de API de Amazon Rekognition

Puede llamar a las operaciones de API de Amazon Rekognition utilizando el AWS SDK o directamente a través de HTTP. A menos que tenga una buena razón para no hacerlo, debería usar siempre el AWS SDK. Los ejemplos de Java de esta sección usan el SDK de AWS. El archivo de proyecto de Java no se proporciona, pero puede utilizar AWS Toolkit for Eclipse para desarrollar aplicaciones de AWS mediante Java.

En los ejemplos de .NET de esta sección, se utiliza AWS SDK for .NET. Puede utilizar AWS Toolkit for Visual Studio para desarrollar aplicaciones de AWS con .NET. Incluye útiles plantillas, así como AWS Explorer, para la implementación de aplicaciones y la administración de servicios.

En la Reference de la API de esta guía se explica cómo llamar a las operaciones de Amazon Rekognition mediante HTTP. Para información de referencia de Java, consulte AWS SDK for Java.

Los puntos de conexión del servicio Amazon Rekognition que puede utilizar se documentan en AWS Regions and Endpoints.

Cuando llame a Amazon Rekognition con HTTP, utilice operaciones POST HTTP.