Face List - Add Face From Stream

Servizio:

Azure AI Services

Versione API:

1.0

Aggiungere un viso a un elenco di visi specificato, fino a 1.000 visi.
Per gestire un'immagine contiene 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 la funzionalità viso estratta verrà archiviata nel server finché non viene chiamato FaceList - Elimina viso o FaceList - Elimina.
Nota persistedFaceId è diverso da faceId generato da Viso - Rileva.

• Qualità dell'immagine del viso più elevata significa una migliore precisione di rilevamento e 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.
• 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 Viso - Rileva, non esiste alcuna garanzia di 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.
• L'aggiunta o l'eliminazione di visi da e verso uno stesso elenco di visi vengono elaborati in sequenza e da/verso elenchi di visi diversi sono in parallelo.
• 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 Come specificare un modello di rilevamento.

POST {Endpoint}/face/v1.0/facelists/{faceListId}/persistedfaces

Con parametri facoltativi:

POST {Endpoint}/face/v1.0/facelists/{faceListId}/persistedfaces?overload=stream&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).
faceListId	path	True	string maxLength: 64 pattern: ^[a-z0-9-_]+$	ID che fa riferimento a un elenco di visi specifico.
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 di modello di rilevamento durante l'esecuzione di Face - Detect o (Large)FaceList - Add Face (Large)PersonGroup - Add Face( Aggiungi viso). Il valore predefinito è "detection_01", se è necessario un altro modello, specificarlo in modo esplicito.
targetFace	query		integer[]	Rettangolo del 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 deve specificare il viso da aggiungere. Nessun targetFace significa che nell'intera immagine è stato rilevato un solo viso.
userData	query		string maxLength: 1024	Dati specificati dall'utente sul viso per qualsiasi scopo. La lunghezza massima è di 1 KB.

Intestazione della richiesta

Media Types: "application/octet-stream"

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

Corpo della richiesta

Media Types: "application/octet-stream"

Nome	Tipo	Descrizione
Image	object (file)	Flusso di immagini.

Risposte

Nome	Tipo	Descrizione
200 OK	PersistedFace	Una chiamata con esito positivo restituisce un nuovo valore persistedFaceId.
Other Status Codes	APIError	Risposta di errore.

Sicurezza

Ocp-Apim-Subscription-Key

Tipo: apiKey
In: header

Esempio

Add face to face list from stream example

Esempio di richiesta

HTTP

POST {Endpoint}/face/v1.0/facelists/sample_face_list/persistedfaces?overload=stream&userData={Customized user data}&targetFace=10,10,100,100&detectionModel=detection_01


"{Image stream in base 64 encoded format}"

Risposta di esempio

Codice di stato:

200

{
  "persistedFaceId": "B8D802CF-DD8F-4E61-B15C-9E6C5844CCBA"
}

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 di modello di rilevamento durante l'esecuzione di Face - Detect o (Large)FaceList - Add Face (Large)PersonGroup - Add Face( Aggiungi viso). Il valore predefinito è "detection_01", se è necessario un altro modello, specificarlo in modo esplicito.
Error	Corpo dell'errore.
PersistedFace	Oggetto PersonFace.

APIError

Object

Informazioni sugli errori restituite dall'API

Nome	Tipo	Descrizione
error	Error	Corpo dell'errore.

DetectionModel

Enumerazione

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

Valore	Descrizione
detection_01
detection_02
detection_03

Error

Object

Corpo dell'errore.

Nome	Tipo	Descrizione
code	string
message	string

PersistedFace

Object

Oggetto PersonFace.

Nome	Tipo	Descrizione
persistedFaceId	string (uuid)	PersistedFaceId del viso di destinazione, che viene salvato in modo permanente e non scadrà. Diverso da faceId creato da Face - Detect e scadrà nel momento specificato da faceIdTimeToLive dopo la chiamata di rilevamento.
userData	string maxLength: 1024	Dati forniti dall'utente collegati al viso. Il limite di dimensioni è 1 KB.