AI model deprecations: dates, replacements, and migration checks

The permanent record of AI model retirements: what's going dark, when, what replaces it, and what the swap does to your bill.

· July 23–24 retirements re-verified against current OpenAI, Anthropic, and DeepSeek documentation · View changelog

Claude modelsretired June 15, 2026
OpenAI modelsshut down Oct 23, 2026
Anthropic noticeminimum, public models
OpenAI noticeminimum, GA models

Current and upcoming shutdowns in 2026

Each model below has an announced end date from its provider. The migration column is the provider's official pick. Where benchr's pick differs (usually on price), the linked page explains why.

Announced retirements, re-verified July 27, 2026 against official deprecation docs
ModelProviderShuts downOfficial replacementDetails
Claude Opus 4.1AnthropicAug 5, 2026Claude Opus 4.8Migration page
GPT-5.2 / GPT-5.3 chat-latestOpenAIAug 10, 2026GPT-5.6 SolLater chat-latest wave; separate from the July 23 records
Assistants APIOpenAIAug 26, 2026Responses + Conversations APIPlatform retirement, not a model
Sora 2 / Sora 2 ProOpenAISep 24, 2026None listedVideos API sunsets the same day; see the video roundup
Gemini 2.5 ProGoogleOct 16, 2026Gemini 3.1 Pro PreviewMigration page
Gemini 2.5 FlashGoogleOct 16, 2026Gemini 3.6 FlashMigration page; input price rises 5×
GPT-4oOpenAIOct 23, 2026GPT-5.5Migration page
GPT-4, GPT-4 Turbo, GPT-3.5OpenAIOct 23, 2026GPT-5.5 / GPT-5.4 miniOctober wave page
o1, o1-pro, o3-mini, o4-miniOpenAIOct 23, 2026GPT-5.5 / GPT-5.5 ProOctober wave page
GPT-4.1 nano, GPT Image 1OpenAIOct 23, 2026GPT-5.4 nano / GPT Image 2gpt-4.1 and 4.1-mini have no announced date
Prompts API · Evals · Agent BuilderOpenAINov 30, 2026Agents SDK (Agent Builder)Platform retirements, announced June 3, 2026
GPT Image 1 mini / 1.5OpenAIDec 1, 2026GPT Image 2Announced June 2, 2026
Older GPT-5 / o3 snapshotsOpenAIDec 11, 2026GPT-5.5 / 5.4 mini / 5.4 nano / 5.5 ProDated snapshots only (gpt-5-2025-08-07, o3-2025-04-16, …); floating aliases stay. Announced June 11, 2026

The 2026 retirement timeline

  1. Mar 9Gemini 3 Pro Preview

    Shut down on the Gemini API after under four months. Vertex AI listed it discontinued by March 26.

  2. Apr 20Claude Haiku 3

    Retired. The last Claude 3-generation model to go.

  3. May 12DALL-E 2 and 3

    Removed from the API in favor of GPT Image 2.

  4. Jun 1Gemini 2.0 Flash family

    Shut down. Google's current recommended path is Gemini 3.6 Flash.

  5. Jun 15Claude Sonnet 4 + Opus 4

    Both retired on the Claude API. The Claude 4.x line replaces them at the same or lower price.

  6. Jun 25Gemini image previews

    Gemini 3 Pro Image Preview and 3.1 Flash Image Preview shut down; the stable gemini-3-pro-image and gemini-3.1-flash-image replace them.

  7. Jul 23OpenAI legacy IDs

    Five Codex IDs, both deep-research snapshots, computer-use-preview, and two chat snapshots retired on their recorded deadline.

  8. Jul 24DeepSeek aliases + Opus 4.7 fast mode

    DeepSeek's legacy aliases became inaccessible after 15:59 UTC; Opus 4.7 fast requests now return an error. Standard Opus 4.7 remains available.

  9. Aug 5Claude Opus 4.1

    Retires exactly one year after its August 5, 2025 release.

  10. Oct 16Gemini 2.5 Pro + Flash

    Both model IDs share the same recorded retirement date. The listed replacements cost more in this comparison, so recalculate the workload before cutover.

  11. Oct 23OpenAI model-ID retirements

    The recorded date covers GPT-4o, GPT-4, GPT-4 Turbo, GPT-3.5 Turbo, GPT-4.1 nano, GPT Image 1, o1, o1-pro, o3-mini, and o4-mini IDs.

