azure_cognitiveservices_face 0.18.0 → 0.19.0

data/lib/1.0/generated/azure_cognitiveservices_face/large_face_list_operations.rb

@@ -31,9 +31,10 @@ module Azure::CognitiveServices::Face::V1_0
     # 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 -
+    # to make it 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.
     # <br /> Find Similar is used for scenario like finding celebrity-like faces,
@@ -44,18 +45,24 @@ module Azure::CognitiveServices::Face::V1_0
     # [LargePersonGroup](/docs/services/563879b61984550e40cbbe8d/operations/599acdee6ac60f11b48b5a9d)
     # and [Face -
     # Identify](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395239).
-    # <br />
-    # * Free-tier subscription quota: 64 large face lists.
-    # * S0-tier subscription quota: 1,000,000 large face lists.
-    # <br />
-    # 'recognitionModel' should be specified to associate with this large face
+    # <br/>'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.
     #
     # @param large_face_list_id [String] Id referencing a particular large face
     # list.
@@ -82,9 +89,10 @@ module Azure::CognitiveServices::Face::V1_0
     # 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 -
+    # to make it 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.
     # <br /> Find Similar is used for scenario like finding celebrity-like faces,
@@ -95,18 +103,24 @@ module Azure::CognitiveServices::Face::V1_0
     # [LargePersonGroup](/docs/services/563879b61984550e40cbbe8d/operations/599acdee6ac60f11b48b5a9d)
     # and [Face -
     # Identify](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395239).
-    # <br />
-    # * Free-tier subscription quota: 64 large face lists.
-    # * S0-tier subscription quota: 1,000,000 large face lists.
-    # <br />
-    # 'recognitionModel' should be specified to associate with this large face
+    # <br/>'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.
     #
     # @param large_face_list_id [String] Id referencing a particular large face
     # list.
@@ -133,9 +147,10 @@ module Azure::CognitiveServices::Face::V1_0
     # 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 -
+    # to make it 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.
     # <br /> Find Similar is used for scenario like finding celebrity-like faces,
@@ -146,18 +161,24 @@ module Azure::CognitiveServices::Face::V1_0
     # [LargePersonGroup](/docs/services/563879b61984550e40cbbe8d/operations/599acdee6ac60f11b48b5a9d)
     # and [Face -
     # Identify](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395239).
-    # <br />
-    # * Free-tier subscription quota: 64 large face lists.
-    # * S0-tier subscription quota: 1,000,000 large face lists.
-    # <br />
-    # 'recognitionModel' should be specified to associate with this large face
+    # <br/>'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.
     #
     # @param large_face_list_id [String] Id referencing a particular large face
     # list.
@@ -221,6 +242,8 @@ module Azure::CognitiveServices::Face::V1_0
         end
 
         result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        result.correlation_request_id = http_response['x-ms-correlation-request-id'] unless http_response['x-ms-correlation-request-id'].nil?
+        result.client_request_id = http_response['x-ms-client-request-id'] unless http_response['x-ms-client-request-id'].nil?
 
         result
       end
@@ -313,6 +336,8 @@ module Azure::CognitiveServices::Face::V1_0
         end
 
         result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        result.correlation_request_id = http_response['x-ms-correlation-request-id'] unless http_response['x-ms-correlation-request-id'].nil?
+        result.client_request_id = http_response['x-ms-client-request-id'] unless http_response['x-ms-client-request-id'].nil?
         # Deserialize Response
         if status_code == 200
           begin
@@ -424,6 +449,8 @@ module Azure::CognitiveServices::Face::V1_0
         end
 
         result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        result.correlation_request_id = http_response['x-ms-correlation-request-id'] unless http_response['x-ms-correlation-request-id'].nil?
+        result.client_request_id = http_response['x-ms-client-request-id'] unless http_response['x-ms-client-request-id'].nil?
 
         result
       end
@@ -432,8 +459,7 @@ module Azure::CognitiveServices::Face::V1_0
     end
 
     #
-    # Delete an existing large face list according to faceListId. Persisted face
-    # images in the large face list will also be deleted.
+    # Delete a specified large face list.
     #
     # @param large_face_list_id [String] Id referencing a particular large face
     # list.
