Model Base

Model Base

Bases: NormanBaseModel
Represents the root entity for a model family, containing shared metadata across all versions of the model.

A ModelBase groups all model previews (versions) and tracks aggregated usage information such as invocation counts.

Fields
  • id (str) Unique identifier for the model base.

  • account_id (str) Account that owns this model.

  • name (str) Human-readable name for the model base (not version-specific).

  • invocation_count (int) Total number of invocations across all model versions.

  • model_previews (list[ModelPreview]) List of model versions (previews) belonging to this base. Each element is a ModelPreview instance.

ModelPreview

Bases: NormanBaseModel

Represents a specific version of a model, including metadata, assets, and descriptive information.

Model previews are versioned instances under a ModelBase, each with its own version label, description, and activation status.

Fields
  • id (str) Unique identifier for this model preview. Defaults to "0".

  • account_id (str) Account that owns this model version.

  • model_base_id (str) Identifier of the parent ModelBase. Defaults to "0".

  • version_label (str) Version name or tag.

  • active (bool) Whether this version is currently active. Defaults to True.

  • creation_time (datetime) UTC timestamp when this version was created. Defaults to the current UTC time.

  • short_description (str) Human-readable summary describing this model version.

  • assets (list[ModelAsset]) List of assets associated with this model preview.

  • tags (list[AggregateTag]) List of tags aggregated at this version level.

ModelTag

Bases: NormanBaseModel
Represents a tag attached to a specific model version or model base.

Tags are used for categorization, search, and metadata annotation.

Fields
  • id (str) Unique identifier for the tag record. Defaults to "0".

  • account_id (str) Account that owns the tag. Defaults to "0".

  • model_id (str) Identifier of the model or model version this tag applies to. Defaults to "0".

  • name (str) The textual tag value.

ModelAsset

Bases: NormanBaseModel

Represents a stored asset associated with a model version, such as a file, artifact, or resource produced or required by the model.

Fields
  • id (str) Unique identifier for the asset. Defaults to "0".

  • account_id (str) Account that owns the asset.

  • model_id (str) Identifier of the model version this asset belongs to. Defaults to "0".

  • asset_name (str) Name of the asset.

·

©

2026

·

©

2026

·

©

2026