Face Recognition Operations - Group
Rozdělte kandidátské tváře do skupin na základě podobnosti tváře.
-
- Výstupem je jedna nebo více oddělených skupin tváří a messyGroup. Skupina tváří obsahuje tváře, které mají podobné vzhled, často stejné osoby. Skupiny tváří jsou seřazené podle velikosti skupiny, tj. počtu tváří. Všimněte si, že ve výsledku můžou být tváře patřící stejné osobě rozdělené do několika skupin.
- MessyGroup je speciální skupina tváří obsahující tváře, které nemohou najít žádnou podobnou protějškovou tvář z původních tváří. MessyGroup se ve výsledku nezobrazí, pokud všechny tváře našly své protějšky.
- Rozhraní API skupiny potřebuje minimálně 2 kandidátské tváře a maximálně 1 000. Doporučujeme vyzkoušet možnost Ověřit tvář na tvář, pokud máte pouze 2 kandidátské tváře.
- Identifikátory faceId výrazu recognitionModel přidružené k tvářím dotazu by měly být stejné.
POST {endpoint}/face/{apiVersion}/group
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
api
|
path | True |
string |
Verze rozhraní API |
endpoint
|
path | True |
string uri |
Podporované koncové body služeb Cognitive Services (protokol a název hostitele, například: https://{název_prostředku}.cognitiveservices.azure.com). |
Name | Vyžadováno | Typ | Description |
---|---|---|---|
faceIds | True |
string[] |
Pole kandidátských faceId vytvořených funkcí Detect Maximum je 1 000 tváří. |
Name | Typ | Description |
---|---|---|
200 OK |
Úspěšné volání vrátí jednu nebo více skupin podobných tváří (podle velikosti skupiny) a messyGroup. |
|
Other Status Codes |
Neočekávaná chybová odpověď Hlavičky x-ms-error-code: string |
Tajný klíč předplatného Azure AI Face.
Typ:
apiKey
V:
header
Tok Azure Active Directory OAuth2
Typ:
oauth2
Tok:
accessCode
URL autorizace:
https://api.example.com/oauth2/authorize
URL tokenu:
https://api.example.com/oauth2/token
Name | Description |
---|---|
https://cognitiveservices.azure.com/.default |
Ukázkový požadavek
POST {endpoint}/face/v1.2-preview.1/group
{
"faceIds": [
"c5c24a82-6845-4031-9d5d-978df9175426",
"015839fb-fbd9-4f79-ace9-7675fc2f1dd9",
"65d083d4-9447-47d1-af30-b626144bf0fb",
"fce92aed-d578-4d2e-8114-068f8af4492e",
"30ea1073-cc9e-4652-b1e3-d08fb7b95315",
"be386ab3-af91-4104-9e6d-4dae4c9fddb7",
"fbd2a038-dbff-452c-8e79-2ee81b1aa84e",
"b64d5e15-8257-4af2-b20a-5a750f8940e7"
]
}
Ukázková odpověď
{
"groups": [
[
"c5c24a82-6845-4031-9d5d-978df9175426",
"015839fb-fbd9-4f79-ace9-7675fc2f1dd9",
"fce92aed-d578-4d2e-8114-068f8af4492e",
"b64d5e15-8257-4af2-b20a-5a750f8940e7"
],
[
"65d083d4-9447-47d1-af30-b626144bf0fb",
"30ea1073-cc9e-4652-b1e3-d08fb7b95315"
]
],
"messyGroup": [
"be386ab3-af91-4104-9e6d-4dae4c9fddb7",
"fbd2a038-dbff-452c-8e79-2ee81b1aa84e"
]
}
Name | Description |
---|---|
Face |
Objekt chyby. Podrobné informace o kódech chyb a zprávách vrácených službou Rozpoznávání tváře najdete na následujícím odkazu: https://aka.ms/face-error-codes-and-messages. |
Face |
Odpověď obsahující podrobnosti o chybě. |
Grouping |
Text odpovědi pro operaci skupinové tváře. |
Objekt chyby. Podrobné informace o kódech chyb a zprávách vrácených službou Rozpoznávání tváře najdete na následujícím odkazu: https://aka.ms/face-error-codes-and-messages.
Name | Typ | Description |
---|---|---|
code |
string |
Jedna ze serverově definovaných kódů chyb. |
message |
string |
Čitelné znázornění chyby člověkem. |
Odpověď obsahující podrobnosti o chybě.
Name | Typ | Description |
---|---|---|
error |
Objekt chyby. |
Text odpovědi pro operaci skupinové tváře.
Name | Typ | Description |
---|---|---|
groups |
string[] |
Oddíl původních tváří na základě podobnosti tváře. Skupiny jsou seřazené podle počtu tváří. |
messyGroup |
string[] |
Id tváře pole tváří, které nemohou najít žádné podobné tváře z původních tváří. |