Operazioni Image e Video

Amazon Rekognition offre due set di API principali per l'analisi di immagini e video:

• Amazon Rekognition Image: questa API è progettata per l'analisi delle immagini.

• Amazon Rekognition Video: questa API si concentra sull'analisi dei video archiviati e in streaming.

Entrambe le API sono in grado di rilevare varie entità come volti e oggetti. Per una comprensione completa dei tipi di confronto e rilevamento supportati, consulta la sezione dedicata. Tipi di analisi

Operazioni di Immagini Amazon Rekognition

Le operazioni di Amazon Rekognition Image sono sincrone. L'input e la risposta sono in formato JSON. Le operazioni di Immagini Amazon Rekognition analizzano un'immagine di input in formato .jpg o .png. L'immagine trasmessa a un'operazione di Immagini Amazon Rekognition Image può essere archiviata in un bucket Amazon S3. Se non utilizzi l'AWS CLI, puoi anche passare byte di immagini codificate Base64 direttamente a un'operazione Amazon Rekognition. Per ulteriori informazioni, consulta Lavorare con le immagini.

Operazioni di Video Amazon Rekognition

L'API Amazon Rekognition Video facilita l'analisi dei video archiviati in un bucket Amazon S3 o trasmessi in streaming tramite Amazon Kinesis Video Streams.

Per le operazioni relative ai video archiviati, tieni presente quanto segue:

• Le operazioni sono asincrone.

• L'analisi deve essere avviata con un'operazione «Start» (ad esempio, StartFaceDetectionper il rilevamento dei volti nei video memorizzati).

• Lo stato di completamento dell'analisi viene pubblicato su un argomento di Amazon SNS.

• Per recuperare i risultati di un'analisi, usa l'operazione «Get» corrispondente (ad esempio, GetFaceDetection).

• Per ulteriori informazioni, consultate Lavorare con l'analisi video memorizzata.

Per l'analisi dei video in streaming:

• Le funzionalità includono la ricerca facciale nelle raccolte Rekognition Video e il rilevamento di etichette (oggetti o concetti).

• I risultati dell'analisi per le etichette vengono inviati come notifiche Amazon SNS e Amazon S3.

• I risultati della ricerca facciale vengono inviati a un flusso di dati Kinesis.

• La gestione dell'analisi dei video in streaming viene effettuata tramite un processore di streaming Amazon Rekognition Video (ad esempio, creando un processore utilizzando). CreateStreamProcessor

• Per ulteriori informazioni, consulta Lavorare con gli eventi video in streaming.

Ogni operazione di analisi video restituisce i metadati relativi al video analizzato, oltre a un ID del lavoro e un tag di lavoro. Operazioni come il rilevamento delle etichette e la moderazione dei contenuti per i video consentono l'ordinamento per timestamp o nome dell'etichetta e l'aggregazione dei risultati per timestamp o per segmento.

Operazioni basate su storage e non basate su storage

Le operazioni di Amazon Rekognition sono raggruppate nelle seguenti categorie.

• Operazioni API non basate su storage – In queste operazioni, Amazon Rekognition non mantiene alcuna informazione. Si forniscono immagini e video di input, l'operazione esegue l'analisi e restituisce i risultati, ma nulla viene salvato da Amazon Rekognition. Per ulteriori informazioni, consulta Operazioni non basate su storage.

• Operazioni API basate su storage – i server Amazon Rekognition possono memorizzare le informazioni sul volto rilevate in container noti come raccolte. Amazon Rekognition fornisce ulteriori operazioni API che è possibile utilizzare per cercare le informazioni sui volti mantenute per le corrispondenze dei volti stessi. Per ulteriori informazioni, consulta Operazioni API basate su storage.

Utilizzo dell'SDK AWS o di HTTP per richiamare le operazioni API di Amazon Rekognition

È possibile chiamare le operazioni API di Amazon Rekognition utilizzando l'SDK AWS o direttamente tramite HTTP. A meno che non si abbia una buona ragione per non farlo, è consigliato sempre utilizzare l'SDK AWS. Gli esempi di Java in questa sezione utilizzano l'SDK AWS. Non viene fornito un file di progetto Java, ma è possibile utilizzare AWS Toolkit for Eclipse per sviluppare applicazioni AWS utilizzando Java.

Negli esempi di .NET riportati in questa sezione viene utilizzato AWS SDK for .NET. È possibile utilizzare AWS Toolkit for Visual Studio per sviluppare applicazioni AWS tramite .NET. Include modelli utili e AWS Explorer per l'implementazione delle applicazioni e la gestione dei servizi.

La documentazione di riferimento API di questa guida riguarda la procedura di chiamata delle operazioni di Amazon Rekognition con HTTP. Per le informazioni di riferimento su Java, consulta AWS SDK for Java.

Gli endpoint del servizio Amazon Rekognition che è possibile utilizzare sono documentati su regioni ed endpoint AWS.

Quando si richiama Amazon Rekognition con HTTP, utilizzare le operazioni POST HTTP.