Megosztás a következőn keresztül:


Face List - Add Face From Stream

Arc hozzáadása egy megadott arclistához, legfeljebb 1000 arc.
Ha több arcot tartalmazó képet szeretne kezelni, a bemeneti arc megadható egy targetFace téglalapot tartalmazó képként. A hozzáadott arcot jelölő persistedFaceId értéket ad vissza. A rendszer nem tárol lemezképet. A rendszer csak a kinyert arc funkciót tárolja a kiszolgálón, amíg a FaceList – Arc törlése vagy a FaceList – Törlés meghívása meg nem történik.
Megjegyzés: a persistedFaceId különbözik a Face – Detect által létrehozott faceId azonosítótól.

  • A jobb arcképminőség jobb észlelési és felismerési pontosságot jelent. Vegye figyelembe a kiváló minőségű arcokat: az előtérbeli, a tiszta és az arcméret 200x200 képpont (100 képpont a szem között) vagy nagyobb.
  • A JPEG, a PNG, a GIF (az első képkocka) és a BMP formátum támogatott. Az engedélyezett képfájlméret 1 KB és 6 MB között van.
  • A "targetFace" téglalapnak egy arcot kell tartalmaznia. A nulla vagy több arcot a rendszer hibának tekinti. Ha a megadott "targetFace" téglalapot nem adja vissza a Face – Detect függvény, nincs garancia az arc sikeres észlelésére és hozzáadására.
  • Ha nem észlelhető az arc mérete (36x36 - 4096x4096 képpont), a nagy fej-póz vagy a nagy elzáródások hibákat okoznak.
  • Az arcok ugyanahhoz az arclistához való hozzáadása/törlése egymás után történik, és a különböző arclistákhoz és -listákhoz párhuzamos módon történik.
  • A minimálisan észlelhető arcméret 36x36 képpont a képen, amely nem nagyobb, mint 1920x1080 képpont. A 1920x1080 képpontnál nagyobb méretű képekhez arányosan nagyobb minimális arcméretre lesz szükség.
  • Különböző "detectionModel" értékek adhatók meg. A különböző észlelési modellek használatához és összehasonlításához tekintse meg az észlelési modell megadását ismertető témakört.
POST {Endpoint}/face/v1.0/facelists/{faceListId}/persistedfaces
POST {Endpoint}/face/v1.0/facelists/{faceListId}/persistedfaces?overload=stream&userData={userData}&targetFace={targetFace}&detectionModel={detectionModel}

URI-paraméterek

Name In Kötelező Típus Description
Endpoint
path True

string

Támogatott Cognitive Services-végpontok (protokoll és állomásnév, például: https://westus.api.cognitive.microsoft.com).

faceListId
path True

string

Egy adott arclistára hivatkozó azonosító.

Reguláris kifejezési minta: ^[a-z0-9-_]+$

detectionModel
query

DetectionModel

Az észlelési modell neve. Az észlelési modell az elküldött kép arcainak észlelésére szolgál. Az észlelési modell neve megadható a Face – Detect vagy (Large)FaceList – Face vagy (Large)PersonGroup – Add Face (Arc hozzáadása) vagy a (Large)PersonGroup – Add Face (Arc hozzáadása) művelet végrehajtásakor. Az alapértelmezett érték a "detection_01", ha másik modellre van szükség, explicit módon adja meg.

targetFace
query

integer[]

Arc téglalap a cél arc megadásához a "targetFace=left,top,width,height" formátumban. Például: "targetFace=10,10,100,100". Ha egynél több arc van a képen, a targetFace-nek meg kell adnia, hogy melyik arcot szeretné hozzáadni. A targetFace nem azt jelenti, hogy a rendszer csak egy arcot észlel a teljes képen.

userData
query

string

Felhasználó által megadott adatok az arcról bármilyen célra. A maximális hossz 1 KB.

Kérelem fejléce

Media Types: "application/octet-stream"

Name Kötelező Típus Description
Ocp-Apim-Subscription-Key True

string

Kérelem törzse

Media Types: "application/octet-stream"

Name Típus Description
Image

object

Képstream.

Válaszok

Name Típus Description
200 OK

PersistedFace

A sikeres hívás egy új persistedFaceId azonosítót ad vissza.

Other Status Codes

APIError

Hibaválasz.

Biztonság

Ocp-Apim-Subscription-Key

Típus: apiKey
In: header

Példák

Add face to face list from stream example

Mintakérelem

POST {Endpoint}/face/v1.0/facelists/sample_face_list/persistedfaces?overload=stream&userData={Customized user data}&targetFace=10,10,100,100&detectionModel=detection_01


"{Image stream in base 64 encoded format}"

Mintaválasz

{
  "persistedFaceId": "B8D802CF-DD8F-4E61-B15C-9E6C5844CCBA"
}

Definíciók

Name Description
APIError

Az API által visszaadott hibainformációk

DetectionModel

Az észlelési modell neve. Az észlelési modell az elküldött kép arcainak észlelésére szolgál. Az észlelési modell neve megadható a Face – Detect vagy (Large)FaceList – Face vagy (Large)PersonGroup – Add Face (Arc hozzáadása) vagy a (Large)PersonGroup – Add Face (Arc hozzáadása) művelet végrehajtásakor. Az alapértelmezett érték a "detection_01", ha másik modellre van szükség, explicit módon adja meg.

Error

Hibatörzs.

PersistedFace

PersonFace objektum.

APIError

Az API által visszaadott hibainformációk

Name Típus Description
error

Error

Hibatörzs.

DetectionModel

Az észlelési modell neve. Az észlelési modell az elküldött kép arcainak észlelésére szolgál. Az észlelési modell neve megadható a Face – Detect vagy (Large)FaceList – Face vagy (Large)PersonGroup – Add Face (Arc hozzáadása) vagy a (Large)PersonGroup – Add Face (Arc hozzáadása) művelet végrehajtásakor. Az alapértelmezett érték a "detection_01", ha másik modellre van szükség, explicit módon adja meg.

Name Típus Description
detection_01

string

detection_02

string

detection_03

string

Error

Hibatörzs.

Name Típus Description
code

string

message

string

PersistedFace

PersonFace objektum.

Name Típus Description
persistedFaceId

string

A céllap persistedFaceId azonosítója, amely megmarad, és nem jár le. Más, mint a Face által létrehozott faceId – Észlelés, és a faceIdTimeToLive által megadott időpontban lejár az észlelési hívás után.

userData

string

Az archoz csatolt, felhasználó által megadott adatok. A méretkorlát 1 KB.