Face List Operations - Add Large Face List Face
Aggiungere un viso a un elenco di facce large specificato, fino a 1.000.000 visi.
Per gestire un'immagine contenente 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 le funzionalità viso estratte verranno archiviate nel server fino a quando non viene chiamato "Elimina viso grande elenco viso" o "Elimina elenco viso grande".
Si noti che persistedFaceId è diverso da faceId generato da "Detect".
-
- Maggiore qualità dell'immagine del viso significa una migliore precisione di 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.
- Ogni voce può contenere fino a 248 visi.
- 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 "Detect", non esiste alcuna garanzia per 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.
- 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 https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-detection-model
Nota
-
- Quota di sottoscrizione a livello gratuito: 1.000 visi per elenco viso di grandi dimensioni.
- Quota di sottoscrizione a livello S0: 1.000.000 visi per elenco viso di grandi dimensioni.
POST {endpoint}/face/{apiVersion}/largefacelists/{largeFaceListId}/persistedfaces
POST {endpoint}/face/{apiVersion}/largefacelists/{largeFaceListId}/persistedfaces?_overload=addLargeFaceListFace&targetFace={targetFace}&detectionModel={detectionModel}&userData={userData}
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://{nome-risorsa}.cognitiveservices.azure.com). |
large
|
path | True |
string |
Il carattere valido è una lettera in lettere minuscole o cifre o '-' o '_', la lunghezza massima è 64. Criterio di espressione regolare: |
detection
|
query |
'detectionModel' associato ai faceId rilevati. I valori 'detectionModel' supportati includono 'detection_01', 'detection_02' e 'detection_03'. Il valore predefinito è 'detection_01'. |
||
target
|
query |
integer[] |
Rettangolo del viso per specificare il viso di destinazione da aggiungere a una persona, nel formato 'targetFace=left,top,width,height'. |
|
user
|
query |
string |
Dati forniti dall'utente collegati al viso. Il limite di dimensioni è 1K. |
Corpo della richiesta
Media Types: "application/octet-stream"
Nome | Tipo | Descrizione |
---|---|---|
imageContent |
string |
Immagine da analizzare |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
Una chiamata con esito positivo restituisce un nuovo valore persistedFaceId. |
|
Other Status Codes |
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
Add Face to LargeFaceList
Esempio di richiesta
POST {endpoint}/face/v1.2-preview.1/largefacelists/your_large_face_list_id/persistedfaces?_overload=addLargeFaceListFace&targetFace=10,10,100,100&detectionModel=detection_01&userData=your_user_data
"<your-image-bytes-here>"
Risposta di esempio
{
"persistedFaceId": "43897a75-8d6f-42cf-885e-74832febb055"
}
Definizioni
Nome | Descrizione |
---|---|
Add |
Corpo della risposta per l'aggiunta del viso. |
Detection |
'detectionModel' associato ai faceId rilevati. I valori 'detectionModel' supportati includono 'detection_01', 'detection_02' e 'detection_03'. Il valore predefinito è 'detection_01'. |
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. |
AddFaceResult
Corpo della risposta per l'aggiunta del viso.
Nome | Tipo | Descrizione |
---|---|---|
persistedFaceId |
string |
L'ID viso persistente del viso aggiunto, che viene salvato in modo permanente e non scadrà. Diverso da faceId creato in "Rileva" e scadrà in 24 ore dopo la chiamata di rilevamento. |
DetectionModel
'detectionModel' associato ai faceId rilevati. I valori 'detectionModel' supportati includono 'detection_01', 'detection_02' e 'detection_03'. Il valore predefinito è 'detection_01'.
Nome | Tipo | Descrizione |
---|---|---|
detection_01 |
string |
Modello di rilevamento predefinito. Consigliato per il rilevamento dei visi quasi frontali. Per scenari con visi ad angolo estremamente grande (posizione della testa), volti occlusi o orientamento errato dell'immagine, i visi in tali casi potrebbero non essere rilevati. |
detection_02 |
string |
Modello di rilevamento rilasciato nel 2019 maggio con una maggiore precisione soprattutto sui visi piccoli, laterali e sfocati. |
detection_03 |
string |
Modello di rilevamento rilasciato nel 2021 febbraio con una maggiore accuratezza soprattutto sui visi piccoli. |
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. |