Person Group Operations - Create Large Person Group
Create un nuovo gruppo large person con largePersonGroupId specificato dall'utente, nome, nome utente facoltativoData e riconoscimentoModel.
Un gruppo di persone di grandi dimensioni è un contenitore che contiene i dati delle persone caricate, incluse le funzionalità di riconoscimento del viso. Può contenere fino a 1.000.000 entità.
Dopo la creazione, usare "Create Large Person Group Person person" (Gruppo di persone di grandi dimensioni) e chiamare "Train Large Person Group" (Train Large Person Group) per preparare questo gruppo per l'identificazione da un gruppo di persone di grandi dimensioni.
Nessuna immagine verrà archiviata. Solo le funzionalità del viso estratte dalla persona e userData verranno archiviate nel server fino a quando non viene chiamato "Delete Large Person Group Person" o "Delete Large Person Group".
'recognitionModel' deve essere specificato per associare questo gruppo di persone di grandi dimensioni. 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 Large Person esistente useranno il modello di riconoscimento già associato alla raccolta. Non è possibile aggiornare le funzionalità del viso esistenti in un gruppo di persone di grandi dimensioni alle funzionalità estratte da un'altra versione del modello di riconoscimento.
Nota
-
- Quota di sottoscrizione a livello gratuito: 1.000 large person Gruppi.
- Quota di sottoscrizione a livello S0: 1.000.000 Gruppi large person.
PUT {endpoint}/face/{apiVersion}/largepersongroups/{largePersonGroupId}
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
api
|
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). |
large
|
path | True |
string |
ID del contenitore. Criterio di espressione regolare: |
Corpo della richiesta
Nome | Necessario | Tipo | Descrizione |
---|---|---|---|
name | True |
string |
Nome definito dall'utente, lunghezza massima è 128. |
recognitionModel |
Recognition |
'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 |
Risposta di errore imprevista. Intestazioni x-ms-error-code: string |
Sicurezza
Ocp-Apim-Subscription-Key
Chiave privata per la sottoscrizione di Azure AI Face.
Tipo:
apiKey
In:
header
AADToken
Flusso OAuth2 di Azure Active Directory
Tipo:
oauth2
Flow:
accessCode
URL di autorizzazione:
https://api.example.com/oauth2/authorize
URL token:
https://api.example.com/oauth2/token
Ambiti
Nome | Descrizione |
---|---|
https://cognitiveservices.azure.com/.default |
Esempio
Create LargePersonGroup
Esempio di richiesta
PUT {endpoint}/face/v1.1-preview.1/largepersongroups/your_large_person_group_id
{
"name": "your_large_person_group_name",
"userData": "your_user_data",
"recognitionModel": "recognition_01"
}
Risposta di esempio
Definizioni
Nome | Descrizione |
---|---|
Face |
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. |
Face |
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 |
Oggetto error. |