regula-facesdk-webclient 7.2.388.dev0__py3-none-any.whl → 8.1.433.dev0__py3-none-any.whl

regula/facesdk/webclient/gen/models/device_info.py

@@ -0,0 +1,111 @@
+# coding: utf-8
+
+"""
+    Generated by: https://openapi-generator.tech
+"""
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from datetime import datetime
+from pydantic import BaseModel, ConfigDict, Field, StrictStr
+from typing import Any, ClassVar, Dict, List, Optional
+from typing import Optional, Set
+from typing_extensions import Self
+from pydantic import SkipValidation, Field
+
+class DeviceInfo(BaseModel):
+    """
+    DeviceInfo
+    """ # noqa: E501
+    app: SkipValidation[str] = Field(alias="app", description="Application name.")
+    license_id: SkipValidation[str] = Field(alias="licenseId", description="Unique license identifier.")
+    license_serial: SkipValidation[str] = Field(alias="licenseSerial", description="License serial number.")
+    license_valid_until: SkipValidation[datetime] = Field(alias="licenseValidUntil", description="License validity date.")
+    version: SkipValidation[str] = Field(alias="version", description="Product version.")
+    __properties: ClassVar[List[str]] = ["app", "licenseId", "licenseSerial", "licenseValidUntil", "version"]
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+        arbitrary_types_allowed=True,
+        use_enum_values=True
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of DeviceInfo from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        # set to None if license_id (nullable) is None
+        # and model_fields_set contains the field
+        if self.license_id is None and "license_id" in self.model_fields_set:
+            _dict['licenseId'] = None
+
+        # set to None if license_serial (nullable) is None
+        # and model_fields_set contains the field
+        if self.license_serial is None and "license_serial" in self.model_fields_set:
+            _dict['licenseSerial'] = None
+
+        # set to None if license_valid_until (nullable) is None
+        # and model_fields_set contains the field
+        if self.license_valid_until is None and "license_valid_until" in self.model_fields_set:
+            _dict['licenseValidUntil'] = None
+
+        # set to None if version (nullable) is None
+        # and model_fields_set contains the field
+        if self.version is None and "version" in self.model_fields_set:
+            _dict['version'] = None
+
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of DeviceInfo from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "app": obj.get("app"),
+            "licenseId": obj.get("licenseId"),
+            "licenseSerial": obj.get("licenseSerial"),
+            "licenseValidUntil": obj.get("licenseValidUntil"),
+            "version": obj.get("version")
+        })
+        return _obj
+
+

regula/facesdk/webclient/gen/models/face_attribute.py

@@ -0,0 +1,40 @@
+# coding: utf-8
+
+"""
+    Generated by: https://openapi-generator.tech
+"""
+
+from __future__ import annotations
+import json
+from enum import Enum
+from typing_extensions import Self
+
+
+class FaceAttribute(str, Enum):
+    """
+    The name of the attribute. For definitions, see the [FaceAttribute enum](https://docs.regulaforensics.com/develop/face-sdk/web-service/development/enums/face-attribute/).
+    """
+
+    """
+    allowed enum values
+    """
+    AGE = 'Age'
+    EMOTION = 'Emotion'
+    EYE_LEFT = 'EyeLeft'
+    EYE_RIGHT = 'EyeRight'
+    SMILE = 'Smile'
+    GLASSES = 'Glasses'
+    HEAD_COVERING = 'HeadCovering'
+    FOREHEAD_COVERING = 'ForeheadCovering'
+    MOUTH = 'Mouth'
+    MEDICAL_MASK = 'MedicalMask'
+    OCCLUSION = 'Occlusion'
+    STRONG_MAKEUP = 'StrongMakeup'
+    HEADPHONES = 'Headphones'
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Self:
+        """Create an instance of FaceAttribute from a JSON string"""
+        return cls(json.loads(json_str))
+
+

regula/facesdk/webclient/gen/models/face_image_quality_align_type.py

