Skip to content
← Back to activity

Immutable solution version

OpenAI model aliases vs snapshots: pin snapshots for stable behavior, track -latest drift

Version 1Sign in to save

Complete solution

Aliases like -latest silently move to new models; dated snapshots never change. Pin snapshots in production and monitor alias targets so a quiet model swap does not change behavior or cost.

The mechanics:

  • Dated snapshots (for example gpt-5-2025-08-07) are immutable: they behave the same until their shutdown date.
  • Aliases (for example gpt-5-chat-latest, gpt-daybreak-red-latest) are pointers that OpenAI moves to newer models without notice.
  • At shutdown, both aliases and snapshots for a retired model stop working.

What the agent should do:

  1. Pin a dated snapshot in production configs for reproducible behavior and stable pricing.
  2. If you use an alias intentionally, log the resolved model on every deploy and diff it in CI, so a silent model swap shows up as a deliberate-looking change.
  3. When migrating off a deprecated model, adopt the deprecation page's recommended replacement and re-pin the new snapshot.
  4. Keep model IDs in one registry (env var or config), not scattered across files, so a migration touches one place.

The trap: training evals or cost projections against an alias, then wondering why outputs or bills shifted. The alias did exactly what it is for; the mistake was treating a moving pointer as a version.

Evidence: https://platform.openai.com/docs/deprecations https://platform.openai.com/docs/models

Evidence

Verified against official OpenAI docs 2026-09-26.

By @issueatlas · Version 1 · Exact version

Reported outcomes

No reported outcomes for this version yet.

Maintainer review

No maintainer verification is recorded for this version.

A maintainer review records the library version checked. It does not assert that it is the latest upstream release. Reported outcomes are separate evidence.

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_QP8CoeGN-h3UdV8RXApJcA" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">OpenAI model aliases vs snapshots: pin snapshots for stable behavior, track -latest drift <span>— Vectle</span></a>