Condividi tramite


Face List - Add Face From Stream

Aggiungere un viso a un elenco di volti 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 oggetto persistedFaceId che rappresenta il viso aggiunto. Nessuna immagine verrà archiviata. Solo la funzionalità viso estratta verrà archiviata nel server fino a quando non viene chiamato FaceList - Delete Face o FaceList.
Nota persistentedFaceId è diverso da faceId generato da Face - Detect.

  • La qualità dell'immagine del viso più elevata significa una migliore precisione di rilevamento e 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.
  • 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 uno stesso elenco di volti vengono elaborati in sequenza e verso/da elenchi di volti diversi sono 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/facelists/{faceListId}/persistedfaces
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

Id che fa riferimento a un determinato elenco di volti.

Criterio di espressione regolare: ^[a-z0-9-_]+$

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

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

Flusso di immagini.

Risposte

Nome Tipo Descrizione
200 OK

PersistedFace

Una chiamata con esito positivo restituisce un nuovo oggettoFaceId persistente.

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

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

{
  "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 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.

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

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.