denkproto 1.3.0__py3-none-any.whl

denkproto/json/inference_graph_recipe_schema.py

@@ -0,0 +1,336 @@
+# generated by datamodel-codegen:
+#   filename:  inference_graph_recipe.schema.json
+#   timestamp: 2025-11-18T09:31:57+00:00
+
+from __future__ import annotations
+
+from typing import Annotated, Literal, Optional, Union
+
+from pydantic import BaseModel, ConfigDict, Field, RootModel
+
+
+class ConstTensorFloat64Data(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    data_type: Literal['float64']
+    data: list[float]
+
+
+class ConstTensorInt64Data(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    data_type: Literal['int64']
+    data: list[int]
+
+
+class ConstTensorUint64Data(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    data_type: Literal['uint64']
+    data: list[int]
+
+
+class ImageSize(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    height: Annotated[int, Field(ge=1)]
+    width: Annotated[int, Field(ge=1)]
+
+
+class TargetSizeSourceTopic(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    source_type: Literal['topic']
+    topic: Annotated[
+        str, Field(pattern='^[a-zA-Z0-9_]+\\/[a-zA-Z0-9_]+([?]timeout=\\d+)?$')
+    ]
+
+
+class TargetSizeSourceImageSize(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    source_type: Literal['image_size']
+    size: ImageSize
+
+
+class ThresholdSourceTopic(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    source_type: Literal['topic']
+    topic: Annotated[
+        str, Field(pattern='^[a-zA-Z0-9_]+\\/[a-zA-Z0-9_]+([?]timeout=\\d+)?$')
+    ]
+
+
+class ThresholdSourceValue(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    source_type: Literal['value']
+    value: Annotated[float, Field(ge=0.0, le=1.0)]
+
+
+class ImagePatchesNode(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    node_type: Literal['image_patches']
+    name: str
+    input_image: Annotated[
+        str, Field(pattern='^[a-zA-Z0-9_]+\\/[a-zA-Z0-9_]+([?]timeout=\\d+)?$')
+    ]
+    input_bounding_boxes: Annotated[
+        str, Field(pattern='^[a-zA-Z0-9_]+\\/[a-zA-Z0-9_]+([?]timeout=\\d+)?$')
+    ]
+    input_target_size: Annotated[
+        Union[TargetSizeSourceTopic, TargetSizeSourceImageSize],
+        Field(
+            description='Source for the target size, either from a topic or a constant ImageSize.',
+            discriminator='source_type',
+        ),
+    ]
+    output_port_name: Annotated[str, Field(pattern='^[a-zA-Z0-9_-]+$')]
+
+
+class ImageResizeNode(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    node_type: Literal['image_resize']
+    name: str
+    input_size: Annotated[
+        str, Field(pattern='^[a-zA-Z0-9_]+\\/[a-zA-Z0-9_]+([?]timeout=\\d+)?$')
+    ]
+    input_image: Annotated[
+        str, Field(pattern='^[a-zA-Z0-9_]+\\/[a-zA-Z0-9_]+([?]timeout=\\d+)?$')
+    ]
+    output_port_name: Annotated[str, Field(pattern='^[a-zA-Z0-9_-]+$')]
+
+
+class ModelSourceFromNetworkExperimentId(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    source_type: Literal['network_experiment_id']
+    network_experiment_id: Annotated[
+        str,
+        Field(
+            description='Model from a network experiment ID.',
+            pattern='^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$',
+        ),
+    ]
+
+
+class ModelSourceFromNetworkId(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    source_type: Literal['network_id']
+    network_id: Annotated[
+        str,
+        Field(
+            description='Model from a network ID.',
+            pattern='^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$',
+        ),
+    ]
+
+
+class VirtualCameraNode(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    node_type: Literal['virtual_camera']
+    name: str
+    path: str
+    output_port_name: Annotated[str, Field(pattern='^[a-zA-Z0-9_-]+$')]
+
+
+class BoundingBoxFilterNode(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    node_type: Literal['bounding_box_filter']
+    name: str
+    input_bounding_boxes: Annotated[
+        str, Field(pattern='^[a-zA-Z0-9_]+\\/[a-zA-Z0-9_]+([?]timeout=\\d+)?$')
+    ]
+    input_score_threshold: Annotated[
+        Optional[Union[ThresholdSourceTopic, ThresholdSourceValue]],
+        Field(
+            description='Source for a threshold value (0.0-1.0), either from a topic or a constant value.',
+            discriminator='source_type',
+        ),
+    ] = None
+    input_iou_threshold: Annotated[
+        Optional[Union[ThresholdSourceTopic, ThresholdSourceValue]],
+        Field(
+            description='Source for a threshold value (0.0-1.0), either from a topic or a constant value.',
+            discriminator='source_type',
+        ),
+    ] = None
+    output_port_name: Annotated[str, Field(pattern='^[a-zA-Z0-9_-]+$')]
+
+
+class ConstTensorNode(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    node_type: Literal['const_tensor']
+    name: str
+    shape: list[int]
+    data: Annotated[
+        Union[ConstTensorUint64Data, ConstTensorInt64Data, ConstTensorFloat64Data],
+        Field(
+            description='Base type for constant tensor data.', discriminator='data_type'
+        ),
+    ]
+    output_port_name: Annotated[str, Field(pattern='^[a-zA-Z0-9_-]+$')]
+
+
+class ClassificationNode(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    node_type: Literal['image_classification']
+    name: str
+    input_image: Annotated[
+        str, Field(pattern='^[a-zA-Z0-9_]+\\/[a-zA-Z0-9_]+([?]timeout=\\d+)?$')
+    ]
+    model_source: Annotated[
+        Union[ModelSourceFromNetworkId, ModelSourceFromNetworkExperimentId],
+        Field(
+            description='Base type for the source of the model.',
+            discriminator='source_type',
+        ),
+    ]
+    output_port_name: Annotated[str, Field(pattern='^[a-zA-Z0-9_-]+$')]
+
+
+class ObjectDetectionNode(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    node_type: Literal['image_object_detection']
+    name: str
+    input_image: Annotated[
+        str, Field(pattern='^[a-zA-Z0-9_]+\\/[a-zA-Z0-9_]+([?]timeout=\\d+)?$')
+    ]
+    model_source: Annotated[
+        Union[ModelSourceFromNetworkId, ModelSourceFromNetworkExperimentId],
+        Field(
+            description='Base type for the source of the model.',
+            discriminator='source_type',
+        ),
+    ]
+    scale_bounding_boxes: Optional[bool] = True
+    output_port_name: Annotated[str, Field(pattern='^[a-zA-Z0-9_-]+$')]
+
+
+class OcrNode(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    node_type: Literal['image_ocr']
+    name: str
+    input_image: Annotated[
+        str, Field(pattern='^[a-zA-Z0-9_]+\\/[a-zA-Z0-9_]+([?]timeout=\\d+)?$')
+    ]
+    model_source: Annotated[
+        Union[ModelSourceFromNetworkId, ModelSourceFromNetworkExperimentId],
+        Field(
+            description='Base type for the source of the model.',
+            discriminator='source_type',
+        ),
+    ]
+    output_port_name: Annotated[str, Field(pattern='^[a-zA-Z0-9_-]+$')]
+
+
+class ImageSegmentationNode(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    node_type: Literal['image_segmentation']
+    name: str
+    input_image: Annotated[
+        str, Field(pattern='^[a-zA-Z0-9_]+\\/[a-zA-Z0-9_]+([?]timeout=\\d+)?$')
+    ]
+    model_source: Annotated[
+        Union[ModelSourceFromNetworkId, ModelSourceFromNetworkExperimentId],
+        Field(
+            description='Base type for the source of the model.',
+            discriminator='source_type',
+        ),
+    ]
+    output_port_name: Annotated[str, Field(pattern='^[a-zA-Z0-9_-]+$')]
+
+
+class ImageInstanceSegmentationNode(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    node_type: Literal['image_instance_segmentation']
+    name: str
+    input_image: Annotated[
+        str, Field(pattern='^[a-zA-Z0-9_]+\\/[a-zA-Z0-9_]+([?]timeout=\\d+)?$')
+    ]
+    model_source: Annotated[
+        Union[ModelSourceFromNetworkId, ModelSourceFromNetworkExperimentId],
+        Field(
+            description='Base type for the source of the model.',
+            discriminator='source_type',
+        ),
+    ]
+    output_bounding_boxes: Annotated[str, Field(pattern='^[a-zA-Z0-9_-]+$')]
+    output_segmentations: Annotated[str, Field(pattern='^[a-zA-Z0-9_-]+$')]
+
+
+class ImageAnomalyDetectionNode(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    node_type: Literal['image_anomaly_detection']
+    name: str
+    input_image: Annotated[
+        str, Field(pattern='^[a-zA-Z0-9_]+\\/[a-zA-Z0-9_]+([?]timeout=\\d+)?$')
+    ]
+    model_source: Annotated[
+        Union[ModelSourceFromNetworkId, ModelSourceFromNetworkExperimentId],
+        Field(
+            description='Base type for the source of the model.',
+            discriminator='source_type',
+        ),
+    ]
+    output_anomaly_scores: Annotated[str, Field(pattern='^[a-zA-Z0-9_-]+$')]
+    output_segmentations: Annotated[str, Field(pattern='^[a-zA-Z0-9_-]+$')]
+
+
+class InferenceGraphRecipe(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    nodes: list[
+        Union[
+            ConstTensorNode,
+            ImageResizeNode,
+            ImagePatchesNode,
+            VirtualCameraNode,
+            ClassificationNode,
+            ObjectDetectionNode,
+            OcrNode,
+            BoundingBoxFilterNode,
+            ImageSegmentationNode,
+            ImageInstanceSegmentationNode,
+            ImageAnomalyDetectionNode,
+        ]
+    ]
+    license_id: str
+    created_at: Annotated[
+        int, Field(description='Unix timestamp when the recipe was created')
+    ]

denkproto/json/instance_segmentation_markup_schema.py

@@ -0,0 +1,35 @@
+# generated by datamodel-codegen:
+#   filename:  instance_segmentation_markup.schema.json
+#   timestamp: 2025-11-10T14:10:34+00:00
+
+from __future__ import annotations
+
+from typing import Annotated
+from uuid import UUID
+
+from pydantic import BaseModel, ConfigDict, Field
+
+from . import geometry_schema
+
+
+class Annotation(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    top_left_x: Annotated[float, Field(ge=0.0, le=1.0)]
+    top_left_y: Annotated[float, Field(ge=0.0, le=1.0)]
+    bottom_right_x: Annotated[float, Field(ge=0.0, le=1.0)]
+    bottom_right_y: Annotated[float, Field(ge=0.0, le=1.0)]
+    mask: geometry_schema.BinaryMask
+    label_id: UUID
+
+
+class InstanceSegmentationMarkup(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    height: Annotated[int, Field(ge=0)]
+    width: Annotated[int, Field(ge=0)]
+    annotations: Annotated[
+        list[Annotation], Field(description='Instance segmentation annotations')
+    ]

denkproto/json/object_detection_markup_schema.py

@@ -0,0 +1,43 @@
+# generated by datamodel-codegen:
+#   filename:  object_detection_markup.schema.json
+#   timestamp: 2025-11-18T09:31:57+00:00
+
+from __future__ import annotations
+
+from enum import Enum
+from typing import Annotated, Optional
+from uuid import UUID
+
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class AnnotationType(Enum):
+    POSITIVE = 'POSITIVE'
+    NEGATIVE = 'NEGATIVE'
+    IGNORE = 'IGNORE'
+    ROI = 'ROI'
+
+
+class Annotation(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    id: UUID
+    label_id: UUID
+    annotation_type: AnnotationType
+    angle: Optional[float] = None
+    full_orientation: Optional[bool] = None
+    top_left_x: Annotated[float, Field(ge=0.0, le=1.0)]
+    top_left_y: Annotated[float, Field(ge=0.0, le=1.0)]
+    bottom_right_x: Annotated[float, Field(ge=0.0, le=1.0)]
+    bottom_right_y: Annotated[float, Field(ge=0.0, le=1.0)]
+    average_width: Annotated[float, Field(ge=0.0)]
+
+
+class ObjectDetectionMarkup(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    height: Annotated[int, Field(ge=0)]
+    width: Annotated[int, Field(ge=0)]
+    annotations: list[Annotation]

denkproto/json/ocr_markup_schema.py

@@ -0,0 +1,48 @@
+# generated by datamodel-codegen:
+#   filename:  ocr_markup.schema.json
+#   timestamp: 2025-11-18T09:31:57+00:00
+
+from __future__ import annotations
+
+from typing import Annotated, Optional, Union
+from uuid import UUID
+
+from pydantic import BaseModel, ConfigDict, Field, RootModel
+
+from . import geometry_schema
+
+
+class Annotations(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    id: UUID
+    label_id: UUID
+    text: str
+    bounding_box: geometry_schema.BoundingBox
+    polygon: Optional[geometry_schema.PolygonAnnotation] = None
+
+
+class Annotations1(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    id: UUID
+    label_id: UUID
+    text: str
+    bounding_box: Optional[geometry_schema.BoundingBox] = None
+    polygon: geometry_schema.PolygonAnnotation
+
+
+class AverageObjectWidth(RootModel[float]):
+    root: Annotated[float, Field(ge=0.0)]
+
+
+class OcrMarkup(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    height: Annotated[int, Field(ge=0)]
+    width: Annotated[int, Field(ge=0)]
+    annotations: list[Union[Annotations, Annotations1]]
+    average_object_widths: list[AverageObjectWidth]

denkproto/json/segmentation_markup_schema.py

@@ -0,0 +1,242 @@
+# generated by datamodel-codegen:
+#   filename:  segmentation_markup.schema.json
+#   timestamp: 2025-11-18T09:31:57+00:00
+
+from __future__ import annotations
+
+from enum import Enum
+from typing import Annotated, Optional, Union
+from uuid import UUID
+
+from pydantic import AnyUrl, BaseModel, ConfigDict, Field, RootModel
+
+from . import geometry_schema
+
+
+class AnnotationType(Enum):
+    POSITIVE = 'POSITIVE'
+    NEGATIVE = 'NEGATIVE'
+    IGNORE = 'IGNORE'
+    ROI = 'ROI'
+
+
+class AverageObjectWidth(RootModel[float]):
+    root: Annotated[float, Field(ge=0.0)]
+
+
+class CircleAnnotation(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    center_x: Annotated[float, Field(ge=0.0, le=1.0)]
+    center_y: Annotated[float, Field(ge=0.0, le=1.0)]
+    radius: Annotated[float, Field(ge=0.0, le=1.0)]
+
+
+class Point(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    x: Annotated[float, Field(ge=0.0, le=1.0)]
+    y: Annotated[float, Field(ge=0.0, le=1.0)]
+
+
+class MagicwandAnnotation(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    top_left_x: Annotated[float, Field(ge=0.0, le=1.0)]
+    top_left_y: Annotated[float, Field(ge=0.0, le=1.0)]
+    bottom_right_x: Annotated[float, Field(ge=0.0, le=1.0)]
+    bottom_right_y: Annotated[float, Field(ge=0.0, le=1.0)]
+    center_x: Annotated[float, Field(ge=0.0, le=1.0)]
+    center_y: Annotated[float, Field(ge=0.0, le=1.0)]
+    dataURL: AnyUrl
+    points: list[Point]
+    threshold: Annotated[int, Field(ge=0)]
+
+
+class PenAnnotation(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    top_left_x: Annotated[float, Field(ge=0.0, le=1.0)]
+    top_left_y: Annotated[float, Field(ge=0.0, le=1.0)]
+    bottom_right_x: Annotated[float, Field(ge=0.0, le=1.0)]
+    bottom_right_y: Annotated[float, Field(ge=0.0, le=1.0)]
+    dataURL: AnyUrl
+    points: list[Point]
+    thickness: Annotated[float, Field(ge=0.0, le=1.0)]
+
+
+class PixelAnnotation(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    top_left_x: Annotated[float, Field(ge=0.0, le=1.0)]
+    top_left_y: Annotated[float, Field(ge=0.0, le=1.0)]
+    bottom_right_x: Annotated[float, Field(ge=0.0, le=1.0)]
+    bottom_right_y: Annotated[float, Field(ge=0.0, le=1.0)]
+    blob_id: UUID
+
+
+class RectangleAnnotation(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    top_left_x: Annotated[float, Field(ge=0.0, le=1.0)]
+    top_left_y: Annotated[float, Field(ge=0.0, le=1.0)]
+    bottom_right_x: Annotated[float, Field(ge=0.0, le=1.0)]
+    bottom_right_y: Annotated[float, Field(ge=0.0, le=1.0)]
+
+
+class SausageAnnotation(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    top_left_x: Annotated[float, Field(ge=0.0, le=1.0)]
+    top_left_y: Annotated[float, Field(ge=0.0, le=1.0)]
+    bottom_right_x: Annotated[float, Field(ge=0.0, le=1.0)]
+    bottom_right_y: Annotated[float, Field(ge=0.0, le=1.0)]
+    dataURL: AnyUrl
+    points: list[Point]
+    radius: Annotated[float, Field(ge=0.0, le=1.0)]
+
+
+class Annotations(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    id: UUID
+    label_id: UUID
+    annotation_type: AnnotationType
+    average_width: Annotated[float, Field(ge=0.0)]
+    circle_annotation: CircleAnnotation
+    magicwand_annotation: Optional[MagicwandAnnotation] = None
+    pen_annotation: Optional[PenAnnotation] = None
+    pixel_annotation: Optional[PixelAnnotation] = None
+    polygon_annotation: Optional[geometry_schema.PolygonAnnotation] = None
+    rectangle_annotation: Optional[RectangleAnnotation] = None
+    sausage_annotation: Optional[SausageAnnotation] = None
+
+
+class Annotations3(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    id: UUID
+    label_id: UUID
+    annotation_type: AnnotationType
+    average_width: Annotated[float, Field(ge=0.0)]
+    circle_annotation: Optional[CircleAnnotation] = None
+    magicwand_annotation: MagicwandAnnotation
+    pen_annotation: Optional[PenAnnotation] = None
+    pixel_annotation: Optional[PixelAnnotation] = None
+    polygon_annotation: Optional[geometry_schema.PolygonAnnotation] = None
+    rectangle_annotation: Optional[RectangleAnnotation] = None
+    sausage_annotation: Optional[SausageAnnotation] = None
+
+
+class Annotations4(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    id: UUID
+    label_id: UUID
+    annotation_type: AnnotationType
+    average_width: Annotated[float, Field(ge=0.0)]
+    circle_annotation: Optional[CircleAnnotation] = None
+    magicwand_annotation: Optional[MagicwandAnnotation] = None
+    pen_annotation: PenAnnotation
+    pixel_annotation: Optional[PixelAnnotation] = None
+    polygon_annotation: Optional[geometry_schema.PolygonAnnotation] = None
+    rectangle_annotation: Optional[RectangleAnnotation] = None
+    sausage_annotation: Optional[SausageAnnotation] = None
+
+
+class Annotations5(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    id: UUID
+    label_id: UUID
+    annotation_type: AnnotationType
+    average_width: Annotated[float, Field(ge=0.0)]
+    circle_annotation: Optional[CircleAnnotation] = None
+    magicwand_annotation: Optional[MagicwandAnnotation] = None
+    pen_annotation: Optional[PenAnnotation] = None
+    pixel_annotation: PixelAnnotation
+    polygon_annotation: Optional[geometry_schema.PolygonAnnotation] = None
+    rectangle_annotation: Optional[RectangleAnnotation] = None
+    sausage_annotation: Optional[SausageAnnotation] = None
+
+
+class Annotations6(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    id: UUID
+    label_id: UUID
+    annotation_type: AnnotationType
+    average_width: Annotated[float, Field(ge=0.0)]
+    circle_annotation: Optional[CircleAnnotation] = None
+    magicwand_annotation: Optional[MagicwandAnnotation] = None
+    pen_annotation: Optional[PenAnnotation] = None
+    pixel_annotation: Optional[PixelAnnotation] = None
+    polygon_annotation: geometry_schema.PolygonAnnotation
+    rectangle_annotation: Optional[RectangleAnnotation] = None
+    sausage_annotation: Optional[SausageAnnotation] = None
+
+
+class Annotations7(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    id: UUID
+    label_id: UUID
+    annotation_type: AnnotationType
+    average_width: Annotated[float, Field(ge=0.0)]
+    circle_annotation: Optional[CircleAnnotation] = None
+    magicwand_annotation: Optional[MagicwandAnnotation] = None
+    pen_annotation: Optional[PenAnnotation] = None
+    pixel_annotation: Optional[PixelAnnotation] = None
+    polygon_annotation: Optional[geometry_schema.PolygonAnnotation] = None
+    rectangle_annotation: RectangleAnnotation
+    sausage_annotation: Optional[SausageAnnotation] = None
+
+
+class Annotations8(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    id: UUID
+    label_id: UUID
+    annotation_type: AnnotationType
+    average_width: Annotated[float, Field(ge=0.0)]
+    circle_annotation: Optional[CircleAnnotation] = None
+    magicwand_annotation: Optional[MagicwandAnnotation] = None
+    pen_annotation: Optional[PenAnnotation] = None
+    pixel_annotation: Optional[PixelAnnotation] = None
+    polygon_annotation: Optional[geometry_schema.PolygonAnnotation] = None
+    rectangle_annotation: Optional[RectangleAnnotation] = None
+    sausage_annotation: SausageAnnotation
+
+
+class SegmentationMarkup(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    height: Annotated[int, Field(ge=0)]
+    width: Annotated[int, Field(ge=0)]
+    annotations: list[
+        Union[
+            Annotations,
+            Annotations3,
+            Annotations4,
+            Annotations5,
+            Annotations6,
+            Annotations7,
+            Annotations8,
+        ]
+    ]
+    average_object_widths: list[AverageObjectWidth]