@@ -0,0 +1,32 @@
+# coding: utf-8
+
+"""
+    Generated by: https://openapi-generator.tech
+"""
+
+from __future__ import annotations
+import json
+from enum import Enum
+from typing_extensions import Self
+
+
+class FaceImageQualityAlignType(int, Enum):
+    """
+    The aspect ratio according to which face alignment is performed. See the [FaceImageQualityAlignType enum](https://docs.regulaforensics.com/develop/face-sdk/web-service/development/enums/face-image-quality-align-type/). To get a thumbnail with aspect ratio 3:4, set `0`.
+    """
+
+    """
+    allowed enum values
+    """
+    ALIGN_3x4 = 0
+    ALIGN_4x5 = 1
+    ALIGN_2x3 = 2
+    ALIGN_1x1 = 3
+    ALIGN_7x9 = 4
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Self:
+        """Create an instance of FaceImageQualityAlignType from a JSON string"""
+        return cls(json.loads(json_str))
+
+

regula/facesdk/webclient/gen/models/face_image_quality_groups.py

@@ -0,0 +1,35 @@
+# coding: utf-8
+
+"""
+    Generated by: https://openapi-generator.tech
+"""
+
+from __future__ import annotations
+import json
+from enum import Enum
+from typing_extensions import Self
+
+
+class FaceImageQualityGroups(int, Enum):
+    """
+    The group ID of the characteristic, see the [FaceImageQualityGroups enum](https://docs.regulaforensics.com/develop/face-sdk/web-service/development/enums/face-image-quality-groups/) for details.
+    """
+
+    """
+    allowed enum values
+    """
+    IMAGE_CHARACTERISTICS = 1
+    HEAD_SIZE_AND_POSITIONS = 2
+    FACE_QUALITY = 3
+    EYES_CHARACTERISTICS = 4
+    SHADOWS_AND_LIGHTNING = 5
+    POSE_AND_EXPRESSION = 6
+    HEAD_OCCLUSION = 7
+    BACKGROUND = 8
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Self:
+        """Create an instance of FaceImageQualityGroups from a JSON string"""
+        return cls(json.loads(json_str))
+
+

regula/facesdk/webclient/gen/models/face_image_quality_groups_strings.py

@@ -0,0 +1,35 @@
+# coding: utf-8
+
+"""
+    Generated by: https://openapi-generator.tech
+"""
+
+from __future__ import annotations
+import json
+from enum import Enum
+from typing_extensions import Self
+
+
+class FaceImageQualityGroupsStrings(str, Enum):
+    """
+    Face image quality assessment group name, see [FaceImageQualityGroups](https://docs.regulaforensics.com/develop/face-sdk/web-service/development/enums/face-image-quality-groups/).
+    """
+
+    """
+    allowed enum values
+    """
+    IMAGE_CHARACTERISTICS = 'ImageCharacteristics'
+    HEAD_SIZE_AND_POSITIONS = 'HeadSizeAndPosition'
+    FACE_QUALITY = 'FaceQuality'
+    EYES_CHARACTERISTICS = 'EyesCharacteristics'
+    SHADOWS_AND_LIGHTNING = 'ShadowsAndLightning'
+    POSE_AND_EXPRESSION = 'PoseAndExpression'
+    HEAD_OCCLUSION = 'HeadOcclusion'
+    BACKGROUND = 'Background'
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Self:
+        """Create an instance of FaceImageQualityGroupsStrings from a JSON string"""
+        return cls(json.loads(json_str))
+
+

regula/facesdk/webclient/gen/models/face_image_quality_status.py

@@ -0,0 +1,30 @@
+# coding: utf-8
+
+"""
+    Generated by: https://openapi-generator.tech
+"""
+
+from __future__ import annotations
+import json
+from enum import Enum
+from typing_extensions import Self
+
+
+class FaceImageQualityStatus(int, Enum):
+    """
+    The processing status returned for each quality characteristic, see the [FaceImageQualityStatus enum](https://docs.regulaforensics.com/develop/face-sdk/web-service/development/enums/face-image-quality-status/).
+    """
+
+    """
+    allowed enum values
+    """
+    QUALITY_STATUS_FALSE = 0
+    QUALITY_STATUS_TRUE = 1
+    QUALITY_STATUS_UNDETERMINED = 2
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Self:
+        """Create an instance of FaceImageQualityStatus from a JSON string"""
+        return cls(json.loads(json_str))
+
+

