Face List Operations - Add Face List Face

Aggiungere un viso a un elenco di visi specificato, fino a 1.000 visi.
Per gestire un'immagine contenente più visi, è possibile specificare il viso di input come immagine con un rettangolo targetFace. Restituisce un elemento persistedFaceId che rappresenta il viso aggiunto. Nessuna immagine verrà archiviata. Solo le funzionalità viso estratte verranno archiviate nel server fino a quando non viene chiamato "Elimina viso elenco viso" o "Elimina elenco viso".

Si noti che persistedFaceId è diverso da faceId generato da "Detect".

• • Maggiore qualità dell'immagine del viso significa una migliore precisione di riconoscimento. Si prega di considerare i visi di alta qualità: le dimensioni frontali, chiare e del viso sono di 200x200 pixel (100 pixel tra gli occhi) o più grandi.
  • Ogni voce può contenere fino a 248 visi.
  • Sono supportati JPEG, PNG, GIF (il primo fotogramma) e il formato BMP. Le dimensioni consentite del file di immagine sono da 1 KB a 6 MB.
  • Il rettangolo "targetFace" deve contenere un viso. Zero o più visi verranno considerati come un errore. Se il rettangolo "targetFace" specificato non viene restituito da "Detect", non esiste alcuna garanzia per rilevare e aggiungere correttamente il viso.
  • Le dimensioni del viso non rilevabili (36x36 - 4096x4096 pixel), la posizione della testa grande o le occlusioni di grandi dimensioni causeranno errori.
  • La dimensione minima del viso rilevabile è di 36x36 pixel in un'immagine non superiore a 1920x1080 pixel. Le immagini con dimensioni superiori a 1920x1080 pixel avranno bisogno di una dimensione minima minima proporzionale.
  • È possibile specificare valori diversi di 'detectionModel'. Per usare e confrontare modelli di rilevamento diversi, vedere https://video2.skills-academy.com/azure/ai-services/computer-vision/how-to/specify-detection-model

POST {endpoint}/face/{apiVersion}/facelists/{faceListId}/persistedfaces

POST {endpoint}/face/{apiVersion}/facelists/{faceListId}/persistedfaces?_overload=addFaceListFace&targetFace={targetFace}&detectionModel={detectionModel}&userData={userData}

Parametri dell'URI

Corpo della richiesta

Media Types: "application/octet-stream"

Risposte

Sicurezza

Ocp-Apim-Subscription-Key

Chiave privata per la sottoscrizione di Viso di Intelligenza artificiale di Azure.

Tipo: apiKey
In: header

AADToken

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: accessCode
URL di autorizzazione: https://api.example.com/oauth2/authorize
URL token: https://api.example.com/oauth2/token

Ambiti

Esempio

Add Face to FaceList

POST {endpoint}/face/v1.2-preview.1/facelists/your_face_list_id/persistedfaces?_overload=addFaceListFace&targetFace=10,10,100,100&detectionModel=detection_01&userData=your_user_data

"<your-image-bytes-here>"

{
  "persistedFaceId": "43897a75-8d6f-42cf-885e-74832febb055"
}

Definizioni

AddFaceResult

Corpo della risposta per l'aggiunta del viso.

DetectionModel

'detectionModel' associato ai faceId rilevati. I valori 'detectionModel' supportati includono 'detection_01', 'detection_02' e 'detection_03'. Il valore predefinito è 'detection_01'.

FaceError

Oggetto error. Per informazioni dettagliate sui codici di errore e i messaggi restituiti dal servizio Viso, vedere il collegamento seguente: https://aka.ms/face-error-codes-and-messages.

FaceErrorResponse

Risposta contenente i dettagli dell'errore.