How each provider retires models

Anthropic labels models active, legacy, deprecated, then retired, and commits to at least 60 days' notice for publicly released models. Each active model carries a published "not sooner than" date: Opus 4.8, for instance, won't retire before May 28, 2027. Dates apply to the Claude API, AWS, and Microsoft Foundry; Bedrock and Vertex run their own schedules. Anthropic has also committed to preserving model weights and says it hopes to make past models available again someday.

OpenAI gives at least six months for generally available models, three for specialized variants, and as little as two weeks for previews. The April 22, 2026 announcement that ends the GPT-4 era was the largest single deprecation notice any provider has issued — and it didn't stop at models. A follow-up on June 3 scheduled three platform products for November 30: the Reusable Prompts API, the Evals dashboard and API, and Agent Builder (whose official path forward is the Agents SDK).

Google publishes earliest-possible shutdown dates rather than firm ones, then confirms exact dates closer in. Preview models can go fast. Gemini 3 Pro Preview lasted 16 weeks.

Past recorded retirement dates

The permanent record: dates that have passed; provider runtime status can lag a published deadline
ModelProviderRecorded dateSuccessor
o3 / o4-mini-deep-researchOpenAIJul 23, 2026GPT-5.5 Pro
gpt-5 / 5.1-chat-latestOpenAIJul 23, 2026GPT-5.5
Codex models (gpt-5-codex → 5.2-codex)OpenAIJul 23, 2026GPT-5.5 / GPT-5.4 mini
computer-use-previewOpenAIJul 23, 2026GPT-5.4 mini
deepseek-chat / deepseek-reasoner (legacy aliases)DeepSeekJul 24, 2026DeepSeek V4-Flash / V4-Pro
Claude Opus 4.7 fast modeAnthropicJul 24, 2026Claude Opus 4.8 fast mode
Gemini 3 Pro Image PreviewGoogleJun 25, 2026Gemini 3 Pro Image (stable)
Gemini 3.1 Flash Image PreviewGoogleJun 25, 2026Gemini 3.1 Flash Image (stable)
Claude Sonnet 4AnthropicJun 15, 2026Claude Sonnet 4.6
Claude Opus 4AnthropicJun 15, 2026Claude Opus 4.8
Gemini 2.0 Flash familyGoogleJun 1, 2026Gemini 3.6 Flash
DALL-E 2 / DALL-E 3OpenAIMay 12, 2026GPT Image 2
Claude Haiku 3AnthropicApr 20, 2026Claude Haiku 4.5
Gemini 3 Pro PreviewGoogleMar 9, 2026Gemini 3.1 Pro Preview
Claude Sonnet 3.7AnthropicFeb 19, 2026Claude Sonnet 4.6
Claude Haiku 3.5AnthropicFeb 19, 2026Claude Haiku 4.5
Claude 3 OpusAnthropicJan 5, 2026Claude Opus 4.8
Claude Sonnet 3.5 (both snapshots)AnthropicOct 28, 2025Claude Sonnet 4.6

A 15-minute model-ID audit

Older model IDs often remain in production configuration after a newer default ships. Run these three checks:

1. Grep your codebase for every model string in the tables above, including date-suffixed snapshots like gpt-4o-2024-05-13 and claude-sonnet-4-20250514. Aliases hide in config files and environment variables, not just code.

Already seeing failures? A retired ID surfaces as model_not_found on OpenAI and not_found_error on Anthropic — the error database has the per-provider diagnosis and code fixes.

2. Pull your usage export. Anthropic's console has a per-key, per-model CSV export. OpenAI's usage dashboard breaks down by model. Five minutes tells you which deprecated IDs still get real traffic.