regula/facesdk/webclient/gen/models/face_quality_config_name.py

@@ -0,0 +1,75 @@
+# coding: utf-8
+
+"""
+    Generated by: https://openapi-generator.tech
+"""
+
+from __future__ import annotations
+import json
+from enum import Enum
+from typing_extensions import Self
+
+
+class FaceQualityConfigName(str, Enum):
+    """
+    The name of the characteristic. For definitions, see the [FaceQualityConfigName enum](https://docs.regulaforensics.com/develop/face-sdk/web-service/development/enums/face-quality-config-name/).
+    """
+
+    """
+    allowed enum values
+    """
+    IMAGE_WIDTH = 'ImageWidth'
+    IMAGE_HEIGHT = 'ImageHeight'
+    IMAGE_WIDTH_TO_HEIGHT = 'ImageWidthToHeight'
+    IMAGE_CHANNELS_NUMBER = 'ImageChannelsNumber'
+    PADDING_RATIO = 'PaddingRatio'
+    FACE_MID_POINT_HORIZONTAL_POSITION = 'FaceMidPointHorizontalPosition'
+    FACE_MID_POINT_VERTICAL_POSITION = 'FaceMidPointVerticalPosition'
+    HEAD_WIDTH_RATIO = 'HeadWidthRatio'
+    HEAD_HEIGHT_RATIO = 'HeadHeightRatio'
+    EYES_DISTANCE = 'EyesDistance'
+    YAW = 'Yaw'
+    PITCH = 'Pitch'
+    ROLL = 'Roll'
+    BLUR_LEVEL = 'BlurLevel'
+    NOISE_LEVEL = 'NoiseLevel'
+    EYE_RIGHT_CLOSED = 'EyeRightClosed'
+    EYE_LEFT_CLOSED = 'EyeLeftClosed'
+    EYE_RIGHT_OCCLUDED = 'EyeRightOccluded'
+    EYE_LEFT_OCCLUDED = 'EyeLeftOccluded'
+    EYES_RED = 'EyesRed'
+    EYE_RIGHT_COVERED_WITH_HAIR = 'EyeRightCoveredWithHair'
+    EYE_LEFT_COVERED_WITH_HAIR = 'EyeLeftCoveredWithHair'
+    OFF_GAZE = 'OffGaze'
+    FACE_DYNAMIC_RANGE = 'FaceDynamicRange'
+    UNNATURAL_SKIN_TONE = 'UnnaturalSkinTone'
+    TOO_DARK = 'TooDark'
+    TOO_LIGHT = 'TooLight'
+    FACE_GLARE = 'FaceGlare'
+    SHADOWS_ON_FACE = 'ShadowsOnFace'
+    DARK_GLASSES = 'DarkGlasses'
+    REFLECTION_ON_GLASSES = 'ReflectionOnGlasses'
+    FRAMES_TOO_HEAVY = 'FramesTooHeavy'
+    FACE_OCCLUDED = 'FaceOccluded'
+    HEAD_COVERING = 'HeadCovering'
+    BACKGROUND_UNIFORMITY = 'BackgroundUniformity'
+    SHADOWS_ON_BACKGROUND = 'ShadowsOnBackground'
+    OTHER_FACES = 'OtherFaces'
+    SHOULDERS_POSE = 'ShouldersPose'
+    EXPRESSION_LEVEL = 'ExpressionLevel'
+    MOUTH_OPEN = 'MouthOpen'
+    FOREHEAD_COVERING = 'ForeheadCovering'
+    SMILE = 'Smile'
+    STRONG_MAKEUP = 'StrongMakeup'
+    HEADPHONES = 'Headphones'
+    MEDICAL_MASK = 'MedicalMask'
+    BACKGROUND_COLOR_MATCH = 'BackgroundColorMatch'
+    ART_FACE = 'ArtFace'
+    CONTACT_LENSES = 'ContactLenses'
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Self:
+        """Create an instance of FaceQualityConfigName from a JSON string"""
+        return cls(json.loads(json_str))
+
+

regula/facesdk/webclient/gen/models/face_quality_scenarios.py