@@ -447,8 +473,7 @@ module Azure::CognitiveServices::Face::V1_0
     end
 
     #
-    # Delete an existing large face list according to faceListId. Persisted face
-    # images in the large face list will also be deleted.
+    # Delete a specified large face list.
     #
     # @param large_face_list_id [String] Id referencing a particular large face
     # list.
@@ -462,8 +487,7 @@ module Azure::CognitiveServices::Face::V1_0
     end
 
     #
-    # Delete an existing large face list according to faceListId. Persisted face
-    # images in the large face list will also be deleted.
+    # Delete a specified large face list.
     #
     # @param large_face_list_id [String] Id referencing a particular large face
     # list.
@@ -508,6 +532,8 @@ module Azure::CognitiveServices::Face::V1_0
         end
 
         result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        result.correlation_request_id = http_response['x-ms-correlation-request-id'] unless http_response['x-ms-correlation-request-id'].nil?
+        result.client_request_id = http_response['x-ms-client-request-id'] unless http_response['x-ms-client-request-id'].nil?
 
         result
       end
@@ -590,6 +616,8 @@ module Azure::CognitiveServices::Face::V1_0
         end
 
         result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        result.correlation_request_id = http_response['x-ms-correlation-request-id'] unless http_response['x-ms-correlation-request-id'].nil?
+        result.client_request_id = http_response['x-ms-client-request-id'] unless http_response['x-ms-client-request-id'].nil?
         # Deserialize Response
         if status_code == 200
           begin
@@ -730,6 +758,8 @@ module Azure::CognitiveServices::Face::V1_0
         end
 
         result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        result.correlation_request_id = http_response['x-ms-correlation-request-id'] unless http_response['x-ms-correlation-request-id'].nil?
+        result.client_request_id = http_response['x-ms-client-request-id'] unless http_response['x-ms-client-request-id'].nil?
         # Deserialize Response
         if status_code == 200
           begin
@@ -840,6 +870,8 @@ module Azure::CognitiveServices::Face::V1_0
         end
 
         result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        result.correlation_request_id = http_response['x-ms-correlation-request-id'] unless http_response['x-ms-correlation-request-id'].nil?
+        result.client_request_id = http_response['x-ms-client-request-id'] unless http_response['x-ms-client-request-id'].nil?
 
         result
       end
@@ -848,9 +880,10 @@ module Azure::CognitiveServices::Face::V1_0
     end
 
     #
-    # 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.
+    # Delete a face from a large face list by specified largeFaceListId and
+    # persistedFaceId.
+    # <br /> Adding/deleting faces to/from a same large face list are processed
+    # sequentially and to/from different large face lists are in parallel.
     #
     # @param large_face_list_id [String] Id referencing a particular large face
     # list.
@@ -866,9 +899,10 @@ module Azure::CognitiveServices::Face::V1_0
     end
 
     #
-    # 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.
+    # Delete a face from a large face list by specified largeFaceListId and
+    # persistedFaceId.
+    # <br /> Adding/deleting faces to/from a same large face list are processed
+    # sequentially and to/from different large face lists are in parallel.
     #
     # @param large_face_list_id [String] Id referencing a particular large face
     # list.
@@ -884,9 +918,10 @@ module Azure::CognitiveServices::Face::V1_0
     end
 
     #
-    # 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.
+    # Delete a face from a large face list by specified largeFaceListId and
+    # persistedFaceId.
+    # <br /> Adding/deleting faces to/from a same large face list are processed
+    # sequentially and to/from different large face lists are in parallel.
     #
     # @param large_face_list_id [String] Id referencing a particular large face
     # list.
@@ -934,6 +969,8 @@ module Azure::CognitiveServices::Face::V1_0
         end
 
         result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        result.correlation_request_id = http_response['x-ms-correlation-request-id'] unless http_response['x-ms-correlation-request-id'].nil?
+        result.client_request_id = http_response['x-ms-client-request-id'] unless http_response['x-ms-client-request-id'].nil?
 
         result
       end
@@ -1026,6 +1063,8 @@ module Azure::CognitiveServices::Face::V1_0
         end
 
         result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        result.correlation_request_id = http_response['x-ms-correlation-request-id'] unless http_response['x-ms-correlation-request-id'].nil?
