Face List Operations - Create Large Face List

  • Riferimento
Servizio:
Azure AI Services
Versione API:
v1.2-preview.1

Creare un elenco di visi grandi vuoto con un valore largeFaceListId specificato dall'utente, un nome, un userData e recognitionModel facoltativo.
Elenco di visi di grandi dimensioni è un elenco di visi, fino a 1.000.000 visi e usato da "Trova simili da un elenco di volti di grandi dimensioni".

Dopo la creazione, l'utente deve usare Add Large Face List Face Per importare i visi e Train Large Face List per prepararlo per "Trova simile". Nessuna immagine verrà archiviata. Solo le funzionalità viso estratte verranno archiviate nel server fino a quando non viene chiamato Delete Large Face List.

"Trova simile" viene usato per scenari come la ricerca di visi simili a celebrità, un filtro del viso simile o come identificazione leggera del viso. Tuttavia, se l'uso effettivo consiste nell'identificare la persona, usare Person Group/Large Person Group e "Identify".

Nota

    • Quota di sottoscrizione a livello gratuito: 64 elenchi di visi di grandi dimensioni.
    • Quota di sottoscrizione a livello S0: 1.000.000 elenchi di volti di grandi dimensioni.
PUT {endpoint}/face/{apiVersion}/largefacelists/{largeFaceListId}

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://{nome-risorsa}.cognitiveservices.azure.com).
largeFaceListId
 path True

string

Il carattere valido è una lettera in lettere minuscole o cifre o '-' o '_', la lunghezza massima è 64.

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

Corpo della richiesta

Nome Necessario Tipo Descrizione
name True

string

Il nome definito dall'utente, la lunghezza massima è 128.
recognitionModel

RecognitionModel

'recognitionModel' associato a questo elenco di visi. I valori 'recognitionModel' supportati includono 'recognition_01', 'recognition_02, 'recognition_03' e 'recognition_04'. Il valore predefinito è 'recognition_01'. È consigliabile "recognition_04" perché 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 facoltativi definiti dall'utente. La lunghezza non deve superare 16.000.

Risposte

Nome Tipo Descrizione
200 OK

La richiesta ha avuto esito positivo.
Other Status Codes

FaceErrorResponse

Risposta di errore imprevista.

Intestazioni

x-ms-error-code: string

Sicurezza

Ocp-Apim-Subscription-Key

Chiave privata per la sottoscrizione di Viso di Intelligenza artificiale di Azure.

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 LargeFaceList

Esempio di richiesta

PUT {endpoint}/face/v1.2-preview.1/largefacelists/your_large_face_list_id

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

Risposta di esempio

Codice di stato:
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.