@@ -0,0 +1,37 @@
+# coding: utf-8
+
+"""
+    Generated by: https://openapi-generator.tech
+"""
+
+from __future__ import annotations
+import json
+from enum import Enum
+from typing_extensions import Self
+
+
+class FaceQualityScenarios(str, Enum):
+    """
+    Face detection scenario. If set and the scenario is found, it automatically applies the relevant parameters, overriding any other parameters specified in the request. If the scenario is not set, is empty, or the name is not recognized, processing will follow the parameters directly set in the request. For detailed descriptions of available scenarios, refer to the [Scenarios page](https://docs.regulaforensics.com/develop/face-sdk/web-service/development/usage/face-detection/scenarios/).
+    """
+
+    """
+    allowed enum values
+    """
+    OLD_MODE = 'OldMode'
+    QUALITY_FULL = 'QualityFull'
+    QUALITY_ICAO = 'QualityICAO'
+    QUALITY_VISA_SCHENGEN = 'QualityVisaSchengen'
+    QUALITY_VISA_USA = 'QualityVisaUSA'
+    CROP_CENTRAL_FACE = 'CropCentralFace'
+    CROP_ALL_FACES = 'CropAllFaces'
+    THUMBNAIL = 'Thumbnail'
+    ATTRIBUTES_ALL = 'AttributesAll'
+    EMPTY = ''
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Self:
+        """Create an instance of FaceQualityScenarios from a JSON string"""
+        return cls(json.loads(json_str))
+
+

regula/facesdk/webclient/gen/models/face_sdk_result.py

@@ -0,0 +1,83 @@
+# coding: utf-8
+
+"""
+    Generated by: https://openapi-generator.tech
+"""
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict
+from typing import Any, ClassVar, Dict, List
+from regula.facesdk.webclient.gen.models.face_sdk_result_code import FaceSDKResultCode
+from typing import Optional, Set
+from typing_extensions import Self
+from pydantic import SkipValidation, Field
+
+class FaceSDKResult(BaseModel):
+    """
+    FaceSDKResult
+    """ # noqa: E501
+    code: SkipValidation[FaceSDKResultCode] = Field(alias="code")
+    __properties: ClassVar[List[str]] = ["code"]
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+        arbitrary_types_allowed=True,
+        use_enum_values=True
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of FaceSDKResult from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of FaceSDKResult from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "code": obj.get("code")
+        })
+        return _obj
+
+

regula/facesdk/webclient/gen/models/face_sdk_result_code.py

@@ -0,0 +1,68 @@
+# coding: utf-8
+
+"""
+    Generated by: https://openapi-generator.tech
+"""
+
+from __future__ import annotations
+import json
+from enum import Enum
+from typing_extensions import Self
+
+
+class FaceSDKResultCode(int, Enum):
+    """
+    The result code, see the [FaceSDKResultCode enum](https://docs.regulaforensics.com/develop/face-sdk/web-service/development/enums/face-sdk-result-code/).
+    """
+
+    """
+    allowed enum values
+    """
+    FACER_OK = 0
+    FR_IMAGE_EMPTY = 1
+    FR_FACE_NOT_DETECTED = 2
+    FR_LANDMARKS_NOT_DETECTED = 3
+    FR_FACE_ALIGHNER_FAILED = 4
+    FR_DESCRIPTOR_EXTRACTOR_ERROR = 5
+    FR_IMAGE_DECODE_ERROR = 6
+    FR_INTERNAL_ERROR = 7
+    FACER_CONFIG_ERROR = 199
+    FACER_NO_LICENSE = 200
+    FACER_IS_NOT_INITIALIZED = 201
+    FACER_COMMAND_IS_NOT_SUPPORTED = 202
+    FACER_COMMAND_PARAMS_READ_ERROR = 203
+    FACER_LESS_THAN_TWO_IMAGES_IN_REQUEST = 224
+    FACER_VIDEO_DECODE_ERROR = 227
+    FACER_NOT_ENOUGH_FRAMES = 228
+    FACER_OUTPUT_IS_NOT_DEFINED = 229
+    FACER_CLOSED_EYES_DETECTED = 230
+    FACER_LOW_QUALITY = 231
+    FACER_HIGH_ASYMMETRY = 232
+    FACER_FACE_OVER_EMOTIONAL = 233
+    FACER_SUNGLASSES_DETECTED = 234
+    FACER_SMALL_AGE = 235
+    FACER_HEADDRESS_DETECTED = 236
+    FACER_FACES_NOT_MATCHED = 237
+    FACER_IMAGES_COUNT_LIMIT_EXCEEDED = 238
+    FACER_MEDICINE_MASK_DETECTED = 239
+    FACER_OCCLUSION_DETECTED = 240
+    FACER_FOREHEAD_GLASSES_DETECTED = 242
+    FACER_MOUTH_OPENED = 243
+    FACER_ART_MASK_DETECTED = 244
+    FACER_ELECTRONIC_DEVICE_DETECTED = 245
+    FACER_TRACK_BREAK = 246
+    FACER_WRONG_GEO = 247
+    FACER_WRONG_OF = 248
+    FACER_WRONG_VIEW = 249
+    FACER_TIMEOUT_LIVENESS_TRANSACTION = 250
+    FACER_FAILED_LIVENESS_TRANSACTION = 251
+    FACER_ABORTED_LIVENESS_TRANSACTION = 252
+    FACER_GENERAL_ERROR = 253
+    FACER_PASSIVE_LIVENESS_FAIL = 254
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Self:
+        """Create an instance of FaceSDKResultCode from a JSON string"""
+        return cls(json.loads(json_str))
+
+

