Face Recognition Operations - Find Similar

Tjänst:

Azure AI Services

API-version:

v1.2-preview.1

Med tanke på frågeansiktets faceId kan du söka i liknande ansikten från en faceId-matris. En faceId-matris innehåller de ansikten som skapats av Detect.
Beroende på indata innehåller den returnerade liknande ansiktslistan faceIds eller persistedFaceIds rangordnade efter likhet.

Hitta liknande har två arbetslägen, "matchPerson" och "matchFace". "matchPerson" är standardläget som det försöker hitta ansikten för samma person som möjligt med hjälp av interna tröskelvärden för samma person. Det är användbart att hitta en känd persons andra foton. Observera att en tom lista returneras om inga ansikten passerar de interna tröskelvärdena. "matchFace"-läget ignorerar tröskelvärden för samma person och returnerar rankade liknande ansikten ändå, även likheten är låg. Det kan användas i fall som att söka i kändisliknande ansikten.

Den "recognitionModel" som är associerad med frågan faceId ska vara samma som "recognitionModel" som används av mål-faceId-matrisen.

POST {endpoint}/face/{apiVersion}/findsimilars

URI-parametrar

Name	I	Obligatorisk	Typ	Description
apiVersion	path	True	string	API-version
endpoint	path	True	string uri	Cognitive Services-slutpunkter som stöds (protokoll och värdnamn, till exempel: https://{resource-name}.cognitiveservices.azure.com).

Begärandetext

Name	Obligatorisk	Typ	Description
faceId	True	string	faceId för frågeigenkänningen. Användaren måste anropa "Detect" först för att få ett giltigt faceId. Observera att det här faceId:et inte sparas och upphör att gälla 24 timmar efter identifieringsanropet.
faceIds	True	string[]	En matris med ansikts-ID:er för kandidater. Alla skapas av "Detect" och faceIds upphör att gälla 24 timmar efter identifieringsanropet. Antalet faceId är begränsat till 1 000.
maxNumOfCandidatesReturned		integer	Antalet liknande ansikten som returneras. Det giltiga intervallet är [1, 1000]. Standardvärdet är 20.
mode		FindSimilarMatchMode	Liknande ansiktssökningsläge. Det kan vara "matchPerson" eller "matchFace". Standardvärdet är "matchPerson".

Svar

Name	Typ	Description
200 OK	FindSimilarResult[]	Ett lyckat anrop returnerar en matris med de mest liknande ansikten som representeras i faceId om indataparametern är faceIds eller persistedFaceId om indataparametern är faceListId eller largeFaceListId.
Other Status Codes	FaceErrorResponse	Ett oväntat felsvar. Sidhuvuden x-ms-error-code: string

Säkerhet

Ocp-Apim-Subscription-Key

Den hemliga nyckeln för din Azure AI Face-prenumeration.

Typ: apiKey
I: header

AADToken

The Azure Active Directory OAuth2 Flow

Typ: oauth2
Flow: accessCode
Auktoriseringswebbadress: https://api.example.com/oauth2/authorize
Token-webbadress: https://api.example.com/oauth2/token

Omfattningar

Name	Description
https://cognitiveservices.azure.com/.default

Exempel

Find Similar among Face IDs

Exempelbegäran

HTTP

POST {endpoint}/face/v1.2-preview.1/findsimilars

{
  "faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
  "maxNumOfCandidatesReturned": 3,
  "mode": "matchPerson",
  "faceIds": [
    "015839fb-fbd9-4f79-ace9-7675fc2f1dd9",
    "be386ab3-af91-4104-9e6d-4dae4c9fddb7"
  ]
}

Exempelsvar

Statuskod:

200

[
  {
    "confidence": 0.9,
    "persistedFaceId": "015839fb-fbd9-4f79-ace9-7675fc2f1dd9"
  }
]

Definitioner

Name	Description
FaceError	Felobjektet. Mer information om felkoder och meddelanden som returneras av ansiktstjänsten finns i följande länk: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Ett svar som innehåller felinformation.
FindSimilarResult	Svarstext för att hitta liknande ansiktsoperation.

FaceError

Felobjektet. Mer information om felkoder och meddelanden som returneras av ansiktstjänsten finns i följande länk: https://aka.ms/face-error-codes-and-messages.

Name	Typ	Description
code	string	En av en serverdefinierad uppsättning felkoder.
message	string	En mänsklig läsbar representation av felet.

FaceErrorResponse

Ett svar som innehåller felinformation.

Name	Typ	Description
error	FaceError	Felobjektet.

FindSimilarResult

Svarstext för att hitta liknande ansiktsoperation.

Name	Typ	Description
confidence	number	Förtroendevärde för kandidaten. Ju högre konfidens, desto mer lika. Intervall mellan [0,1].
faceId	string	faceId för kandidat ansikte när hitta av faceIds. faceId skapas av "Detect" och upphör att gälla 24 timmar efter identifieringsanropet.
persistedFaceId	string	persistedFaceId för kandidatansikte när det hittas av faceListId eller largeFaceListId. persistedFaceId i ansiktslistan/den stora ansiktslistan sparas och upphör inte att gälla.