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 aModelPreviewinstance.
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 parentModelBase. Defaults to"0".version_label (
str) Version name or tag.active (
bool) Whether this version is currently active. Defaults toTrue.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.