3. Price the replacement before you swap. Same-provider upgrades aren't always neutral. Gemini 2.5 Flash users face a 5× input price jump, while Claude Opus 4 users save two-thirds. Run your token volumes through the cost calculator before picking the target, and check the current rankings in case a different provider now fits better.

Frequently asked

Which AI models shut down next?

The July 23 OpenAI legacy IDs, July 24 DeepSeek aliases, and Claude Opus 4.7 fast mode are now in the historical record. Next are Claude Opus 4.1 on August 5 and GPT-5.2 / GPT-5.3 chat-latest snapshots on August 10, followed by Gemini 2.5 Pro and Flash on October 16.

What happens to API calls after retirement?

They fail. Each provider defines a lifecycle (active, deprecated, retired) and publishes a recommended replacement. Once a model passes its retirement date, requests to that ID return errors, and fine-tuned variants built on it stop working too.

How much notice do providers give?

Anthropic: at least 60 days for public models. OpenAI: at least 6 months for GA models, 3 months for specialized variants, about two weeks for previews. Google: publishes earliest-possible dates and confirms the real one later.

Do replacement models cost more?

Sometimes less, sometimes a lot more. Opus 4 to Opus 4.8 cuts your bill by two-thirds. Gemini 2.5 Flash to 3.6 Flash multiplies input cost by five. Every migration page here shows the before-and-after math so you can decide with numbers.

Changelog

  • — Moved the July 23 OpenAI records into the past-date table and marked the July 24 records as today's deadlines. The page does not claim runtime removal without a fresh provider or API-status confirmation.
  • — Refreshed the current-deadline summary for the OpenAI legacy-ID wave recorded for July 23 and the Claude/DeepSeek records dated July 24. Historical retirements remain in the table.
  • — Gemini 3 Pro Image Preview and Gemini 3.1 Flash Image Preview moved from "shutdowns ahead" to "retired": their June 25, 2026 shutdown has passed, re-confirmed on Google's official deprecation table. Replacements are the GA gemini-3-pro-image and gemini-3.1-flash-image. Logged in deprecations.json.
  • — Added OpenAI's June 11, 2026 deprecation of older GPT-5 and o3 dated snapshots (gpt-5-2025-08-07, gpt-5-mini/nano-2025-08-07, gpt-5-pro-2025-10-06, o3-2025-04-16, o3-pro-2025-06-10), removed from the API December 11, 2026. The floating gpt-5 / gpt-5-mini / gpt-5-nano aliases stay live. Verified on the official OpenAI deprecations page; logged in deprecations.json.
  • — Claude Sonnet 4 and Claude Opus 4 moved from "shutdowns ahead" to "retired": their June 15, 2026 shutdown has passed, re-confirmed on Anthropic's deprecation table. Opus 4.1 remains upcoming (August 5, 2026).
  • — Same-day expansion after a full re-read of all three providers' deprecation docs: added OpenAI's July 23 wave in full (five Codex IDs, o4-mini-deep-research, computer-use-preview), GPT-4.1 nano and GPT Image 1 to the October 23 list, the November 30 platform retirements (Prompts API, Evals, Agent Builder — announced June 3), and Gemini 3 Pro Image Preview (June 25). Logged Anthropic's official "not sooner than" retirement floors for all active Claude models in the dataset.
  • — Hub published with 14 upcoming retirements and 8 historical entries, all verified against Anthropic, OpenAI, and Google official deprecation docs.

Sources

  • Anthropic model deprecations — platform.claude.com/docs/en/about-claude/model-deprecations (verified June 12, 2026)
  • OpenAI deprecations — developers.openai.com/api/docs/deprecations (verified June 12, 2026)
  • Gemini API deprecations — ai.google.dev/gemini-api/docs/deprecations (verified June 12, 2026)
  • Anthropic deprecation commitments — anthropic.com/research/deprecation-commitments
  • benchr deprecations dataset (open JSON) — every entry carries its source and verification date