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à.
# Comprensione delle operazioni delle API diverse dallo storage e dallo storage
Amazon Rekognition fornisce due tipi di operazioni API. Si tratte delle operazioni non basate su storage in cui non sono memorizzate informazioni da parte di Amazon Rekognition e delle operazioni basate su storage in cui alcune informazioni sui volti sono memorizzate da Amazon Rekognition.
## Non-storage operazioni
Amazon Rekognition fornisce le seguenti operazioni API non basate su storage per le immagini:
+ [DetectLabels](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DetectLabels.html)
+ [DetectFaces](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DetectFaces.html)
+ [CompareFaces](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CompareFaces.html)
+ [DetectModerationLabels](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DetectModerationLabels.html)
+ [DetectProtectiveEquipment](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DetectProtectiveEquipment.html)
+ [RecognizeCelebrities](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_RecognizeCelebrities.html)
+ [DetectText](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DetectText.html)
+ [GetCelebrityInfo](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_GetCelebrityInfo.html)
Amazon Rekognition fornisce le seguenti operazioni API non basate su storage per i video:
+ [StartLabelDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartlabelDetection.html)
+ [StartFaceDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartFaceDetection.html)
+ [StartPersonTracking](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartPersonTracking.html)
+ [StartCelebrityRecognition](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartCelebrityRecognition.html)
+ [StartContentModeration](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartContentModeration.html)
Queste sono indicate come operazioni API *non basate su storage* perché quando si chiama l'operazione, Amazon Rekognition non mantiene alcuna informazione individuata riguardante l'immagine di input. Come tutte le altre operazioni API di Amazon Rekognition, nessun byte di immagine di input viene mantenuto da operazioni API non basate su storage.
I seguenti scenari di esempio mostrano dove è possibile integrare le operazioni API non basate su storage nell'applicazione. Questi scenari presuppongono il possesso di un repository locale di immagini.
**Example 1: un'applicazione che trova immagini nel repository locale che contengono etichette specifiche**
Innanzitutto, è possibile rilevare le etichette (oggetti e concetti) usando l'operazione di Amazon Rekognition `DetectLabels` in ciascuna delle immagini nel repository e costruire un indice lato client, come mostrato di seguito:
```
Label ImageID
tree image-1
flower image-1
mountain image-1
tulip image-2
flower image-2
apple image-3
```
Quindi, l'applicazione può cercare all'interno di questo indice per trovare immagini nel repository locale che contengono un'etichetta specifica. Ad esempio, può mostrare le immagini che contengono un albero.
Ogni etichetta che Amazon Rekognition rileva ha un valore di affidabilità associato. Indica il livello di affidabilità che l'immagine di input contenga quella determinata etichetta. È possibile utilizzare questo valore di affidabilità per eseguire facoltativamente un ulteriore filtraggio lato client sulle etichette, a seconda dei requisiti dell'applicazione in base al livello di affidabilità nel rilevamento. Ad esempio, se si richiedono etichette precise, è possibile filtrare e scegliere solo le etichette con maggiore affidabilità (ad esempio 95% o superiore). Se l'applicazione non richiede un valore di affidabilità superiore, è possibile scegliere di filtrare le etichette con un valore di affidabilità inferiore (vicino al 50%).
**Example 2: un'applicazione per visualizzare immagini del volto migliorate**
Innanzitutto, è possibile rilevare i volti in ciascuna delle immagini nel repository locale usando l'operazione `DetectFaces` di Amazon Rekognition e costruendo un indice lato client. Per ogni volto, l'operazione restituisce metadata che includono un riquadro di delimitazione, punti di riferimento facciali (ad esempio, la posizione della bocca e dell'orecchio) e attributi facciali (ad esempio, sesso). È possibile archiviare questi metadata in un indice locale lato client, come indicato di seguito:
```
ImageID FaceID FaceMetaData
image-1 face-1 , etc.
image-1 face-2 , etc.
image-1 face-3 , etc.
...
```
In questo indice, la chiave primaria è una combinazione di `ImageID` e `FaceID`.
Pertanto, è possibile utilizzare le informazioni contenute nell'indice per migliorare le immagini quando l'applicazione le visualizza dal repository locale. Ad esempio, è possibile aggiungere un riquadro di delimitazione attorno al volto o evidenziare le caratteristiche facciali.
## Storage-based operazioni API
Amazon Rekognition Image [IndexFaces](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_IndexFaces.html)supporta l'operazione, che puoi utilizzare per rilevare i volti in un'immagine e mantenere le informazioni sui tratti del viso rilevati in una raccolta Amazon Rekognition. Di seguito è riportato un esempio di un'operazione API *basata su storage*, poiché le informazioni vengono mantenute nel server.
Immagini Amazon Rekognition fornisce le seguenti operazioni API basate su storage:
+ [IndexFaces](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_IndexFaces.html)
+ [ListFaces](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_ListFaces.html)
+ [SearchFacesByImage](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_SearchFacesByImage.html)
+ [SearchFaces](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_SearchFaces.html)
+ [DeleteFaces](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DeleteFaces.html)
+ [DescribeCollection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DescribeCollection.html)
+ [DeleteCollection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DeleteCollection.html)
+ [ListCollections](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_ListCollections.html)
+ [CreateCollection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateCollection.html)
Video Amazon Rekognition fornisce le seguenti operazioni API basate su storage:
+ [StartFaceSearch](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartFaceSearch.html)
+ [CreateStreamProcessor](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateStreamProcessor.html)
Per archiviare le informazioni sui volti, è necessario creare una raccolta di volti in una delle regioni AWS nell'account. La raccolta di volti viene specificata chiamando l'operazione `IndexFaces`. Dopo aver creato una raccolta di volti e aver archiviato le informazioni sulle caratteristiche facciali per tutti i volti, sarà possibile cercare le corrispondenze di volti al suo interno. Ad esempio, è possibile rilevare il volto più grande di un'immagine e cercare i volti corrispondenti in una raccolta richiamando `searchFacesByImage.`
Le informazioni facciali memorizzate in raccolte da `IndexFaces` sono accessibili alle operazioni di Video Amazon Rekognition. Ad esempio è possibile effettuare una ricerca all'interno di un video delle persone i cui volti corrispondono a quelli in una raccolta esistente richiamando [StartFaceSearch](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartFaceSearch.html).
Per ulteriori informazioni sulla creazione e la gestione di raccolte, consulta [Ricerca di volti in una raccolta](collections.md).
**Nota**
Le raccolte memorizzano i vettori dei volti, che sono rappresentazioni matematiche dei volti. Le raccolte non memorizzano immagini di volti.
**Example 1: un'applicazione che autentica l'accesso a un edificio**
Per iniziare, si crea una raccolta di volti per memorizzare le immagini dei badge scansionate utilizzando l'operazione `IndexFaces`, che estrae i volti e li memorizza come vettori di immagini con possibilità di ricerca. Quindi, quando un dipendente entra nell'edificio, un'immagine del suo volto viene acquisita e inviata all'operazione `SearchFacesByImage`. Se la corrispondenza del volto produce un punteggio di somiglianza sufficientemente alto (pari al 99%), è possibile autenticare il collaboratore.