Opérations image et video

Amazon Rekognition propose deux ensembles d'API principaux pour l'analyse d'images et de vidéos :

• Amazon Rekognition Image : cette API est conçue pour analyser des images.

• Amazon Rekognition Video : cette API se concentre sur l'analyse des vidéos stockées et en streaming.

Les deux API peuvent détecter diverses entités telles que des visages et des objets. Pour une compréhension complète des types de comparaison et de détection pris en charge, reportez-vous à la section surTypes d’analyse.

Fonctionnement d’Image Amazon Rekognition

Les opérations Amazon Rekognition Image sont synchrones. L’entrée et la réponse sont au format JSON. Les opérations Image Amazon Rekognition analysent une image d’entrée au format .jpg ou .png. L’image transmise à une opération Image Amazon Rekognition peut être stockée dans un compartiment Amazon S3. Si vous n'utilisez pas l'AWS CLI, vous pouvez également transmettre des octets d'images codés en Base64 directement à une opération Amazon Rekognition. Pour plus d'informations, consultez la section Utilisation des images.

Opérations de Vidéo Amazon Rekognition

L'API Amazon Rekognition Video facilite l'analyse des vidéos stockées dans un compartiment Amazon S3 ou diffusées via Amazon Kinesis Video Streams.

Pour les opérations vidéo enregistrées, notez ce qui suit :

• Les opérations sont asynchrones.

• L'analyse doit être lancée par une opération « Démarrer » (par exemple, StartFaceDetectionpour la détection de visages dans des vidéos enregistrées).

• L'état d'achèvement de l'analyse est publié dans une rubrique Amazon SNS.

• Pour récupérer les résultats d'une analyse, utilisez l'opération « Obtenir » correspondante (par exemple, GetFaceDetection).

• Pour plus d'informations, voir Utilisation de l'analyse vidéo stockée.

Pour l'analyse des vidéos en streaming :

• Les fonctionnalités incluent la recherche faciale dans les collections de vidéos de Rekognition et la détection d'étiquettes (objets ou concepts).

• Les résultats d'analyse des étiquettes sont envoyés sous forme de notifications Amazon SNS et Amazon S3.

• Les résultats de la recherche faciale sont envoyés dans un flux de données Kinesis.

• La gestion de l'analyse des vidéos en streaming est effectuée via un processeur de streaming Amazon Rekognition Video (par exemple, créez un processeur à l'aide de). CreateStreamProcessor

• Pour plus d'informations, voir Utilisation des événements vidéo en streaming.

Chaque opération d’analyse vidéo renvoie des métadonnées relatives à la vidéo analysée, ainsi qu’un identifiant de tâche et une étiquette de tâche. Des opérations telles que la détection d'étiquettes et la modération du contenu pour les vidéos permettent de trier par horodatage ou nom d'étiquette, et d'agréger les résultats par horodatage ou par segment.

Opérations de stockage et opérations hors stockage

Les opérations d’Amazon Rekognition sont regroupées selon les catégories suivantes.

• Opérations API hors stockage : dans ces opérations, Amazon Rekognition ne conserve aucune information. Vous fournissez des images et des vidéos d’entrée, l’opération exécute l’analyse et renvoie les résultats, mais rien n’est enregistré par Amazon Rekognition. Pour de plus amples informations, veuillez consulter Opérations hors stockage.

• Opérations API de stockage : les serveurs d’Amazon Rekognition peuvent stocker des informations de reconnaissance faciale dans des conteneurs appelés collections. Grâce à d’autres opérations API, Amazon Rekognition permet de rechercher des informations conservées sur un visage, et de réaliser une correspondance de visages. Pour de plus amples informations, veuillez consulter Opérations d’API de stockage.

Utilisation du kit SDK AWS ou de HTTP pour l’appel des opérations d’API Amazon Rekognition

Vous pouvez appeler les opérations d’API Amazon Rekognition à l’aide du kit SDK AWS ou directement en utilisant HTTP. Sauf si vous avez une bonne raison de ne pas le faire, vous devez toujours utiliser le kit SDK AWS. Les exemples Java de cette section utilisent le kit SDK AWS. Il n’est pas fourni de fichier de projet Java, mais vous pouvez utiliser AWS Toolkit for Eclipse pour développer des applications AWS à l’aide de Java.

Les exemples .NET présentés dans cette section utilisent le kit AWS SDK for .NET. Vous pouvez utiliser le kit AWS Toolkit for Visual Studio pour développer des applications AWS avec .NET. Vous y trouverez des modèles utiles, ainsi qu’AWS Explorer pour le déploiement d’applications et la gestion des services.

La Référence de l’API du présent guide couvre l’appel des opérations Amazon Rekognition à l’aide de HTTP. Pour en savoir plus sur la référence Java, consultez AWS SDK for Java.

Les points de terminaison de service d’Amazon Rekognition que vous pouvez utiliser sont définis dans Régions et points de terminaison AWS.

Lorsque vous appelez Amazon Rekognition avec HTTP, utilisez les opérations HTTP POST.