Person Group Operations - Create Person Group

Service:

Azure AI Services

API Version:

v1.1-preview.1

Create un nuovo gruppo person con personGroupId specificato, nome, userData e recognitionModel forniti dall'utente.
Un gruppo di persone è un contenitore che contiene i dati delle persone caricate, incluse le funzionalità di riconoscimento del viso.

Dopo la creazione, usare "Create Person Group Person" per aggiungere persone al gruppo e quindi chiamare "Train Person Group" per ottenere questo gruppo pronto per "Identifica dal gruppo persona".

Nessuna immagine verrà archiviata. Solo le funzionalità del viso estratte dalla persona e userData verranno archiviate nel server fino a quando non viene chiamato "Elimina persona gruppo di persone" o "Elimina gruppo persona".

'recognitionModel' deve essere specificato per associare questo gruppo di persone. Il valore predefinito per 'recognitionModel' è 'recognition_01', se il modello più recente necessario, specificare in modo esplicito il modello necessario in questo parametro. I nuovi visi aggiunti a un gruppo person esistente useranno il modello di riconoscimento già associato alla raccolta. Le funzionalità viso esistenti in un gruppo di persone non possono essere aggiornate alle funzionalità estratte da un'altra versione del modello di riconoscimento.

Nota

• • Quota di sottoscrizione a livello gratuito: 1.000 persone Gruppi. Ognuno tiene fino a 1.000 persone.
  • Quota di sottoscrizione a livello S0: 1.000.000 persone Gruppi. Ognuno tiene fino a 10.000 persone.
  • per gestire un problema di identificazione del viso su larga scala, prendere in considerazione l'uso di Large Person Group.

PUT {endpoint}/face/{apiVersion}/persongroups/{personGroupId}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
apiVersion	path	True	string	Versione API
endpoint	path	True	string uri	Endpoint di Servizi cognitivi supportati (protocollo e nome host, ad esempio: https://{resource-name}.cognitiveservices.azure.com).
personGroupId	path	True	string	ID del contenitore. Regex pattern: ^[a-z0-9-_]+$

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
name	True	string	Nome definito dall'utente, lunghezza massima è 128.
recognitionModel		RecognitionModel	'recognitionModel' associato a questo elenco di volti. I valori 'recognitionModel' supportati includono 'recognition_01', 'recognition_02, 'recognition_03' e 'recognition_04'. Il valore predefinito è 'recognition_01'. "recognition_04" è consigliato poiché la sua accuratezza è migliorata sui volti che indossano maschere rispetto a "recognition_03" e la sua accuratezza complessiva è migliorata rispetto a "recognition_01" e "recognition_02".
userData		string	Dati definiti dall'utente facoltativi. La lunghezza non deve superare 16K.

Risposte

Nome	Tipo	Descrizione
200 OK		La richiesta ha avuto esito positivo.
Other Status Codes	FaceErrorResponse	Risposta di errore imprevista. Headers x-ms-error-code: string

Sicurezza

Ocp-Apim-Subscription-Key

Chiave privata per la sottoscrizione di Azure AI Face.

Type: apiKey
In: header

AADToken

Flusso OAuth2 di Azure Active Directory

Type: oauth2
Flow: accessCode
Authorization URL: https://api.example.com/oauth2/authorize
Token URL: https://api.example.com/oauth2/token

Scopes

Nome	Descrizione
https://cognitiveservices.azure.com/.default

Esempio

Create PersonGroup

Sample Request

HTTP

PUT {endpoint}/face/v1.1-preview.1/persongroups/your_person_group_id

{
  "name": "your_person_group_name",
  "userData": "your_user_data",
  "recognitionModel": "recognition_01"
}

Sample Response

Status code:

200

Definizioni

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

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.

Nome	Tipo	Descrizione
code	string	Uno di un set definito dal server di codici di errore.
message	string	Rappresentazione leggibile dell'errore.

FaceErrorResponse

Risposta contenente i dettagli dell'errore.

Nome	Tipo	Descrizione
error	FaceError	Oggetto error.