Person Directory Operations - Add Person Face From Url

Služba:

Azure AI Services

Verze rozhraní API:

v1.2-preview.1

Přidejte tvář k osobě (viz Adresář osob "Vytvořit osobu") pro identifikaci tváře nebo ověření.
Pokud chcete pracovat s obrázkem obsahujícím více tváří, je možné vstupní tvář zadat jako obrázek s obdélníkem targetFace. Vrátí trvaléFaceId představující přidanou tvář. Neuloží se žádná image. Na serveru budou uloženy pouze extrahované funkce tváře, dokud se nevolá adresář person "Odstranit tvář osoby" nebo "Odstranit osobu".

Upozorňujeme, že trvaléFaceId se liší od faceId vygenerovaného výrazem Detect.

• • Vyšší kvalita obrazu tváře znamená lepší přesnost rozpoznávání. Zvažte vysoce kvalitní tváře: přední, jasný a velikost obličeje je 200 × 200 pixelů (100 pixelů mezi očima) nebo větší.
  • Každá položka osoby může obsahovat až 248 tváří.
  • Podporuje se formát JPEG, PNG, GIF (první snímek) a BMP. Povolená velikost souboru obrázku je od 1 kB do 6 MB.
  • Obdélník "targetFace" by měl obsahovat jednu tvář. Nula nebo více tváří se považuje za chybu. Pokud zadaný obdélník "targetFace" není vrácen z funkce Zjistit, neexistuje žádná záruka, že by bylo zjištěno a úspěšně přidáno tvář.
  • Z zjistitelné velikosti tváře (36x36 – 4096 × 4096 pixelů), velké pozice hlavy nebo velké okluze způsobí selhání.
  • Minimální zjistitelná velikost obličeje je 36 × 36 pixelů na obrázku, který není větší než 1920 × 1080 pixelů. Obrázky s rozměry vyššími než 1920 × 1080 pixelů budou potřebovat proporcionálně větší minimální velikost obličeje.
  • Je možné zadat různé hodnoty detectionModel. Pokud chcete použít a porovnat různé modely detekce, projděte si https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-detection-model
• • Přidávání a odstraňování tváří ze stejné osoby se bude zpracovávat postupně. Přidávání a odstraňování tváří z různých osob se zpracovává paralelně.
  • Jedná se o dlouhotrvající operaci. Pomocí hlavičky odpovědi Operation-Location určete, kdy se operace AddFace úspěšně rozšíří pro budoucí požadavky na identifikaci. Další informace o Operation-Locations naleznete v tématu Získání stavu operace rozpoznávání tváře.

POST {endpoint}/face/{apiVersion}/persons/{personId}/recognitionModels/{recognitionModel}/persistedfaces

S volitelnými parametry:

POST {endpoint}/face/{apiVersion}/persons/{personId}/recognitionModels/{recognitionModel}/persistedfaces?_overload=addPersonFaceFromUrl&targetFace={targetFace}&detectionModel={detectionModel}&userData={userData}

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
apiVersion	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).
personId	path	True	string uuid	ID osoby.
recognitionModel	path	True	RecognitionModel	Model rozpoznávání přidružený k tvářím.
detectionModel	query		DetectionModel	Model detectionModel přidružený k detekovaným faceIds. Mezi podporované hodnoty detectionModel patří detection_01, detection_02 a detection_03. Výchozí hodnota je detection_01.
targetFace	query		integer[]	Obdélník tváře, který určuje cílovou tvář, která se má přidat k osobě, ve formátu targetFace=left, top, width, height.
userData	query		string	Uživatelsky poskytnutá data připojená k obličeji Limit velikosti je 1 KB.

Text požadavku

Name	Vyžadováno	Typ	Description
url	True	string	Adresa URL vstupního obrázku

Odpovědi

Name	Typ	Description
202 Accepted	AddFaceResult	Úspěšné volání vrátí prázdný text odpovědi. Služba žádost přijala a brzy začne zpracovávat. Klient může dotazovat stav operace a výsledek pomocí adresy URL zadané v hlavičce odpovědi Operation-Location. Platnost adresy URL vyprší za 48 hodin. Hlavičky Location: string operation-Location: string
Other Status Codes	FaceErrorResponse	Neočekávaná chybová odpověď Hlavičky x-ms-error-code: string

Zabezpečení

Ocp-Apim-Subscription-Key

Tajný klíč předplatného Azure AI Face.

Typ: apiKey
V: header

AADToken

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

Rozsahy

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

Příklady

Add Face to PersonDirectory Person from Url

Ukázkový požadavek

HTTP

POST {endpoint}/face/v1.2-preview.1/persons/85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5/recognitionModels/recognition_01/persistedfaces?_overload=addPersonFaceFromUrl&targetFace=10,10,100,100&detectionModel=detection_01&userData=your_user_data

{
  "url": "https://microsoft.com/example.jpg"
}

Ukázková odpověď

Stavový kód:

202

location: https://contoso.com/operationstatus
operation-Location: https://contoso.com/operationstatus

{
  "persistedFaceId": "43897a75-8d6f-42cf-885e-74832febb055"
}

Definice

Name	Description
AddFaceResult	Text odpovědi pro přidání tváře
DetectionModel	Model detectionModel přidružený k detekovaným faceIds. Mezi podporované hodnoty detectionModel patří detection_01, detection_02 a detection_03. Výchozí hodnota je detection_01.
FaceError	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.
FaceErrorResponse	Odpověď obsahující podrobnosti o chybě.
RecognitionModel	Model rozpoznávání tváře.

AddFaceResult

Text odpovědi pro přidání tváře

Name	Typ	Description
persistedFaceId	string	Trvalé ID tváře přidané tváře, která je trvalá a nevyprší platnost. Liší se od faceId, který se vytvoří ve výrazu Detect (Zjistit) a vyprší za 24 hodin po volání detekce.

DetectionModel

Model detectionModel přidružený k detekovaným faceIds. Mezi podporované hodnoty detectionModel patří detection_01, detection_02 a detection_03. Výchozí hodnota je detection_01.

Name	Typ	Description
detection_01	string	Výchozí model detekce. Doporučujeme pro detekci přední tváře. Ve scénářích s mimořádně velkým úhlem (pozice hlavy), odlehlé tváře nebo nesprávnou orientací obrázku nemusí být rozpoznány tváře v takových případech.
detection_02	string	Model detekce vydaný v květnu 2019 s vylepšenou přesností zejména na malých, bočních a rozmazaných tvářích.
detection_03	string	Model detekce vydaný v únoru 2021 s vylepšenou přesností zejména u malých tváří.

FaceError

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.

FaceErrorResponse

Odpověď obsahující podrobnosti o chybě.

Name	Typ	Description
error	FaceError	Objekt chyby.

RecognitionModel

Model rozpoznávání tváře.

Name	Typ	Description
recognition_01	string	Výchozí model rozpoznávání pro "Zjistit". Všechny tyto faceId vytvořené před březnem 2019 jsou vázány s tímto modelem rozpoznávání.
recognition_02	string	Model rozpoznávání vydaný v březnu 2019
recognition_03	string	Model rozpoznávání vydaný v květnu 2020.
recognition_04	string	Model rozpoznávání vydaný v únoru 2021. Pro lepší přesnost rozpoznávání se doporučuje použít tento model rozpoznávání.