diff --git a/services/cognitiveservices/v1.0/face/face.go b/services/cognitiveservices/v1.0/face/face.go index 2a5b138526ed..41c12b67aacc 100644 --- a/services/cognitiveservices/v1.0/face/face.go +++ b/services/cognitiveservices/v1.0/face/face.go @@ -151,7 +151,7 @@ func (client Client) DetectWithStreamResponder(resp *http.Response) (result List // attributes.
// * Optional parameters including faceId, landmarks, and attributes. Attributes include age, gender, headPose, smile, // facialHair, glasses, emotion, hair, makeup, occlusion, accessories, blur, exposure and noise. -// * The extracted face feature, instead of the actual image, will be stored on server. The faceId is an identifier of +// * No image will be stored. Only the extracted face feature will be stored on server. The faceId is an identifier of // the face feature and will be used in [Face - // Identify](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395239), [Face - // Verify](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f3039523a), and [Face - Find @@ -166,8 +166,7 @@ func (client Client) DetectWithStreamResponder(resp *http.Response) (result List // * Face detector prefer frontal and near-frontal faces. There are cases that faces may not be detected, e.g. // exceptionally large face angles (head-pose) or being occluded, or wrong image orientation. // * Attributes (age, gender, headPose, smile, facialHair, glasses, emotion, hair, makeup, occlusion, accessories, -// blur, exposure and noise) may not be perfectly accurate. HeadPose's pitch value is a reserved field and will always -// return 0. +// blur, exposure and noise) may not be perfectly accurate. // * Different 'recognitionModel' values are provided. If follow-up operations like Verify, Identify, Find Similar are // needed, please specify the recognition model with 'recognitionModel' parameter. The default value for // 'recognitionModel' is 'recognition_01', if latest model needed, please explicitly specify the model you need in this diff --git a/services/cognitiveservices/v1.0/face/largefacelist.go b/services/cognitiveservices/v1.0/face/largefacelist.go index bc421c8a514d..480ceb9b0f88 100644 --- a/services/cognitiveservices/v1.0/face/largefacelist.go +++ b/services/cognitiveservices/v1.0/face/largefacelist.go @@ -137,8 +137,28 @@ func (client LargeFaceListClient) AddFaceFromStreamResponder(resp *http.Response return } -// AddFaceFromURL add a face to a large face list. The input face is specified as an image with a targetFace rectangle. -// It returns a persistedFaceId representing the added face, and persistedFaceId will not expire. +// AddFaceFromURL add a face to a specified large face list, up to 1,000,000 faces. +//
To deal with an image contains multiple faces, input face can be specified as an image with a targetFace +// rectangle. It returns a persistedFaceId representing the added face. No image will be stored. Only the extracted +// face feature will be stored on server until [LargeFaceList Face - +// Delete](/docs/services/563879b61984550e40cbbe8d/operations/5a158c8ad2de3616c086f2d4) or [LargeFaceList - +// Delete](/docs/services/563879b61984550e40cbbe8d/operations/5a1580d5d2de3616c086f2cd) is called. +//
Note persistedFaceId is different from faceId generated by [Face - +// Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236). +// * Higher face image quality means better recognition precision. Please consider high-quality faces: frontal, clear, +// and face size is 200x200 pixels (100 pixels between eyes) or bigger. +// * JPEG, PNG, GIF (the first frame), and BMP format are supported. The allowed image file size is from 1KB to 6MB. +// * "targetFace" rectangle should contain one face. Zero or multiple faces will be regarded as an error. If the +// provided "targetFace" rectangle is not returned from [Face - +// Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236), there’s no guarantee to detect +// and add the face successfully. +// * Out of detectable face size (36x36 - 4096x4096 pixels), large head-pose, or large occlusions will cause failures. +// * Adding/deleting faces to/from a same face list are processed sequentially and to/from different face lists are in +// parallel. +// +// Quota: +// * Free-tier subscription quota: 1,000 faces per large face list. +// * S0-tier subscription quota: 1,000,000 faces per large face list. // Parameters: // largeFaceListID - id referencing a particular large face list. // imageURL - a JSON document with a URL pointing to the image that is to be analyzed. @@ -245,23 +265,28 @@ func (client LargeFaceListClient) AddFaceFromURLResponder(resp *http.Response) ( //
After creation, user should use [LargeFaceList Face - // Add](/docs/services/563879b61984550e40cbbe8d/operations/5a158c10d2de3616c086f2d3) to import the faces and // [LargeFaceList - Train](/docs/services/563879b61984550e40cbbe8d/operations/5a158422d2de3616c086f2d1) to make it -// ready for [Face - FindSimilar](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395237). Faces -// are stored on server until [LargeFaceList - +// ready for [Face - Find Similar](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395237). No +// image will be stored. Only the extracted face features are stored on server until [LargeFaceList - // Delete](/docs/services/563879b61984550e40cbbe8d/operations/5a1580d5d2de3616c086f2cd) is called. //
Find Similar is used for scenario like finding celebrity-like faces, similar face filtering, or as a light // way face identification. But if the actual use is to identify person, please use // [PersonGroup](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395244) / // [LargePersonGroup](/docs/services/563879b61984550e40cbbe8d/operations/599acdee6ac60f11b48b5a9d) and [Face - // Identify](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395239). -//
-// * Free-tier subscription quota: 64 large face lists. -// * S0-tier subscription quota: 1,000,000 large face lists. -//
-// 'recognitionModel' should be specified to associate with this large face list. The default value for +//
'recognitionModel' should be specified to associate with this large face list. The default value for // 'recognitionModel' is 'recognition_01', if the latest model needed, please explicitly specify the model you need in // this parameter. New faces that are added to an existing large face list will use the recognition model that's // already associated with the collection. Existing face features in a large face list can't be updated to features // extracted by another version of recognition model. +// * 'recognition_01': The default recognition model for [LargeFaceList- +// Create](/docs/services/563879b61984550e40cbbe8d/operations/5a157b68d2de3616c086f2cc). All those large face lists +// created before 2019 March are bonded with this recognition model. +// * 'recognition_02': Recognition model released in 2019 March. 'recognition_02' is recommended since its overall +// accuracy is improved compared with 'recognition_01'. +// +// Large face list quota: +// * Free-tier subscription quota: 64 large face lists. +// * S0-tier subscription quota: 1,000,000 large face lists. // Parameters: // largeFaceListID - id referencing a particular large face list. // body - request body for creating a large face list. @@ -342,8 +367,7 @@ func (client LargeFaceListClient) CreateResponder(resp *http.Response) (result a return } -// Delete delete an existing large face list according to faceListId. Persisted face images in the large face list will -// also be deleted. +// Delete delete a specified large face list. // Parameters: // largeFaceListID - id referencing a particular large face list. func (client LargeFaceListClient) Delete(ctx context.Context, largeFaceListID string) (result autorest.Response, err error) { @@ -421,8 +445,9 @@ func (client LargeFaceListClient) DeleteResponder(resp *http.Response) (result a return } -// DeleteFace delete an existing face from a large face list (given by a persistedFaceId and a largeFaceListId). -// Persisted image related to the face will also be deleted. +// DeleteFace delete a face from a large face list by specified largeFaceListId and persistedFaceId. +//
Adding/deleting faces to/from a same large face list are processed sequentially and to/from different large +// face lists are in parallel. // Parameters: // largeFaceListID - id referencing a particular large face list. // persistedFaceID - id referencing a particular persistedFaceId of an existing face. diff --git a/services/cognitiveservices/v1.0/face/largepersongroup.go b/services/cognitiveservices/v1.0/face/largepersongroup.go index 6bbddf0f5d36..c5b432445eec 100644 --- a/services/cognitiveservices/v1.0/face/largepersongroup.go +++ b/services/cognitiveservices/v1.0/face/largepersongroup.go @@ -38,25 +38,32 @@ func NewLargePersonGroupClient(endpoint string) LargePersonGroupClient { // Create create a new large person group with user-specified largePersonGroupId, name, an optional userData and // recognitionModel. -//
A large person group is the container of the uploaded person data, including face images and face recognition -// feature, and up to 1,000,000 people. +//
A large person group is the container of the uploaded person data, including face recognition feature, and up +// to 1,000,000 +// people. //
After creation, use [LargePersonGroup Person - // Create](/docs/services/563879b61984550e40cbbe8d/operations/599adcba3a7b9412a4d53f40) to add person into the group, // and call [LargePersonGroup - Train](/docs/services/563879b61984550e40cbbe8d/operations/599ae2d16ac60f11b48b5aa4) to // get this group ready for [Face - // Identify](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395239). -//
The person face, image, and userData will be stored on server until [LargePersonGroup Person - +//
No image will be stored. Only the person's extracted face features and userData will be stored on server +// until [LargePersonGroup Person - // Delete](/docs/services/563879b61984550e40cbbe8d/operations/599ade5c6ac60f11b48b5aa2) or [LargePersonGroup - // Delete](/docs/services/563879b61984550e40cbbe8d/operations/599adc216ac60f11b48b5a9f) is called. -//
-// * Free-tier subscription quota: 1,000 large person groups. -// * S0-tier subscription quota: 1,000,000 large person groups. -//
-// 'recognitionModel' should be specified to associate with this large person group. The default value for +//
'recognitionModel' should be specified to associate with this large person group. The default value for // 'recognitionModel' is 'recognition_01', if the latest model needed, please explicitly specify the model you need in // this parameter. New faces that are added to an existing large person group will use the recognition model that's // already associated with the collection. Existing face features in a large person group can't be updated to features // extracted by another version of recognition model. +// * 'recognition_01': The default recognition model for [LargePersonGroup - +// Create](/docs/services/563879b61984550e40cbbe8d/operations/599acdee6ac60f11b48b5a9d). All those large person groups +// created before 2019 March are bonded with this recognition model. +// * 'recognition_02': Recognition model released in 2019 March. 'recognition_02' is recommended since its overall +// accuracy is improved compared with 'recognition_01'. +// +// Large person group quota: +// * Free-tier subscription quota: 1,000 large person groups. +// * S0-tier subscription quota: 1,000,000 large person groups. // Parameters: // largePersonGroupID - id referencing a particular large person group. // body - request body for creating new large person group. diff --git a/services/cognitiveservices/v1.0/face/largepersongroupperson.go b/services/cognitiveservices/v1.0/face/largepersongroupperson.go index 8c43bcc8b2db..0ce8ec31bf7f 100644 --- a/services/cognitiveservices/v1.0/face/largepersongroupperson.go +++ b/services/cognitiveservices/v1.0/face/largepersongroupperson.go @@ -139,8 +139,26 @@ func (client LargePersonGroupPersonClient) AddFaceFromStreamResponder(resp *http return } -// AddFaceFromURL add a representative face to a person for identification. The input face is specified as an image -// with a targetFace rectangle. +// AddFaceFromURL add a face to a person into a large person group for face identification or verification. To deal +// with an image contains multiple faces, input face can be specified as an image with a targetFace rectangle. It +// returns a persistedFaceId representing the added face. No image will be stored. Only the extracted face feature will +// be stored on server until [LargePersonGroup PersonFace - +// Delete](/docs/services/563879b61984550e40cbbe8d/operations/599ae2966ac60f11b48b5aa3), [LargePersonGroup Person - +// Delete](/docs/services/563879b61984550e40cbbe8d/operations/599ade5c6ac60f11b48b5aa2) or [LargePersonGroup - +// Delete](/docs/services/563879b61984550e40cbbe8d/operations/599adc216ac60f11b48b5a9f) is called. +//
Note persistedFaceId is different from faceId generated by [Face - +// Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236). +// * Higher face image quality means better recognition precision. Please consider high-quality faces: frontal, clear, +// and face size is 200x200 pixels (100 pixels between eyes) or bigger. +// * Each person entry can hold up to 248 faces. +// * JPEG, PNG, GIF (the first frame), and BMP format are supported. The allowed image file size is from 1KB to 6MB. +// * "targetFace" rectangle should contain one face. Zero or multiple faces will be regarded as an error. If the +// provided "targetFace" rectangle is not returned from [Face - +// Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236), there’s no guarantee to detect +// and add the face successfully. +// * Out of detectable face size (36x36 - 4096x4096 pixels), large head-pose, or large occlusions will cause failures. +// * Adding/deleting faces to/from a same person will be processed sequentially. Adding/deleting faces to/from +// different persons are processed in parallel. // Parameters: // largePersonGroupID - id referencing a particular large person group. // personID - id referencing a particular person. @@ -329,8 +347,8 @@ func (client LargePersonGroupPersonClient) CreateResponder(resp *http.Response) return } -// Delete delete an existing person from a large person group. All stored person data, and face features in the person -// entry will be deleted. +// Delete delete an existing person from a large person group. The persistedFaceId, userData, person name and face +// feature in the person entry will all be deleted. // Parameters: // largePersonGroupID - id referencing a particular large person group. // personID - id referencing a particular person. @@ -410,7 +428,10 @@ func (client LargePersonGroupPersonClient) DeleteResponder(resp *http.Response) return } -// DeleteFace delete a face from a person. Relative feature for the persisted face will also be deleted. +// DeleteFace delete a face from a person in a large person group by specified largePersonGroupId, personId and +// persistedFaceId. +//
Adding/deleting faces to/from a same person will be processed sequentially. Adding/deleting faces to/from +// different persons are processed in parallel. // Parameters: // largePersonGroupID - id referencing a particular large person group. // personID - id referencing a particular person. @@ -492,7 +513,8 @@ func (client LargePersonGroupPersonClient) DeleteFaceResponder(resp *http.Respon return } -// Get retrieve a person's information, including registered persisted faces, name and userData. +// Get retrieve a person's name and userData, and the persisted faceIds representing the registered person face +// feature. // Parameters: // largePersonGroupID - id referencing a particular large person group. // personID - id referencing a particular person. diff --git a/services/cognitiveservices/v1.0/face/list.go b/services/cognitiveservices/v1.0/face/list.go index bca38e62c047..e8c5777c56c3 100644 --- a/services/cognitiveservices/v1.0/face/list.go +++ b/services/cognitiveservices/v1.0/face/list.go @@ -137,8 +137,24 @@ func (client ListClient) AddFaceFromStreamResponder(resp *http.Response) (result return } -// AddFaceFromURL add a face to a face list. The input face is specified as an image with a targetFace rectangle. It -// returns a persistedFaceId representing the added face, and persistedFaceId will not expire. +// AddFaceFromURL add a face to a specified face list, up to 1,000 faces. +//
To deal with an image contains multiple faces, input face can be specified as an image with a targetFace +// rectangle. It returns a persistedFaceId representing the added face. No image will be stored. Only the extracted +// face feature will be stored on server until [FaceList - Delete +// Face](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395251) or [FaceList - +// Delete](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f3039524f) is called. +//
Note persistedFaceId is different from faceId generated by [Face - +// Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236). +// * Higher face image quality means better detection and recognition precision. Please consider high-quality faces: +// frontal, clear, and face size is 200x200 pixels (100 pixels between eyes) or bigger. +// * JPEG, PNG, GIF (the first frame), and BMP format are supported. The allowed image file size is from 1KB to 6MB. +// * "targetFace" rectangle should contain one face. Zero or multiple faces will be regarded as an error. If the +// provided "targetFace" rectangle is not returned from [Face - +// Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236), there’s no guarantee to detect +// and add the face successfully. +// * Out of detectable face size (36x36 - 4096x4096 pixels), large head-pose, or large occlusions will cause failures. +// * Adding/deleting faces to/from a same face list are processed sequentially and to/from different face lists are in +// parallel. // Parameters: // faceListID - id referencing a particular face list. // imageURL - a JSON document with a URL pointing to the image that is to be analyzed. @@ -243,8 +259,8 @@ func (client ListClient) AddFaceFromURLResponder(resp *http.Response) (result Pe //
Face list is a list of faces, up to 1,000 faces, and used by [Face - Find // Similar](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395237). //
After creation, user should use [FaceList - Add -// Face](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395250) to import the faces. Faces are -// stored on server until [FaceList - +// Face](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395250) to import the faces. No image +// will be stored. Only the extracted face features are stored on server until [FaceList - // Delete](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f3039524f) is called. //
Find Similar is used for scenario like finding celebrity-like faces, similar face filtering, or as a light // way face identification. But if the actual use is to identify person, please use @@ -252,11 +268,17 @@ func (client ListClient) AddFaceFromURLResponder(resp *http.Response) (result Pe // [LargePersonGroup](/docs/services/563879b61984550e40cbbe8d/operations/599acdee6ac60f11b48b5a9d) and [Face - // Identify](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395239). //
Please consider [LargeFaceList](/docs/services/563879b61984550e40cbbe8d/operations/5a157b68d2de3616c086f2cc) -// when the face number is large. It can support up to 1,000,000 faces. 'recognitionModel' should be specified to -// associate with this face list. The default value for 'recognitionModel' is 'recognition_01', if the latest model -// needed, please explicitly specify the model you need in this parameter. New faces that are added to an existing face -// list will use the recognition model that's already associated with the collection. Existing face features in a face -// list can't be updated to features extracted by another version of recognition model. +// when the face number is large. It can support up to 1,000,000 faces. +//
'recognitionModel' should be specified to associate with this face list. The default value for +// 'recognitionModel' is 'recognition_01', if the latest model needed, please explicitly specify the model you need in +// this parameter. New faces that are added to an existing face list will use the recognition model that's already +// associated with the collection. Existing face features in a face list can't be updated to features extracted by +// another version of recognition model. +// * 'recognition_01': The default recognition model for [FaceList- +// Create](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f3039524b). All those face lists created +// before 2019 March are bonded with this recognition model. +// * 'recognition_02': Recognition model released in 2019 March. 'recognition_02' is recommended since its overall +// accuracy is improved compared with 'recognition_01'. // Parameters: // faceListID - id referencing a particular face list. // body - request body for creating a face list. @@ -337,8 +359,7 @@ func (client ListClient) CreateResponder(resp *http.Response) (result autorest.R return } -// Delete delete an existing face list according to faceListId. Persisted face images in the face list will also be -// deleted. +// Delete delete a specified face list. // Parameters: // faceListID - id referencing a particular face list. func (client ListClient) Delete(ctx context.Context, faceListID string) (result autorest.Response, err error) { @@ -416,8 +437,9 @@ func (client ListClient) DeleteResponder(resp *http.Response) (result autorest.R return } -// DeleteFace delete an existing face from a face list (given by a persistedFaceId and a faceListId). Persisted image -// related to the face will also be deleted. +// DeleteFace delete a face from a face list by specified faceListId and persistedFaceId. +//
Adding/deleting faces to/from a same face list are processed sequentially and to/from different face lists +// are in parallel. // Parameters: // faceListID - id referencing a particular face list. // persistedFaceID - id referencing a particular persistedFaceId of an existing face. diff --git a/services/cognitiveservices/v1.0/face/persongroup.go b/services/cognitiveservices/v1.0/face/persongroup.go index 77275f28c30d..62f92e825a9a 100644 --- a/services/cognitiveservices/v1.0/face/persongroup.go +++ b/services/cognitiveservices/v1.0/face/persongroup.go @@ -37,27 +37,31 @@ func NewPersonGroupClient(endpoint string) PersonGroupClient { } // Create create a new person group with specified personGroupId, name, user-provided userData and recognitionModel. -//
A person group is the container of the uploaded person data, including face images and face recognition -// features. +//
A person group is the container of the uploaded person data, including face recognition features. //
After creation, use [PersonGroup Person - // Create](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f3039523c) to add persons into the group, // and then call [PersonGroup - Train](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395249) to // get this group ready for [Face - // Identify](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395239). -//
The person's face, image, and userData will be stored on server until [PersonGroup Person - -// Delete](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f3039523d) or [PersonGroup - -// Delete](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395245) is called. -//
+//
No image will be stored. Only the person's extracted face features and userData will be stored on server +// until [PersonGroup Person - Delete](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f3039523d) or +// [PersonGroup - Delete](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395245) is called. +//
'recognitionModel' should be specified to associate with this person group. The default value for +// 'recognitionModel' is 'recognition_01', if the latest model needed, please explicitly specify the model you need in +// this parameter. New faces that are added to an existing person group will use the recognition model that's already +// associated with the collection. Existing face features in a person group can't be updated to features extracted by +// another version of recognition model. +// * 'recognition_01': The default recognition model for [PersonGroup - +// Create](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395244). All those person groups +// created before 2019 March are bonded with this recognition model. +// * 'recognition_02': Recognition model released in 2019 March. 'recognition_02' is recommended since its overall +// accuracy is improved compared with 'recognition_01'. +// +// Person group quota: // * Free-tier subscription quota: 1,000 person groups. Each holds up to 1,000 persons. // * S0-tier subscription quota: 1,000,000 person groups. Each holds up to 10,000 persons. // * to handle larger scale face identification problem, please consider using // [LargePersonGroup](/docs/services/563879b61984550e40cbbe8d/operations/599acdee6ac60f11b48b5a9d). -//
-// 'recognitionModel' should be specified to associate with this person group. The default value for 'recognitionModel' -// is 'recognition_01', if the latest model needed, please explicitly specify the model you need in this parameter. New -// faces that are added to an existing person group will use the recognition model that's already associated with the -// collection. Existing face features in a person group can't be updated to features extracted by another version of -// recognition model. // Parameters: // personGroupID - id referencing a particular person group. // body - request body for creating new person group. diff --git a/services/cognitiveservices/v1.0/face/persongroupperson.go b/services/cognitiveservices/v1.0/face/persongroupperson.go index 584c5077f4fe..e180e33f05bf 100644 --- a/services/cognitiveservices/v1.0/face/persongroupperson.go +++ b/services/cognitiveservices/v1.0/face/persongroupperson.go @@ -139,8 +139,27 @@ func (client PersonGroupPersonClient) AddFaceFromStreamResponder(resp *http.Resp return } -// AddFaceFromURL add a representative face to a person for identification. The input face is specified as an image -// with a targetFace rectangle. +// AddFaceFromURL add a face to a person into a large person group for face identification or verification. To deal +// with an image contains multiple faces, input face can be specified as an image with a targetFace rectangle. It +// returns a persistedFaceId representing the added face. No image will be stored. Only the extracted face feature will +// be stored on server until [LargePersonGroup PersonFace - +// Delete](/docs/services/563879b61984550e40cbbe8d/operations/599ae2966ac60f11b48b5aa3), [LargePersonGroup Person - +// Delete](/docs/services/563879b61984550e40cbbe8d/operations/599ade5c6ac60f11b48b5aa2) or [LargePersonGroup - +// Delete](/docs/services/563879b61984550e40cbbe8d/operations/599adc216ac60f11b48b5a9f) is called. +//
Note persistedFaceId is different from faceId generated by [Face - +// Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236). +// * Higher face image quality means better recognition precision. Please consider high-quality faces: frontal, +// clear, and face size is 200x200 pixels (100 pixels between eyes) or bigger. +// * Each person entry can hold up to 248 faces. +// * JPEG, PNG, GIF (the first frame), and BMP format are supported. The allowed image file size is from 1KB to 6MB. +// * "targetFace" rectangle should contain one face. Zero or multiple faces will be regarded as an error. If the +// provided "targetFace" rectangle is not returned from [Face - +// Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236), there’s no guarantee to detect +// and add the face successfully. +// * Out of detectable face size (36x36 - 4096x4096 pixels), large head-pose, or large occlusions will cause +// failures. +// * Adding/deleting faces to/from a same person will be processed sequentially. Adding/deleting faces to/from +// different persons are processed in parallel. // Parameters: // personGroupID - id referencing a particular person group. // personID - id referencing a particular person. @@ -329,8 +348,8 @@ func (client PersonGroupPersonClient) CreateResponder(resp *http.Response) (resu return } -// Delete delete an existing person from a person group. All stored person data, and face features in the person entry -// will be deleted. +// Delete delete an existing person from a person group. The persistedFaceId, userData, person name and face feature in +// the person entry will all be deleted. // Parameters: // personGroupID - id referencing a particular person group. // personID - id referencing a particular person. @@ -410,7 +429,9 @@ func (client PersonGroupPersonClient) DeleteResponder(resp *http.Response) (resu return } -// DeleteFace delete a face from a person. Relative feature for the persisted face will also be deleted. +// DeleteFace delete a face from a person in a person group by specified personGroupId, personId and persistedFaceId. +//
Adding/deleting faces to/from a same person will be processed sequentially. Adding/deleting faces to/from +// different persons are processed in parallel. // Parameters: // personGroupID - id referencing a particular person group. // personID - id referencing a particular person. @@ -836,7 +857,26 @@ func (client PersonGroupPersonClient) UpdateResponder(resp *http.Response) (resu return } -// UpdateFace update a person persisted face's userData field. +// UpdateFace add a face to a person into a person group for face identification or verification. To deal with an image +// contains multiple faces, input face can be specified as an image with a targetFace rectangle. It returns a +// persistedFaceId representing the added face. No image will be stored. Only the extracted face feature will be stored +// on server until [PersonGroup PersonFace - +// Delete](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f3039523e), [PersonGroup Person - +// Delete](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f3039523d) or [PersonGroup - +// Delete](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395245) is called. +//
Note persistedFaceId is different from faceId generated by [Face - +// Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236). +// * Higher face image quality means better recognition precision. Please consider high-quality faces: frontal, clear, +// and face size is 200x200 pixels (100 pixels between eyes) or bigger. +// * Each person entry can hold up to 248 faces. +// * JPEG, PNG, GIF (the first frame), and BMP format are supported. The allowed image file size is from 1KB to 6MB. +// * "targetFace" rectangle should contain one face. Zero or multiple faces will be regarded as an error. If the +// provided "targetFace" rectangle is not returned from [Face - +// Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236), there’s no guarantee to detect +// and add the face successfully. +// * Out of detectable face size (36x36 - 4096x4096 pixels), large head-pose, or large occlusions will cause failures. +// * Adding/deleting faces to/from a same person will be processed sequentially. Adding/deleting faces to/from +// different persons are processed in parallel. // Parameters: // personGroupID - id referencing a particular person group. // personID - id referencing a particular person.