Model lifecycle policy

Each model on the Mistral Serverless API moves through a defined lifecycle, from initial release to retirement. Use these stages to choose the right model for production and plan migrations before a model is retired.

Lifecycle stages

Lifecycle stages

StageDescriptionSilent updates
LabsExperimental. Not for production.Yes
Public PreviewNear-final before General Availability.Yes
General AvailabilityProduction-ready and stable.No
DeprecatedRetirement announced. Still accessible until the retirement date.No
RetiredNo longer accessible.No
Labs

Labs

Labs models are experimental releases intended to collect feedback before we commit to a production model. They:

  • Are identified by a labs- prefix, for example labs-mistral-model-x-y.
  • Are free of charge.
  • Allow silent updates at any time.
  • Don't support data collection opt-out.
  • Aren't recommended for production use.
Public Preview

Public Preview

Public Preview is the stage for general public launches that aren't final yet. These models are actively promoted, but may receive updates before reaching General Availability. They:

  • Are priced at the same rate as General Availability models.
  • Allow silent updates.
  • Have no guaranteed path to General Availability, and may be retired before reaching it.
General Availability

General Availability

General Availability models are production-ready and stable. They:

  • Receive no silent updates.
  • Are the only models eligible for aliases -latest and -major. See model naming convention.
  • Are supported until retirement.
Model naming convention

Model naming convention

Model identifiers use a model-name-major-minor format, for example mistral-medium-3-5.

General Availability models support three aliases:

AliasExamplePoints to
model-name-latestmistral-medium-latestLatest General Availability version, across generations
model-name-majormistral-medium-3Latest minor version of that major generation
model-name-major-minormistral-medium-3-5Fixed major and minor version

Labs models are always prefixed with labs-. Public Preview models use the major-minor format but aren't eligible for a -latest or -major alias.

Warning

Aliases automatically switch to newer models once they reach General Availability. As a result, using an alias may expose you to silent updates in model behavior and pricing. For precise control, pin your deployment to a specific major.minor version identifier.

Deprecation policy

Deprecation policy

Deprecation is announced as soon as a replacement model is available. The replacement can be in General Availability or Public Preview.

StageNotice period
Labs1 month
Public Preview1 month
General Availability6 months
Third-party models1 month

During the deprecation period, the model remains accessible. Once retired, requests to its identifiers fail with a 404 error.