Face List Operations - Add Face List Face
Dodaj twarz do określonej listy twarzy, maksymalnie 1000 twarzy.
Aby poradzić sobie z obrazem zawierającym wiele twarzy, można określić twarz wejściową jako obraz z prostokątem targetFace. Zwraca on utrwalonego identyfikatoraFaceId reprezentującego dodaną twarz. Nie będzie przechowywany żaden obraz. Tylko wyodrębnione funkcje twarzy będą przechowywane na serwerze do momentu wywołania "Usuń twarz na liście twarzy" lub "Usuń listę twarzy".
Należy pamiętać, że identyfikator persistedFaceId różni się od identyfikatora faceId wygenerowanego przez element "Detect".
-
- Wyższa jakość obrazu twarzy oznacza lepszą precyzję rozpoznawania. Należy wziąć pod uwagę wysokiej jakości twarze: przednie, jasne i rozmiar twarzy to 200 x 200 pikseli (100 pikseli między oczami) lub większy.
- Każdy wpis osoby może pomieścić maksymalnie 248 twarzy.
- Obsługiwane są formaty JPEG, PNG, GIF (pierwsza ramka) i BMP. Dozwolony rozmiar pliku obrazu wynosi od 1 KB do 6 MB.
- Prostokąt "targetFace" powinien zawierać jedną twarz. Zero lub wiele twarzy zostanie uznanych za błąd. Jeśli podany prostokąt "targetFace" nie jest zwracany z "Detect", nie ma gwarancji, że można pomyślnie wykryć i dodać twarz.
- Poza wykrywalnym rozmiarem twarzy (36x36 - 4096x4096 pikseli), dużą pozę głowy lub duże okluzji spowodują awarie.
- Minimalny rozmiar twarzy wykrywalnej to 36 x 36 pikseli na obrazie nie większym niż 1920 x 1080 pikseli. Obrazy o wymiarach wyższych niż 1920 x 1080 pikseli będą potrzebować proporcjonalnie większego minimalnego rozmiaru twarzy.
- Można podać różne wartości "detectionModel". Aby użyć i porównać różne modele wykrywania, zapoznaj się z tematem https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-detection-model
POST {endpoint}/face/{apiVersion}/facelists/{faceListId}/persistedfaces
POST {endpoint}/face/{apiVersion}/facelists/{faceListId}/persistedfaces?_overload=addFaceListFace&targetFace={targetFace}&detectionModel={detectionModel}&userData={userData}
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
api
|
path | True |
string |
Wersja interfejsu API |
endpoint
|
path | True |
string uri |
Obsługiwane punkty końcowe usług Cognitive Services (protokół i nazwa hosta, na przykład: https://{nazwa-zasobu}.cognitiveservices.azure.com). |
face
|
path | True |
string |
Prawidłowy znak to litera w małych literach, cyfrach lub znakach "-" lub "_", maksymalna długość to 64. Regex pattern: |
detection
|
query |
Element "detectionModel" skojarzony z wykrytymi identyfikatorami faceId. Obsługiwane wartości "detectionModel" obejmują "detection_01", "detection_02" i "detection_03". Wartość domyślna to "detection_01". |
||
target
|
query |
integer[] |
Prostokąt twarzy określający docelową twarz do dodania do osoby w formacie "targetFace=left,top,width,height". |
|
user
|
query |
string |
Dane dostarczone przez użytkownika dołączone do twarzy. Limit rozmiaru to 1K. |
Treść żądania
Media Types: "application/octet-stream"
Nazwa | Typ | Opis |
---|---|---|
imageContent |
string |
Obraz do przeanalizowania |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
Pomyślne wywołanie zwraca nowy utrwaloneFaceId. |
|
Other Status Codes |
Nieoczekiwana odpowiedź na błąd. Headers x-ms-error-code: string |
Zabezpieczenia
Ocp-Apim-Subscription-Key
Klucz tajny subskrypcji rozpoznawania twarzy usługi Azure AI.
Type:
apiKey
In:
header
AADToken
Przepływ OAuth2 usługi Azure Active Directory
Type:
oauth2
Flow:
accessCode
Authorization URL:
https://api.example.com/oauth2/authorize
Token URL:
https://api.example.com/oauth2/token
Scopes
Nazwa | Opis |
---|---|
https://cognitiveservices.azure.com/.default |
Przykłady
Add Face to FaceList
Sample Request
POST {endpoint}/face/v1.1-preview.1/facelists/your_face_list_id/persistedfaces?_overload=addFaceListFace&targetFace=10,10,100,100&detectionModel=detection_01&userData=your_user_data
"<your-image-bytes-here>"
Sample Response
{
"persistedFaceId": "43897a75-8d6f-42cf-885e-74832febb055"
}
Definicje
Nazwa | Opis |
---|---|
Add |
Treść odpowiedzi na potrzeby dodawania twarzy. |
Detection |
Element "detectionModel" skojarzony z wykrytymi identyfikatorami faceId. Obsługiwane wartości "detectionModel" obejmują "detection_01", "detection_02" i "detection_03". Wartość domyślna to "detection_01". |
Face |
Obiekt error. Aby uzyskać szczegółowe informacje na temat kodów błędów i komunikatów zwracanych przez usługę rozpoznawania twarzy, skorzystaj z następującego linku: https://aka.ms/face-error-codes-and-messages. |
Face |
Odpowiedź zawierająca szczegóły błędu. |
AddFaceResult
Treść odpowiedzi na potrzeby dodawania twarzy.
Nazwa | Typ | Opis |
---|---|---|
persistedFaceId |
string |
Utrwalone face ID dodanej twarzy, która jest utrwalone i nie wygaśnie. Różni się od identyfikatora faceId utworzonego w funkcji "Wykryj" i wygaśnie w ciągu 24 godzin po wywołaniu wykrywania. |
DetectionModel
Element "detectionModel" skojarzony z wykrytymi identyfikatorami faceId. Obsługiwane wartości "detectionModel" obejmują "detection_01", "detection_02" i "detection_03". Wartość domyślna to "detection_01".
Nazwa | Typ | Opis |
---|---|---|
detection_01 |
string |
Domyślny model wykrywania. Zaleca się wykrywanie twarzy niemal przedniej. W przypadku scenariuszy z wyjątkowo dużym kątem (pozy głowy) twarze, occluded twarze lub niewłaściwa orientacja obrazu, twarze w takich przypadkach mogą nie zostać wykryte. |
detection_02 |
string |
Model wykrywania wydany w maju 2019 r. z lepszą dokładnością szczególnie na małych, bocznych i rozmytych twarzach. |
detection_03 |
string |
Model wykrywania wydany w 2021 r. w lutym 2021 r. z lepszą dokładnością szczególnie na małych twarzach. |
FaceError
Obiekt error. Aby uzyskać szczegółowe informacje na temat kodów błędów i komunikatów zwracanych przez usługę rozpoznawania twarzy, skorzystaj z następującego linku: https://aka.ms/face-error-codes-and-messages.
Nazwa | Typ | Opis |
---|---|---|
code |
string |
Jeden z zdefiniowanych przez serwer zestaw kodów błędów. |
message |
string |
Czytelna dla człowieka reprezentacja błędu. |
FaceErrorResponse
Odpowiedź zawierająca szczegóły błędu.
Nazwa | Typ | Opis |
---|---|---|
error |
Obiekt error. |