Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Comprendere le operazioni relative alle immagini e ai video di Rekognition 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. [Comprendere i tipi di analisi di Rekognition](how-it-works-types.md) ## 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.](https://docs.aws.amazon.com/rekognition/latest/dg/images.html) ## 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, [StartFaceDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartFaceDetection.html)per 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](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_GetFaceDetection.html)). + Per ulteriori informazioni, consultate [Lavorare con l'analisi video memorizzata](https://docs.aws.amazon.com/rekognition/latest/dg/video.html). 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](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateStreamProcessor.html) + Per ulteriori informazioni, consulta [Lavorare con gli eventi video in streaming](https://docs.aws.amazon.com/rekognition/latest/dg/streaming-video.html). 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. ## Non-storage e operazioni basate sullo storage Le operazioni di Amazon Rekognition sono raggruppate nelle seguenti categorie. + **Non-storage Operazioni API**: in queste operazioni, Amazon Rekognition non conserva 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 [Non-storage operazioni](how-it-works-storage-non-storage.md#how-it-works-non-storage). + **Storage-based Operazioni API**: i server Amazon Rekognition possono archiviare le informazioni facciali rilevate in contenitori 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 [Storage-based operazioni API](how-it-works-storage-non-storage.md#how-it-works-storage-based). ## Utilizzo dell'AWS SDK o di HTTP per richiamare le operazioni API di Amazon Rekognition È possibile chiamare le operazioni API di Amazon Rekognition utilizzando l'AWS SDK 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](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/setup-install.html). Non viene fornito un file di progetto Java, ma è possibile utilizzare [AWS Toolkit for Eclipse](https://docs.aws.amazon.com/AWSToolkitEclipse/latest/GettingStartedGuide/) per sviluppare applicazioni AWS utilizzando Java. Negli esempi di .NET riportati in questa sezione viene utilizzato [AWS SDK per .NET](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/welcome.html). È possibile utilizzare [AWS Toolkit for Visual Studio](https://docs.aws.amazon.com/AWSToolkitVS/latest/UserGuide/welcome.html) 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](https://docs.aws.amazon.com/rekognition/latest/APIReference/Welcome.html) 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 per Java](https://docs.aws.amazon.com/sdk-for-java/latest/reference/index.html). Gli endpoint del servizio Amazon Rekognition che è possibile utilizzare sono documentati su [regioni ed endpoint AWS](https://docs.aws.amazon.com/general/latest/gr/rande.html#rekognition_region). Quando si richiama Amazon Rekognition con HTTP, utilizzare le operazioni POST HTTP.