Face List Operations - Add Face List Face

  • Reference
Služba:
Azure AI Services
Verze rozhraní API:
v1.2-preview.1

Přidejte do zadaného seznamu tváří až 1 000 tváří.
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á "Odstranit tvář seznamu tváří" nebo "Odstranit seznam tváří".

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://video2.skills-academy.com/azure/ai-services/computer-vision/how-to/specify-detection-model
POST {endpoint}/face/{apiVersion}/facelists/{faceListId}/persistedfaces
S volitelnými parametry: 
POST {endpoint}/face/{apiVersion}/facelists/{faceListId}/persistedfaces?_overload=addFaceListFace&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).
faceListId
 path True

string

Platný znak je písmeno v malých písmenech nebo číslici nebo číslici nebo "-" nebo '_', maximální délka je 64.

Vzor regulárního výrazu: ^[a-z0-9-_]+$
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

Media Types: "application/octet-stream"

Name Typ Description
imageContent

string

Obrázek, který se má analyzovat

Odpovědi

Name Typ Description
200 OK

AddFaceResult

Úspěšné volání vrátí nové trvaléFaceId.
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 FaceList

Ukázkový požadavek

POST {endpoint}/face/v1.2-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>"

Ukázková odpověď

Stavový kód:
200 
{
  "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ě.

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.