regula/facesdk/webclient/gen/models/faces_response.py

@@ -0,0 +1,100 @@
+# coding: utf-8
+
+"""
+    Generated by: https://openapi-generator.tech
+"""
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, Field, StrictBytes, StrictFloat, StrictInt, StrictStr
+from typing import Any, ClassVar, Dict, List, Optional, Union
+from regula.facesdk.webclient.gen.models.person_with_images import PersonWithImages
+from typing import Optional, Set
+from typing_extensions import Self
+from pydantic import SkipValidation, Field
+
+class FacesResponse(BaseModel):
+    """
+    FacesResponse
+    """ # noqa: E501
+    face_index: SkipValidation[Optional[float]] = Field(alias="faceIndex", default=None, description="The detected face index number.")
+    landmarks: SkipValidation[Optional[List[List[float]]]] = Field(alias="landmarks", default=None, description="Absolute coordinates (x,y) of five points of each detected face: left eye, right eye, nose, left point of lips, right point of lips.")
+    rotation_angle: SkipValidation[Optional[float]] = Field(alias="rotationAngle", default=None, description="Angle of rotation of the face from the vertical axis, degrees.")
+    roi: SkipValidation[Optional[List[float]]] = Field(alias="roi", default=None, description="The rectangular area of a detected face that is represented by a set of four elements: the X and Y coordinates of the top-left point, and the width and height dimensions of the rectangle.")
+    crop: SkipValidation[Optional[bytearray]] = Field(alias="crop", default=None, description="Base64-encoded aligned and cropped portrait.")
+    persons: SkipValidation[Optional[List[PersonWithImages]]] = Field(alias="persons", default=None, description="Detected Persons.")
+    __properties: ClassVar[List[str]] = ["faceIndex", "landmarks", "rotationAngle", "roi", "crop", "persons"]
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+        arbitrary_types_allowed=True,
+        use_enum_values=True
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of FacesResponse from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        # override the default output from pydantic by calling `to_dict()` of each item in persons (list)
+        _items = []
+        if self.persons:
+            for _item_persons in self.persons:
+                if _item_persons:
+                    _items.append(_item_persons.to_dict())
+            _dict['persons'] = _items
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of FacesResponse from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "faceIndex": obj.get("faceIndex"),
+            "landmarks": obj.get("landmarks"),
+            "rotationAngle": obj.get("rotationAngle"),
+            "roi": obj.get("roi"),
+            "crop": obj.get("crop"),
+            "persons": [PersonWithImages.from_dict(_item) for _item in obj.get("persons", []) if PersonWithImages.from_dict(_item) is not None]
+        })
+        return _obj
+
+