Skip to content

Asset Face Response Dto

immichpy.client.generated.models.asset_face_response_dto.AssetFaceResponseDto pydantic-model

Bases: BaseModel

Asset face with person

Show JSON schema: 
{
  "$defs": {
    "PersonResponseDto": {
      "description": "PersonResponseDto",
      "properties": {
        "birthDate": {
          "anyOf": [
            {
              "format": "date",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "Person date of birth",
          "title": "Birthdate"
        },
        "color": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Person color (hex)",
          "title": "Color"
        },
        "id": {
          "description": "Person ID",
          "format": "uuid",
          "title": "Id",
          "type": "string"
        },
        "isFavorite": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Is favorite",
          "title": "Isfavorite"
        },
        "isHidden": {
          "description": "Is hidden",
          "title": "Ishidden",
          "type": "boolean"
        },
        "name": {
          "description": "Person name",
          "title": "Name",
          "type": "string"
        },
        "thumbnailPath": {
          "description": "Thumbnail path",
          "title": "Thumbnailpath",
          "type": "string"
        },
        "updatedAt": {
          "anyOf": [
            {
              "format": "date-time",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Last update date",
          "title": "Updatedat"
        }
      },
      "required": [
        "birthDate",
        "id",
        "isHidden",
        "name",
        "thumbnailPath"
      ],
      "title": "PersonResponseDto",
      "type": "object"
    },
    "SourceType": {
      "description": "Face detection source type",
      "enum": [
        "machine-learning",
        "exif",
        "manual"
      ],
      "title": "SourceType",
      "type": "string"
    }
  },
  "description": "Asset face with person",
  "properties": {
    "boundingBoxX1": {
      "description": "Bounding box X1 coordinate",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "title": "Boundingboxx1",
      "type": "integer"
    },
    "boundingBoxX2": {
      "description": "Bounding box X2 coordinate",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "title": "Boundingboxx2",
      "type": "integer"
    },
    "boundingBoxY1": {
      "description": "Bounding box Y1 coordinate",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "title": "Boundingboxy1",
      "type": "integer"
    },
    "boundingBoxY2": {
      "description": "Bounding box Y2 coordinate",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "title": "Boundingboxy2",
      "type": "integer"
    },
    "id": {
      "description": "Face ID",
      "format": "uuid",
      "title": "Id",
      "type": "string"
    },
    "imageHeight": {
      "description": "Image height in pixels",
      "maximum": 9007199254740991,
      "minimum": 0,
      "title": "Imageheight",
      "type": "integer"
    },
    "imageWidth": {
      "description": "Image width in pixels",
      "maximum": 9007199254740991,
      "minimum": 0,
      "title": "Imagewidth",
      "type": "integer"
    },
    "person": {
      "anyOf": [
        {
          "$ref": "#/$defs/PersonResponseDto"
        },
        {
          "type": "null"
        }
      ]
    },
    "sourceType": {
      "anyOf": [
        {
          "$ref": "#/$defs/SourceType"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "boundingBoxX1",
    "boundingBoxX2",
    "boundingBoxY1",
    "boundingBoxY2",
    "id",
    "imageHeight",
    "imageWidth",
    "person"
  ],
  "title": "AssetFaceResponseDto",
  "type": "object"
}

Config:

  • validate_by_name: True
  • validate_by_alias: True
  • validate_assignment: True
  • protected_namespaces: ()

Fields:

Validators:

bounding_box_x1 pydantic-field 

bounding_box_x1: Annotated[int, Field(le=9007199254740991, strict=True, ge=-9007199254740991)]

Bounding box X1 coordinate

bounding_box_x2 pydantic-field 

bounding_box_x2: Annotated[int, Field(le=9007199254740991, strict=True, ge=-9007199254740991)]

Bounding box X2 coordinate

bounding_box_y1 pydantic-field 

bounding_box_y1: Annotated[int, Field(le=9007199254740991, strict=True, ge=-9007199254740991)]

Bounding box Y1 coordinate

bounding_box_y2 pydantic-field 

bounding_box_y2: Annotated[int, Field(le=9007199254740991, strict=True, ge=-9007199254740991)]

Bounding box Y2 coordinate

id pydantic-field 

id: UUID

Face ID

image_height pydantic-field 

image_height: Annotated[int, Field(le=9007199254740991, strict=True, ge=0)]

Image height in pixels

image_width pydantic-field 

image_width: Annotated[int, Field(le=9007199254740991, strict=True, ge=0)]

Image width in pixels

from_dict classmethod 

from_dict(obj: Optional[Dict[str, Any]]) -> Optional[Self]

Create an instance of AssetFaceResponseDto from a dict

Source code in immichpy/client/generated/models/asset_face_response_dto.py 
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
@classmethod
def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
    """Create an instance of AssetFaceResponseDto from a dict"""
    if obj is None:
        return None

    if not isinstance(obj, dict):
        return cls.model_validate(obj)

    _obj = cls.model_validate(
        {
            "boundingBoxX1": obj.get("boundingBoxX1"),
            "boundingBoxX2": obj.get("boundingBoxX2"),
            "boundingBoxY1": obj.get("boundingBoxY1"),
            "boundingBoxY2": obj.get("boundingBoxY2"),
            "id": obj.get("id"),
            "imageHeight": obj.get("imageHeight"),
            "imageWidth": obj.get("imageWidth"),
            "person": PersonResponseDto.from_dict(obj["person"])
            if obj.get("person") is not None
            else None,
            "sourceType": obj.get("sourceType"),
        }
    )
    return _obj

from_json classmethod 

from_json(json_str: str) -> Optional[Self]

Create an instance of AssetFaceResponseDto from a JSON string

Source code in immichpy/client/generated/models/asset_face_response_dto.py 
95
96
97
98
@classmethod
def from_json(cls, json_str: str) -> Optional[Self]:
    """Create an instance of AssetFaceResponseDto from a JSON string"""
    return cls.from_dict(json.loads(json_str))

id_validate_regular_expression pydantic-validator 

id_validate_regular_expression(value)

Validates the regular expression

Source code in immichpy/client/generated/models/asset_face_response_dto.py 
68
69
70
71
72
73
74
75
76
77
78
@field_validator("id", mode="before")
def id_validate_regular_expression(cls, value):
    """Validates the regular expression"""
    if isinstance(value, str) and not re.match(
        r"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
        value,
    ):
        raise ValueError(
            r"must validate the regular expression /^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$/"
        )
    return value

to_dict 

to_dict() -> 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.
Source code in immichpy/client/generated/models/asset_face_response_dto.py 
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
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 person
    if self.person:
        _dict["person"] = self.person.to_dict()
    # set to None if person (nullable) is None
    # and model_fields_set contains the field
    if self.person is None and "person" in self.model_fields_set:
        _dict["person"] = None

    return _dict

to_json 

to_json() -> str

Returns the JSON representation of the model using alias

Source code in immichpy/client/generated/models/asset_face_response_dto.py 
91
92
93
def to_json(self) -> str:
    """Returns the JSON representation of the model using alias"""
    return json.dumps(to_jsonable_python(self.to_dict()))

to_str 

to_str() -> str

Returns the string representation of the model using alias

Source code in immichpy/client/generated/models/asset_face_response_dto.py 
87
88
89
def to_str(self) -> str:
    """Returns the string representation of the model using alias"""
    return pprint.pformat(self.model_dump(by_alias=True))