+        result.client_request_id = http_response['x-ms-client-request-id'] unless http_response['x-ms-client-request-id'].nil?
         # Deserialize Response
         if status_code == 200
           begin
@@ -1142,6 +1181,8 @@ module Azure::CognitiveServices::Face::V1_0
         end
 
         result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        result.correlation_request_id = http_response['x-ms-correlation-request-id'] unless http_response['x-ms-correlation-request-id'].nil?
+        result.client_request_id = http_response['x-ms-client-request-id'] unless http_response['x-ms-client-request-id'].nil?
 
         result
       end
@@ -1150,9 +1191,51 @@ module Azure::CognitiveServices::Face::V1_0
     end
 
     #
-    # 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.
+    # Add a face to a specified large face list, up to 1,000,000 faces.
+    # <br /> 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.
+    # <br /> 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.
+    # * The minimum detectable face size is 36x36 pixels in an image no larger than
+    # 1920x1080 pixels. Images with dimensions higher than 1920x1080 pixels will
+    # need a proportionally larger minimum face size.
+    # * Different 'detectionModel' values can be provided. To use and compare
+    # different detection models, please refer to [How to specify a detection
+    # model](https://docs.microsoft.com/en-us/azure/cognitive-services/face/face-api-how-to-topics/specify-detection-model)
+    # | Model | Recommended use-case(s) |
+    # | ---------- | -------- |
+    # | 'detection_01': | The default detection model for [LargeFaceList - Add
+    # Face](/docs/services/563879b61984550e40cbbe8d/operations/5a158c10d2de3616c086f2d3).
+    # Recommend for near frontal face detection. For scenarios with exceptionally
+    # large angle (head-pose) faces, occluded faces or wrong image orientation, the
+    # faces in such cases may not be detected. |
+    # | 'detection_02': | Detection model released in 2019 May with improved
+    # accuracy especially on small, side and blurry faces. |
+    #
+    # Quota:
+    # * Free-tier subscription quota: 1,000 faces per large face list.
+    # * S0-tier subscription quota: 1,000,000 faces per large face list.
     #
     # @param large_face_list_id [String] Id referencing a particular large face
     # list.
@@ -1165,20 +1248,68 @@ module Azure::CognitiveServices::Face::V1_0
     # is more than one face in the image, targetFace is required to specify which
     # face to add. No targetFace means there is only one face detected in the
     # entire image.
+    # @param detection_model [DetectionModel] Name of detection model. Detection
+    # model is used to detect faces in the submitted image. A detection model name
+    # can be provided when performing Face - Detect or (Large)FaceList - Add Face
+    # or (Large)PersonGroup - Add Face. The default value is 'detection_01', if
+    # another model is needed, please explicitly specify it. Possible values
+    # include: 'detection_01', 'detection_02'
     # @param custom_headers [Hash{String => String}] A hash of custom headers that
     # will be added to the HTTP request.
     #
     # @return [PersistedFace] operation results.
     #
-    def add_face_from_url(large_face_list_id, url, user_data:nil, target_face:nil, custom_headers:nil)
-      response = add_face_from_url_async(large_face_list_id, url, user_data:user_data, target_face:target_face, custom_headers:custom_headers).value!
+    def add_face_from_url(large_face_list_id, url, user_data:nil, target_face:nil, detection_model:nil, custom_headers:nil)
+      response = add_face_from_url_async(large_face_list_id, url, user_data:user_data, target_face:target_face, detection_model:detection_model, custom_headers:custom_headers).value!
       response.body unless response.nil?
     end
 
     #
