Large Person Group Person - Add Face From Url

Aggiungere un viso a una persona in un gruppo di persone di grandi dimensioni per l'identificazione o la verifica del viso. Per gestire un'immagine contiene più visi, è possibile specificare il viso di input come immagine con un rettangolo targetFace. Restituisce un oggetto persistedFaceId che rappresenta il viso aggiunto. Nessuna immagine verrà archiviata. Solo la funzionalità viso estratta verrà archiviata nel server fino a quando viene chiamato LargePersonGroup PersonFace - Delete, LargePersonGroup Person - Delete o LargePersonGroup .
Nota persistentedFaceId è diverso da faceId generato da Face - Detect.

  • Maggiore qualità dell'immagine del viso significa una migliore precisione di riconoscimento. Si prega di considerare i visi di alta qualità: frontal, chiaro e dimensioni del viso è 200x200 pixel (100 pixel tra gli occhi) o maggiore.
  • Ogni voce può contenere fino a 248 visi.
  • Sono supportati JPEG, PNG, GIF (primo frame) e formato BMP. Le dimensioni consentite del file di immagine sono da 1 KB a 6 MB.
  • Il rettangolo "targetFace" deve contenere una faccia. Zero o più visi verranno considerati come un errore. Se il rettangolo "targetFace" specificato non viene restituito da Viso - Rileva, non è possibile rilevare e aggiungere correttamente il viso.
  • Le dimensioni del viso rilevabili (36x36 - 4096x4096 pixel), le grandi posizioni head o le occlusioni di grandi dimensioni causano errori.
  • L'aggiunta o l'eliminazione di visi a/da una stessa persona verrà elaborata in sequenza. L'aggiunta o l'eliminazione di visi a/da persone diverse vengono elaborate in parallelo.
  • Le dimensioni minime del viso rilevabili sono 36x36 pixel in un'immagine non superiore a 1920x1080 pixel. Le immagini con dimensioni superiori a 1920x1080 pixel richiedono dimensioni minime proporzionali maggiori.
  • È possibile specificare valori diversi di 'detectionModel'. Per usare e confrontare modelli di rilevamento diversi, vedere Come specificare un modello di rilevamento
POST {Endpoint}/face/v1.0/largepersongroups/{largePersonGroupId}/persons/{personId}/persistedfaces
POST {Endpoint}/face/v1.0/largepersongroups/{largePersonGroupId}/persons/{personId}/persistedfaces?userData={userData}&targetFace={targetFace}&detectionModel={detectionModel}

Parametri dell'URI

Name In Required Type Description
Endpoint
path True
  • string

Endpoint di Servizi cognitivi supportati (protocollo e nome host, ad esempio: https://westus.api.cognitive.microsoft.com).

largePersonGroupId
path True
  • string

Id che fa riferimento a un determinato gruppo di persone di grandi dimensioni.

Regex pattern: ^[a-z0-9-_]+$

personId
path True
  • string
uuid

Id che fa riferimento a una persona specifica.

detectionModel
query

Nome del modello di rilevamento. Il modello di rilevamento viene usato per rilevare i visi nell'immagine inviata. È possibile specificare un nome del modello di rilevamento quando si esegue Face - Rileva o (Large)FaceList - Aggiungi viso o (Large)PersonGroup - Aggiungi viso. Il valore predefinito è "detection_01", se è necessario un altro modello, specificarlo in modo esplicito.

targetFace
query
  • array

Rettangolo viso per specificare il viso di destinazione da aggiungere a una persona nel formato "targetFace=left,top,width,height". Ad esempio, "targetFace=10.10.100.100.100". Se nell'immagine sono presenti più volti, targetFace è necessario specificare quale viso aggiungere. Nessun targetFace significa che nell'intera immagine è presente un solo viso rilevato.

userData
query
  • string

Dati specificati dall'utente sul viso per qualsiasi scopo. La lunghezza massima è 1 KB.

Intestazione della richiesta

Name Required Type Description
Ocp-Apim-Subscription-Key True
  • string

Corpo della richiesta

Name Required Type Description
url True
  • string

URL raggiungibile pubblicamente di un'immagine

Risposte

Name Type Description
200 OK

Una chiamata con esito positivo restituisce il nuovo carattere permanenteFaceId.

Other Status Codes

Risposta di errore.

Sicurezza

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Esempio

Add Person face example

Sample Request

POST {Endpoint}/face/v1.0/largepersongroups/abc/persons/4caa25ee-3bc6-4e88-adf8-12455ce7aab0/persistedfaces?userData={customized User data}&targetFace=10,10,100,100&detectionModel=detection_01


{
  "url": "{Image Url here}"
}

Sample Response

{
  "persistedFaceId": "6e04c175-219e-42a2-9d26-0e7b790e1ef4"
}

Definizioni

APIError

Informazioni sugli errori restituite dall'API

DetectionModel

Nome del modello di rilevamento. Il modello di rilevamento viene usato per rilevare i visi nell'immagine inviata. È possibile specificare un nome del modello di rilevamento quando si esegue Face - Rileva o (Large)FaceList - Aggiungi viso o (Large)PersonGroup - Aggiungi viso. Il valore predefinito è "detection_01", se è necessario un altro modello, specificarlo in modo esplicito.

Error

Corpo degli errori.

ImageUrl
PersistedFace

Oggetto PersonFace.

APIError

Informazioni sugli errori restituite dall'API

Name Type Description
error

Corpo degli errori.

DetectionModel

Nome del modello di rilevamento. Il modello di rilevamento viene usato per rilevare i visi nell'immagine inviata. È possibile specificare un nome del modello di rilevamento quando si esegue Face - Rileva o (Large)FaceList - Aggiungi viso o (Large)PersonGroup - Aggiungi viso. Il valore predefinito è "detection_01", se è necessario un altro modello, specificarlo in modo esplicito.

Name Type Description
detection_01
  • string
detection_02
  • string
detection_03
  • string

Error

Corpo degli errori.

Name Type Description
code
  • string
message
  • string

ImageUrl

Name Type Description
url
  • string

URL raggiungibile pubblicamente di un'immagine

PersistedFace

Oggetto PersonFace.

Name Type Description
persistedFaceId
  • string

L'oggetto persistedFaceId del viso di destinazione, persistente e non scade. Diverso da faceId creato da Face - Rileva e scade al momento specificato da faceIdTimeToLive dopo la chiamata di rilevamento.

userData
  • string

Dati forniti dall'utente collegati al viso. Il limite di dimensioni è 1 KB.