Face Recognition Operations - Identify From Person Group
Egy-a-többhöz azonosítás az adott lekérdezési személy arcának legközelebbi egyezéseinek megkereséséhez egy személycsoportból.
A faceIds tömb minden egyes arcához a Face Identify kiszámítja a hasonlóságokat a lekérdezési arc és a Személy csoport összes arca között (a personGroupId alapján), és visszaadja az adott archoz tartozó jelölt személy(ek)et a hasonlóság megbízhatósága alapján rangsorolva. A személycsoportot be kell tanítani, hogy készen álljon az azonosításra. További információt a "Személycsoport betanítása" című témakörben talál.
Megjegyzés
-
- Az algoritmus lehetővé teszi több arc önálló azonosítását ugyanabban a kérelemben, de legfeljebb 10 arcot.
- Minden személynek több arca lehet, de legfeljebb 248 arc.
- A jobb arcképminőség jobb azonosítási pontosságot jelent. Vegye figyelembe a kiváló minőségű arcokat: előtérbeli, világos és arcmérete 200x200 képpont (100 képpont a szemek között) vagy nagyobb.
- A visszaadott jelöltek számát a maxNumOfCandidatesReturned és a confidenceThreshold korlátozza. Ha senki sem azonosítható, a visszaadott jelöltek üres tömbök lesznek.
- Próbálja ki a "Hasonló keresése" elemet, ha egy személycsoport helyett arclistából/nagy arclistából kell hasonló arcokat találnia.
- A lekérdezési arcok faceId-jeihez társított "recognitionModel" azonosítónak meg kell egyeznie a célszemélycsoport által használt "recognitionModel" azonosítóval.
POST {endpoint}/face/{apiVersion}/identify
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
api
|
path | True |
string |
API-verzió |
endpoint
|
path | True |
string uri |
Támogatott Cognitive Services-végpontok (protokoll és állomásnév, például: https://{resource-name}.cognitiveservices.azure.com). |
Kérelem törzse
Name | Kötelező | Típus | Description |
---|---|---|---|
faceIds | True |
string[] |
A "Detect" által létrehozott faceIds lekérdezési arcok tömbje. A rendszer minden arcot egymástól függetlenül azonosít. A faceIds érvényes száma [1, 10] között van. |
personGroupId | True |
string |
a célszemélycsoport personGroupId azonosítója, amelyet a "Létrehozás Személycsoport" hozott létre. A personGroupId paramétert és a largePersonGroupId paramétert nem szabad egyszerre megadni. |
confidenceThreshold |
number |
Személyre szabott azonosítási megbízhatósági küszöbérték a(z) [0, 1] tartományban. A haladó felhasználók ezt az értéket úgy módosíthatják, hogy felülbírálják az alapértelmezett belső küszöbértéket a forgatókönyv adatainak jobb pontossága érdekében. Vegye figyelembe, hogy nincs garancia arra, hogy ez a küszöbérték más adatokon és algoritmusfrissítések után is működik. |
|
maxNumOfCandidatesReturned |
integer |
A maxNumOfCandidatesReturned tartománya 1 és 100 között van. Az alapértelmezett érték 10. |
Válaszok
Name | Típus | Description |
---|---|---|
200 OK |
A sikeres hívás minden lekérdezési archoz visszaadja az azonosított személy(ek)et. |
|
Other Status Codes |
Váratlan hibaválasz. Headers x-ms-error-code: string |
Biztonság
Ocp-Apim-Subscription-Key
Az Azure AI Face-előfizetés titkos kulcsa.
Type:
apiKey
In:
header
AADToken
Az Azure Active Directory OAuth2 flow
Type:
oauth2
Flow:
accessCode
Authorization URL:
https://api.example.com/oauth2/authorize
Token URL:
https://api.example.com/oauth2/token
Scopes
Name | Description |
---|---|
https://cognitiveservices.azure.com/.default |
Példák
Identify from PersonGroup
Sample Request
POST {endpoint}/face/v1.1-preview.1/identify
{
"faceIds": [
"c5c24a82-6845-4031-9d5d-978df9175426"
],
"personGroupId": "your_person_group_id",
"maxNumOfCandidatesReturned": 9,
"confidenceThreshold": 0.7
}
Sample Response
[
{
"faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
"candidates": [
{
"personId": "85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5",
"confidence": 0.8
}
]
}
]
Definíciók
Name | Description |
---|---|
Face |
A hibaobjektum. A Face Service által visszaadott hibakódokkal és üzenetekkel kapcsolatos átfogó részletekért tekintse meg a következő hivatkozást: https://aka.ms/face-error-codes-and-messages. |
Face |
Hibaadatokat tartalmazó válasz. |
Identification |
A hívás azonosítására jelölt. |
Identification |
Az eredmény azonosítása. |
FaceError
A hibaobjektum. A Face Service által visszaadott hibakódokkal és üzenetekkel kapcsolatos átfogó részletekért tekintse meg a következő hivatkozást: https://aka.ms/face-error-codes-and-messages.
Name | Típus | Description |
---|---|---|
code |
string |
A kiszolgáló által definiált hibakódok egyike. |
message |
string |
A hiba emberi olvasásra alkalmas ábrázolása. |
FaceErrorResponse
Hibaadatokat tartalmazó válasz.
Name | Típus | Description |
---|---|---|
error |
A hibaobjektum. |
IdentificationCandidate
A hívás azonosítására jelölt.
Name | Típus | Description |
---|---|---|
confidence |
number |
A jelölt megbízhatósági értéke. Minél nagyobb a bizalom, annál hasonlóbb. [0,1] közötti tartomány. |
personId |
string |
a jelölt személy azonosítója. |
IdentificationResult
Az eredmény azonosítása.
Name | Típus | Description |
---|---|---|
candidates |
Az adott arcra jelölt személy (megbízhatóság alapján rangsorolva). A tömb mérete nem lehet nagyobb, mint a maxNumOfCandidatesReturned bemeneti érték. Ha nincs személy azonosítva, üres tömböt ad vissza. |
|
faceId |
string |
a lekérdezési arc faceId azonosítója. |