-    # 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.
+    # Add a face to a specified large face list, up to 1,000,000 faces.
+    # <br /> 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.
+    # <br /> 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.
+    # * The minimum detectable face size is 36x36 pixels in an image no larger than
+    # 1920x1080 pixels. Images with dimensions higher than 1920x1080 pixels will
+    # need a proportionally larger minimum face size.
+    # * Different 'detectionModel' values can be provided. To use and compare
+    # different detection models, please refer to [How to specify a detection
+    # model](https://docs.microsoft.com/en-us/azure/cognitive-services/face/face-api-how-to-topics/specify-detection-model)
+    # | Model | Recommended use-case(s) |
+    # | ---------- | -------- |
+    # | 'detection_01': | The default detection model for [LargeFaceList - Add
+    # Face](/docs/services/563879b61984550e40cbbe8d/operations/5a158c10d2de3616c086f2d3).
+    # Recommend for near frontal face detection. For scenarios with exceptionally
+    # large angle (head-pose) faces, occluded faces or wrong image orientation, the
+    # faces in such cases may not be detected. |
+    # | 'detection_02': | Detection model released in 2019 May with improved
+    # accuracy especially on small, side and blurry faces. |
+    #
+    # Quota:
+    # * Free-tier subscription quota: 1,000 faces per large face list.
+    # * S0-tier subscription quota: 1,000,000 faces per large face list.
     #
     # @param large_face_list_id [String] Id referencing a particular large face
     # list.
@@ -1191,19 +1322,67 @@ module Azure::CognitiveServices::Face::V1_0
     # is more than one face in the image, targetFace is required to specify which
     # face to add. No targetFace means there is only one face detected in the
     # entire image.
+    # @param detection_model [DetectionModel] Name of detection model. Detection
+    # model is used to detect faces in the submitted image. A detection model name
+    # can be provided when performing Face - Detect or (Large)FaceList - Add Face
+    # or (Large)PersonGroup - Add Face. The default value is 'detection_01', if
+    # another model is needed, please explicitly specify it. Possible values
+    # include: 'detection_01', 'detection_02'
     # @param custom_headers [Hash{String => String}] A hash of custom headers that
     # will be added to the HTTP request.
     #
     # @return [MsRestAzure::AzureOperationResponse] HTTP response information.
     #
-    def add_face_from_url_with_http_info(large_face_list_id, url, user_data:nil, target_face:nil, custom_headers:nil)
-      add_face_from_url_async(large_face_list_id, url, user_data:user_data, target_face:target_face, custom_headers:custom_headers).value!
+    def add_face_from_url_with_http_info(large_face_list_id, url, user_data:nil, target_face:nil, detection_model:nil, custom_headers:nil)
+      add_face_from_url_async(large_face_list_id, url, user_data:user_data, target_face:target_face, detection_model:detection_model, custom_headers:custom_headers).value!
     end
 
     #
-    # 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.
+    # Add a face to a specified large face list, up to 1,000,000 faces.
+    # <br /> 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.
+    # <br /> 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.
+    # * The minimum detectable face size is 36x36 pixels in an image no larger than
+    # 1920x1080 pixels. Images with dimensions higher than 1920x1080 pixels will
+    # need a proportionally larger minimum face size.
+    # * Different 'detectionModel' values can be provided. To use and compare
+    # different detection models, please refer to [How to specify a detection
+    # model](https://docs.microsoft.com/en-us/azure/cognitive-services/face/face-api-how-to-topics/specify-detection-model)
+    # | Model | Recommended use-case(s) |
+    # | ---------- | -------- |
+    # | 'detection_01': | The default detection model for [LargeFaceList - Add
+    # Face](/docs/services/563879b61984550e40cbbe8d/operations/5a158c10d2de3616c086f2d3).
+    # Recommend for near frontal face detection. For scenarios with exceptionally
+    # large angle (head-pose) faces, occluded faces or wrong image orientation, the
+    # faces in such cases may not be detected. |
+    # | 'detection_02': | Detection model released in 2019 May with improved
+    # accuracy especially on small, side and blurry faces. |
+    #
+    # Quota:
+    # * Free-tier subscription quota: 1,000 faces per large face list.
+    # * S0-tier subscription quota: 1,000,000 faces per large face list.
     #
     # @param large_face_list_id [String] Id referencing a particular large face
     # list.
@@ -1216,12 +1395,18 @@ module Azure::CognitiveServices::Face::V1_0
     # is more than one face in the image, targetFace is required to specify which
     # face to add. No targetFace means there is only one face detected in the
     # entire image.
