Large Person Group Person - Add Face From Url

Service:

Cognitive Services - Face

API Version:

1.0

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.

• La qualità dell'immagine del viso superiore 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 più grandi.
• 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

With optional parameters:

POST {Endpoint}/face/v1.0/largepersongroups/{largePersonGroupId}/persons/{personId}/persistedfaces?userData={userData}&targetFace={targetFace}&detectionModel={detectionModel}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
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		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.
targetFace	query		integer[]	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

Nome	Necessario	Tipo	Descrizione
Ocp-Apim-Subscription-Key	True	string

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
url	True	string	URL raggiungibile pubblicamente di un'immagine

Risposte

Nome	Tipo	Descrizione
200 OK	PersistedFace	Una chiamata con esito positivo restituisce il nuovo carattere permanenteFaceId.
Other Status Codes	APIError	Risposta di errore.

Sicurezza

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Esempio

Add Person face example

Sample Request

HTTP

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

Status code:

200

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

Definizioni

Nome	Descrizione
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

Nome	Tipo	Descrizione
error	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.

Nome	Tipo	Descrizione
detection_01	string
detection_02	string
detection_03	string

Error

Corpo degli errori.

Nome	Tipo	Descrizione
code	string
message	string

ImageUrl

Nome	Tipo	Descrizione
url	string	URL raggiungibile pubblicamente di un'immagine

PersistedFace

Oggetto PersonFace.

Nome	Tipo	Descrizione
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.