FIELD GUIDE

Foundation Model Names, Pinned Releases and Why API Aliases Can Break Reproducibility

A product name is not a model identifier. The words “Claude,” “Gemini,” or “GPT” describe families or products; an API request specifies a model string, sometimes through a convenience alias. Two requests using the same marketing name.

A product name is not a model identifier. The words “Claude,” “Gemini,” or “GPT” describe families or products; an API request specifies a model string, sometimes through a convenience alias. Two requests using the same marketing name months apart may therefore be impossible to compare fairly. Release announcements, model cards, API changelogs and deprecation schedules answer different questions. A launch post establishes that a capability existed on a date; a model reference establishes a particular endpoint; a retirement notice establishes when requests stop working.

Three kinds of name

A fixed snapshot binds a deployment to a specific model release. A family label groups related releases, while an alias can be repointed by its operator. OpenAI documents dated snapshots, and Anthropic explains that its dateless identifiers from the Claude 4.6 generation are themselves pinned snapshots, not automatically moving aliases. Earlier Claude shortcuts can behave differently. Google describes stable, preview, experimental and “latest” patterns, and warns that latest aliases move. DeepSeek documents an even more important case: deepseek-chat and deepseek-reasoner changed underlying models over time.

How to pin and audit

Store provider, exact model parameter, endpoint family, first successful request date, response model field when available, documented release date, region, tier, tokenizer or SDK version and any routing profile. Keep a versioned prompt, corpus and scoring script. If an identifier is itself a mutable alias, record the resolved target only where the provider explicitly supplies it; otherwise mark resolution unknown. A retirement date is different from an announcement date and should never be guessed from the digits in an ID.

A real migration trap

A team might report an improvement from “DeepSeek Reasoner” in January 2025 to the same name in late 2025. DeepSeek’s official changelog associates that name first with R1 and later with V3.2 thinking mode. An observed difference could come from different weights rather than a prompt improvement. Freeze the first test environment and rerun both configurations against held-out cases before crediting an optimization.

Decision rule

Choose the exact pinned ID for audited workflows; choose a moving alias only when continuous upgrades are intentional and you can run smoke tests on every change. Treat each API version or routing-region ID as a separate deployment record. Cross-cloud equivalents are not automatically byte-identical deployments.

What to verify before adopting this model or method

Use the exact release ID and API endpoint; confirm your geographic processing location, entitlement tier, model lifecycle, feature flags, context and output limits from the provider console. Run a reproducible evaluation on your own data and retain human oversight for consequential actions. Where a specification, price, commercial license or entitlement is not verified for your deployment, this article deliberately leaves it unasserted instead of filling a plausible number.

Documentation clarification (25 October 2026)

Anthropic documents that Claude 4.6 and later dateless IDs identify fixed model snapshots, unlike certain earlier aliases. Google distinguishes stable, preview, experimental and moving “latest” identifiers. Freeze the model string and keep a separate routing record when doing longitudinal evaluations.

Sources & Further Reading

Source documentation establishes vendor-published facts, not independently measured model quality, tenant access, contractual rights or current prices. Use a dated pricing ledger and an account-specific entitlement check for deployment decisions.

CONTINUE EXPLORINGExplore related files ↗