+    # @param detection_model [DetectionModel] Name of detection model. Detection
+    # model is used to detect faces in the submitted image. A detection model name
+    # can be provided when performing Face - Detect or (Large)FaceList - Add Face
+    # or (Large)PersonGroup - Add Face. The default value is 'detection_01', if
+    # another model is needed, please explicitly specify it. Possible values
+    # include: 'detection_01', 'detection_02'
     # @param [Hash{String => String}] A hash of custom headers that will be added
     # to the HTTP request.
     #
     # @return [Concurrent::Promise] Promise object which holds the HTTP response.
     #
-    def add_face_from_url_async(large_face_list_id, url, user_data:nil, target_face:nil, custom_headers:nil)
+    def add_face_from_url_async(large_face_list_id, url, user_data:nil, target_face:nil, detection_model:nil, custom_headers:nil)
       fail ArgumentError, '@client.endpoint is nil' if @client.endpoint.nil?
       fail ArgumentError, 'large_face_list_id is nil' if large_face_list_id.nil?
       fail ArgumentError, "'large_face_list_id' should satisfy the constraint - 'MaxLength': '64'" if !large_face_list_id.nil? && large_face_list_id.length > 64
@@ -1254,7 +1439,7 @@ module Azure::CognitiveServices::Face::V1_0
       options = {
           middlewares: [[MsRest::RetryPolicyMiddleware, times: 3, retry: 0.02], [:cookie_jar]],
           path_params: {'largeFaceListId' => large_face_list_id},
-          query_params: {'userData' => user_data,'targetFace' => target_face.nil? ? nil : target_face.join(',')},
+          query_params: {'userData' => user_data,'targetFace' => target_face.nil? ? nil : target_face.join(','),'detectionModel' => detection_model},
           body: request_content,
           headers: request_headers.merge(custom_headers || {}),
           base_url: request_url
@@ -1271,6 +1456,8 @@ module Azure::CognitiveServices::Face::V1_0
         end
 
         result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        result.correlation_request_id = http_response['x-ms-correlation-request-id'] unless http_response['x-ms-correlation-request-id'].nil?
+        result.client_request_id = http_response['x-ms-client-request-id'] unless http_response['x-ms-client-request-id'].nil?
         # Deserialize Response
         if status_code == 200
           begin
@@ -1381,6 +1568,8 @@ module Azure::CognitiveServices::Face::V1_0
         end
 
         result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        result.correlation_request_id = http_response['x-ms-correlation-request-id'] unless http_response['x-ms-correlation-request-id'].nil?
+        result.client_request_id = http_response['x-ms-client-request-id'] unless http_response['x-ms-client-request-id'].nil?
         # Deserialize Response
         if status_code == 200
           begin
@@ -1415,9 +1604,51 @@ module Azure::CognitiveServices::Face::V1_0
     end
 
     #
-    # 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.
+    # Add a face to a specified large face list, up to 1,000,000 faces.
+    # <br /> 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.
+    # <br /> 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.
+    # * The minimum detectable face size is 36x36 pixels in an image no larger than
+    # 1920x1080 pixels. Images with dimensions higher than 1920x1080 pixels will
+    # need a proportionally larger minimum face size.
+    # * Different 'detectionModel' values can be provided. To use and compare
+    # different detection models, please refer to [How to specify a detection
+    # model](https://docs.microsoft.com/en-us/azure/cognitive-services/face/face-api-how-to-topics/specify-detection-model)
+    # | Model | Recommended use-case(s) |
+    # | ---------- | -------- |
+    # | 'detection_01': | The default detection model for [LargeFaceList - Add
+    # Face](/docs/services/563879b61984550e40cbbe8d/operations/5a158c10d2de3616c086f2d3).
+    # Recommend for near frontal face detection. For scenarios with exceptionally
+    # large angle (head-pose) faces, occluded faces or wrong image orientation, the
+    # faces in such cases may not be detected. |
+    # | 'detection_02': | Detection model released in 2019 May with improved
+    # accuracy especially on small, side and blurry faces. |
+    #
+    # Quota:
+    # * Free-tier subscription quota: 1,000 faces per large face list.
+    # * S0-tier subscription quota: 1,000,000 faces per large face list.
     #
     # @param large_face_list_id [String] Id referencing a particular large face
     # list.
@@ -1430,20 +1661,68 @@ module Azure::CognitiveServices::Face::V1_0
     # is more than one face in the image, targetFace is required to specify which
     # face to add. No targetFace means there is only one face detected in the
     # entire image.
+    # @param detection_model [DetectionModel] Name of detection model. Detection
+    # model is used to detect faces in the submitted image. A detection model name
+    # can be provided when performing Face - Detect or (Large)FaceList - Add Face
+    # or (Large)PersonGroup - Add Face. The default value is 'detection_01', if
+    # another model is needed, please explicitly specify it. Possible values
+    # include: 'detection_01', 'detection_02'
     # @param custom_headers [Hash{String => String}] A hash of custom headers that
     # will be added to the HTTP request.
     #
     # @return [PersistedFace] operation results.
     #
-    def add_face_from_stream(large_face_list_id, image, user_data:nil, target_face:nil, custom_headers:nil)
-      response = add_face_from_stream_async(large_face_list_id, image, user_data:user_data, target_face:target_face, custom_headers:custom_headers).value!
+    def add_face_from_stream(large_face_list_id, image, user_data:nil, target_face:nil, detection_model:nil, custom_headers:nil)
+      response = add_face_from_stream_async(large_face_list_id, image, user_data:user_data, target_face:target_face, detection_model:detection_model, custom_headers:custom_headers).value!
       response.body unless response.nil?
     end
 
     #
-    # 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.
+    # Add a face to a specified large face list, up to 1,000,000 faces.
+    # <br /> 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.
+    # <br /> 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.
+    # * The minimum detectable face size is 36x36 pixels in an image no larger than
+    # 1920x1080 pixels. Images with dimensions higher than 1920x1080 pixels will
+    # need a proportionally larger minimum face size.
+    # * Different 'detectionModel' values can be provided. To use and compare
+    # different detection models, please refer to [How to specify a detection
+    # model](https://docs.microsoft.com/en-us/azure/cognitive-services/face/face-api-how-to-topics/specify-detection-model)
+    # | Model | Recommended use-case(s) |
+    # | ---------- | -------- |
+    # | 'detection_01': | The default detection model for [LargeFaceList - Add
+    # Face](/docs/services/563879b61984550e40cbbe8d/operations/5a158c10d2de3616c086f2d3).
+    # Recommend for near frontal face detection. For scenarios with exceptionally
+    # large angle (head-pose) faces, occluded faces or wrong image orientation, the
+    # faces in such cases may not be detected. |
+    # | 'detection_02': | Detection model released in 2019 May with improved
+    # accuracy especially on small, side and blurry faces. |
+    #
+    # Quota:
+    # * Free-tier subscription quota: 1,000 faces per large face list.
+    # * S0-tier subscription quota: 1,000,000 faces per large face list.
     #
     # @param large_face_list_id [String] Id referencing a particular large face
     # list.
@@ -1456,19 +1735,67 @@ module Azure::CognitiveServices::Face::V1_0
     # is more than one face in the image, targetFace is required to specify which
     # face to add. No targetFace means there is only one face detected in the
     # entire image.
+    # @param detection_model [DetectionModel] Name of detection model. Detection
+    # model is used to detect faces in the submitted image. A detection model name
+    # can be provided when performing Face - Detect or (Large)FaceList - Add Face
+    # or (Large)PersonGroup - Add Face. The default value is 'detection_01', if
+    # another model is needed, please explicitly specify it. Possible values
+    # include: 'detection_01', 'detection_02'
     # @param custom_headers [Hash{String => String}] A hash of custom headers that
     # will be added to the HTTP request.
     #
     # @return [MsRestAzure::AzureOperationResponse] HTTP response information.
     #
-    def add_face_from_stream_with_http_info(large_face_list_id, image, user_data:nil, target_face:nil, custom_headers:nil)
-      add_face_from_stream_async(large_face_list_id, image, user_data:user_data, target_face:target_face, custom_headers:custom_headers).value!
+    def add_face_from_stream_with_http_info(large_face_list_id, image, user_data:nil, target_face:nil, detection_model:nil, custom_headers:nil)
+      add_face_from_stream_async(large_face_list_id, image, user_data:user_data, target_face:target_face, detection_model:detection_model, custom_headers:custom_headers).value!
     end
 
     #
-    # 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.
+    # Add a face to a specified large face list, up to 1,000,000 faces.
+    # <br /> 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.
+    # <br /> 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.
+    # * The minimum detectable face size is 36x36 pixels in an image no larger than
+    # 1920x1080 pixels. Images with dimensions higher than 1920x1080 pixels will
+    # need a proportionally larger minimum face size.
+    # * Different 'detectionModel' values can be provided. To use and compare
+    # different detection models, please refer to [How to specify a detection
+    # model](https://docs.microsoft.com/en-us/azure/cognitive-services/face/face-api-how-to-topics/specify-detection-model)
+    # | Model | Recommended use-case(s) |
+    # | ---------- | -------- |
+    # | 'detection_01': | The default detection model for [LargeFaceList - Add
+    # Face](/docs/services/563879b61984550e40cbbe8d/operations/5a158c10d2de3616c086f2d3).
+    # Recommend for near frontal face detection. For scenarios with exceptionally
+    # large angle (head-pose) faces, occluded faces or wrong image orientation, the
+    # faces in such cases may not be detected. |
+    # | 'detection_02': | Detection model released in 2019 May with improved
+    # accuracy especially on small, side and blurry faces. |
+    #
+    # Quota:
+    # * Free-tier subscription quota: 1,000 faces per large face list.
+    # * S0-tier subscription quota: 1,000,000 faces per large face list.
     #
     # @param large_face_list_id [String] Id referencing a particular large face
     # list.
@@ -1481,12 +1808,18 @@ module Azure::CognitiveServices::Face::V1_0
     # is more than one face in the image, targetFace is required to specify which
     # face to add. No targetFace means there is only one face detected in the
     # entire image.
+    # @param detection_model [DetectionModel] Name of detection model. Detection
+    # model is used to detect faces in the submitted image. A detection model name
+    # can be provided when performing Face - Detect or (Large)FaceList - Add Face
+    # or (Large)PersonGroup - Add Face. The default value is 'detection_01', if
+    # another model is needed, please explicitly specify it. Possible values
+    # include: 'detection_01', 'detection_02'
     # @param [Hash{String => String}] A hash of custom headers that will be added
     # to the HTTP request.
     #
     # @return [Concurrent::Promise] Promise object which holds the HTTP response.
     #
-    def add_face_from_stream_async(large_face_list_id, image, user_data:nil, target_face:nil, custom_headers:nil)
+    def add_face_from_stream_async(large_face_list_id, image, user_data:nil, target_face:nil, detection_model:nil, custom_headers:nil)
       fail ArgumentError, '@client.endpoint is nil' if @client.endpoint.nil?
       fail ArgumentError, 'large_face_list_id is nil' if large_face_list_id.nil?
       fail ArgumentError, "'large_face_list_id' should satisfy the constraint - 'MaxLength': '64'" if !large_face_list_id.nil? && large_face_list_id.length > 64
@@ -1521,7 +1854,7 @@ module Azure::CognitiveServices::Face::V1_0
       options = {
           middlewares: [[MsRest::RetryPolicyMiddleware, times: 3, retry: 0.02], [:cookie_jar]],
           path_params: {'largeFaceListId' => large_face_list_id},
-          query_params: {'userData' => user_data,'targetFace' => target_face.nil? ? nil : target_face.join(',')},
+          query_params: {'userData' => user_data,'targetFace' => target_face.nil? ? nil : target_face.join(','),'detectionModel' => detection_model},
           body: request_content,
           headers: request_headers.merge(custom_headers || {}),
           base_url: request_url
@@ -1538,6 +1871,8 @@ module Azure::CognitiveServices::Face::V1_0
         end
 
         result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        result.correlation_request_id = http_response['x-ms-correlation-request-id'] unless http_response['x-ms-correlation-request-id'].nil?
+        result.client_request_id = http_response['x-ms-client-request-id'] unless http_response['x-ms-client-request-id'].nil?
         # Deserialize Response
         if status_code == 200
           begin