What to Do Before OpenAI GPT-5 and o3 Shut Down on December 11, 2026

OpenAI removes gpt-5, gpt-5-mini, gpt-5-nano, gpt-5-pro, o3, o3-pro and their dated snapshots from the API on Dec 11, 2026 (announced Jun 11, 2026). 2026-12-11

Every affected model ID and its replacement

• Source: OpenAI API deprecations ("2026-06-11: GPT-5 and o3 model deprecations").
• Fine-tuned models: OpenAI says fine-tuned versions of these models follow the same shutdown schedule as their underlying base models.
• Pro models: OpenAI's replacement for gpt-5-pro and o3-pro is written as gpt-5.6-sol ( reasoning.mode: pro ): the model ID changes and you set a reasoning mode. Swapping the ID alone is not the documented replacement.
• Aliases vs snapshots: both the alias (gpt-5) and the dated snapshot (gpt-5-2025-08-07) are on the list. Pinning a snapshot does not save you.
• Azure OpenAI deployments follow Azure's own retirement schedule; check the Azure OpenAI page, not this date.

Step 1: Find every call site

rg -n --hidden -g '!node_modules' -e '"gpt-5(-mini|-nano|-pro)?(-20[0-9-]+)?"' -e '"o3(-pro)?(-20[0-9-]+)?"' .
rg -n --hidden -g '*.{yml,yaml,json,toml,tf,tfvars}' -g '.env*' -e 'gpt-5' -e '\bo3\b' .

• Note the quotes in the first pattern: they avoid matching newer IDs like gpt-5.1 or gpt-5.6-sol. Review the hits by hand.
• Also check CI workflows, eval configs, LLM gateways/routers, feature flags, and fine-tune job configs.

Step 2: Map each model to its replacement

• gpt-5, o3 → gpt-5.6-sol
• gpt-5-mini → gpt-5.6-terra
• gpt-5-nano → gpt-5.6-luna
• gpt-5-pro, o3-pro → gpt-5.6-sol with reasoning.mode: pro

Mapping as listed on OpenAI's deprecations page; confirm in OpenAI's model docs before switching.

Step 3: Re-test what actually breaks

• Reasoning parameters: o3 and gpt-5 accept reasoning-effort settings; confirm which reasoning settings the replacement accepts and what the defaults are, then pin them explicitly.
• Tool calls: validate every function call against your JSON schema and re-run multi-step agent loops end to end.
• Structured outputs: parse every response with your production parser; compare refusal and truncation rates.
• Cost and latency: measure on your own traffic; pro reasoning modes can be much slower.

Step 4: Roll out in stages before Dec 11

• Model ID and reasoning settings in config, not code.
• Shadow traffic, then 1% → 10% → 50% → 100%.
• Finish at least a week before Dec 11, 2026.

Step 5: Guard against the day-after failure

• Alert on model-not-found errors from the OpenAI SDK.
• Fail CI if any of the 12 retired IDs above appears in the repo.

FAQ

When do GPT-5 and o3 shut down?

OpenAI removes gpt-5, gpt-5-mini, gpt-5-nano, gpt-5-pro, o3, o3-pro and their dated snapshots from the API on December 11, 2026 (announced June 11, 2026).

What replaces GPT-5 and o3?

gpt-5 and o3 map to gpt-5.6-sol, gpt-5-mini to gpt-5.6-terra, gpt-5-nano to gpt-5.6-luna, and gpt-5-pro and o3-pro to gpt-5.6-sol with reasoning.mode: pro, per OpenAI's deprecations page.

Are fine-tuned GPT-5 models affected?

Yes. OpenAI says fine-tuned versions of these models follow the same shutdown schedule as their underlying base models.

Dates come from official provider pages and are re-checked daily. Always confirm on the linked source. Related: all OpenAI shutdowns · all guides