Deprecated Models
This page contains information about models that have been deprecated by their respective providers and are no longer available through AvalAI.
Important: GPT-5 Chat Tags Are No Longer Available
The following GPT-5 -chat model tags are now deprecated and no longer available through AvalAI. They are not overridden or automatically routed to base models. Requests using these IDs will fail, so you must update your integration to use the corresponding model name without -chat:
| Deprecated model | Use instead |
|---|---|
gpt-5-chat | gpt-5 |
gpt-5-chat-latest | gpt-5 |
gpt-5.1-chat | gpt-5.1 |
gpt-5.2-chat | gpt-5.2 |
gpt-5.3-chat | gpt-5.3 |
Action required: Replace these deprecated IDs now. Use
gpt-5,gpt-5.1,gpt-5.2, orgpt-5.3directly, without the-chatsuffix.
The latest GPT model family now consists of gpt-5.6-sol, gpt-5.6-terra, and gpt-5.6-luna. Among these, gpt-5.6-luna has the lowest pricing and offers high cost-value return.
Overview
When AI model providers deprecate models, they are no longer available for new requests. This page serves as a comprehensive reference for deprecated models and provides guidance on migration to supported alternatives.
Deprecation Lifecycle
OpenAI's official deprecation guidance distinguishes between legacy, deprecated, and shut down models or endpoints:
- Legacy means the model or endpoint no longer receives active updates and should be treated as a migration candidate.
- Deprecated means the provider has announced retirement and published a shutdown or sunset date.
- Shut down means requests will no longer be served after the listed date.
OpenAI generally gives at least 6 months of notice for generally available models, at least 3 months for specialized GA variants such as chat, Codex, or deep-research snapshots, and much shorter notice for preview models. Other AvalAI providers may use different notice windows, so always treat provider announcements, this page, and the live /v1/models catalog as the source of truth.
Warning
If OpenAI recommends a replacement that is not yet enabled in AvalAI, choose the nearest supported equivalent from Model Selection, the provider page, or /v1/models instead of hard-coding an unavailable model ID.
Migration Playbook
Use this checklist before a shutdown date:
- Inventory usage: search code, prompts, config, queues, eval fixtures, and saved presets for deprecated IDs and aliases.
- Select supported replacements: prefer stable, non-preview model IDs in AvalAI; avoid
-latestaliases for regulated or regression-sensitive workloads. - Run side-by-side evals: compare quality, latency, cost, context-window usage, tool behavior, structured-output validity, and safety behavior.
- Ship behind controls: roll out through feature flags or per-customer configuration so you can revert quickly.
- Monitor the cutover: alert on
404,model_not_found, provider-routing errors, cost changes, and unexpectedusagedeltas.
Important Note on Model Naming
Best Practice: Always use stable model namespaces when they become available. When a preview model is first introduced (e.g.,
gemini-2.5-flash-image-preview), it may later be released as a stable version (e.g.,gemini-2.5-flash-image). In such cases, it is strongly advised to migrate to the non-preview, stable version as soon as possible to ensure continued support and optimal performance.
Upcoming Deprecations
OpenAI Deprecations
The following schedules reproduce OpenAI's published upstream deprecation data. Availability through AvalAI can differ from direct OpenAI availability, so verify a replacement in the live /v1/models catalog before migration.
2026-08-26: Transcription models
OpenAI will remove the following transcription models from its API on February 26, 2027:
| Shutdown date | Model / system | Recommended replacement |
|---|---|---|
| Feb 26, 2027 | whisper-1 | gpt-live-transcribe or gpt-transcribe |
| Feb 26, 2027 | gpt-4o-transcribe | gpt-live-transcribe or gpt-transcribe |
| Feb 26, 2027 | gpt-4o-mini-transcribe | gpt-live-transcribe or gpt-transcribe |
| Feb 26, 2027 | gpt-4o-transcribe-diarize | gpt-live-transcribe or gpt-transcribe |
See the transcription guide for migration details.
2026-07-20: Legacy audio, realtime, and transcription models
OpenAI will remove the following legacy model families and snapshot on January 20, 2027:
| Shutdown date | Model family / snapshot | Recommended replacement |
|---|---|---|
| Jan 20, 2027 | gpt-realtime | gpt-realtime-2.1 |
| Jan 20, 2027 | gpt-audio | gpt-audio-1.5 |
| Jan 20, 2027 | gpt-4o-audio | gpt-audio-1.5 |
| Jan 20, 2027 | gpt-4o-realtime | gpt-realtime-2.1 |
| Jan 20, 2027 | gpt-realtime-mini | gpt-realtime-2.1-mini |
| Jan 20, 2027 | gpt-audio-mini | gpt-audio-1.5 |
| Jan 20, 2027 | gpt-4o-mini-realtime | gpt-realtime-2.1-mini |
| Jan 20, 2027 | gpt-4o-mini-audio | gpt-audio-1.5 |
| Jan 20, 2027 | gpt-4o-mini-transcribe-2025-03-20 | gpt-4o-mini-transcribe-2025-12-15 |
2026-06-11: GPT-5 and o3 model deprecations
OpenAI notified developers using older GPT-5 and o3 snapshots that the following models will be removed from its API on December 11, 2026.
| Shutdown date | Model / system | Recommended replacement |
|---|---|---|
| Dec 11, 2026 | gpt-5-2025-08-07 | gpt-5.6-sol |
| Dec 11, 2026 | gpt-5-mini-2025-08-07 | gpt-5.6-terra |
| Dec 11, 2026 | gpt-5-nano-2025-08-07 | gpt-5.6-luna |
| Dec 11, 2026 | gpt-5-pro-2025-10-06 | gpt-5.6-sol (reasoning.mode: pro) |
| Dec 11, 2026 | o3-2025-04-16 | gpt-5.6-sol |
| Dec 11, 2026 | o3-pro-2025-06-10 | gpt-5.6-sol (reasoning.mode: pro) |
2026-06-03: Reusable prompts
Reusable prompt objects in the OpenAI dashboard and API are being deprecated.
| Date | Update |
|---|---|
| June 3, 2026 | Deprecation announced and prompt creation de-emphasized in the platform. |
| Nov 30, 2026 | The v1/prompts API and reusable prompt objects are scheduled to shut down. |
Move reusable prompt content into application code. See Migrate from prompt objects.
2026-06-03: Evals platform
OpenAI's Evals platform, including graders documented for eval workflows, is being deprecated. Fine-tuning timelines are listed separately below.
| Date | Update |
|---|---|
| June 3, 2026 | Deprecation announced for the Evals platform. |
| Oct 31, 2026 | Existing evals become read-only. |
| Nov 30, 2026 | The Evals dashboard and API are scheduled to shut down. |
See Moving from OpenAI Evals to Promptfoo for a migration path.
2026-06-03: Agent Builder
Agent Builder is being deprecated; ChatKit remains available.
| Date | Update |
|---|---|
| June 3, 2026 | Deprecation announced for Agent Builder. |
| Nov 30, 2026 | Agent Builder is scheduled to shut down. |
See Migrate from Agent Builder to continue with the Agents SDK or ChatGPT Workspace Agents.
2026-06-02: GPT Image model deprecations
| Shutdown date | Model / system | Recommended replacement |
|---|
For implementation examples, see Generate Images with GPT Image.
2026-05-07: Self-serve fine-tuning availability
Inference on fine-tuned models remains available until their base models are deprecated.
| Date | Update |
|---|---|
| May 7, 2026 | Creating fine-tuning jobs or training becomes unavailable to organizations that have not previously run fine-tuning. |
| July 2, 2026 | Creating fine-tuning jobs becomes unavailable to organizations that have not run inference on a fine-tuned model in the previous 60 days. |
| Jan 6, 2027 | Active existing customers can no longer create new fine-tuning jobs. Inference is disabled only when the underlying base model is deprecated. |
2026-04-22: Legacy GPT model snapshots
| Shutdown date | Model snapshot | Substitute model |
|---|
The following fine-tuned versions are also being removed:
| Shutdown date | Model snapshot | Recommended replacement base model |
|---|
2026-03-24: Sora 2 models and Videos API
| Shutdown date | Model / system | Recommended replacement |
|---|
2025-09-26: Legacy GPT model snapshots
| Shutdown date | Model / system | Recommended replacement |
|---|
Past OpenAI Deprecations
2025-08-20: Assistants API
The Assistants API shut down on August 26, 2026. See the Assistants-to-Conversations migration guide.
| Shutdown date | Model / system | Recommended replacement |
|---|
2026-05-08: GPT-5.2 and GPT-5.3 chat snapshots
| Shutdown date | Model / system | Recommended replacement |
|---|
2026-04-22: Legacy GPT model snapshots shut down in July 2026
| Shutdown date | Model snapshot | Substitute model |
|---|
2025-11-14: DALL·E model snapshots
| Shutdown date | Model / system | Recommended replacement |
|---|
2025-09-26: Legacy GPT model snapshots shut down in March 2026
| Shutdown date | Model / system | Recommended replacement |
|---|
*For tasks that are especially latency-sensitive and do not require reasoning.
2025-09-15: Realtime API Beta
The Realtime API Beta was removed from the OpenAI API on May 12, 2026. See the beta-to-GA migration guide.
| Shutdown date | Model / system | Recommended replacement |
|---|
2025-09-15: GPT-4o realtime and audio preview models
| Shutdown date | Model / system | Recommended replacement |
|---|
2025-11-18: chatgpt-4o-latest
| Shutdown date | Model / system | Recommended replacement |
|---|
2025-11-17: codex-mini-latest
OpenAI also ended support for the legacy local shell tool that was available only with this model.
| Shutdown date | Model / system | Recommended replacement |
|---|
2025-06-10: Early GPT-4o realtime and audio previews
| Shutdown date | Model / system | Recommended replacement |
|---|
2025-04-28: Text moderation
| Shutdown date | Model / system | Recommended replacement |
|---|
2025-04-28: o1-preview and o1-mini
| Shutdown date | Model / system | Recommended replacement |
|---|
2025-04-14: GPT-4.5 Preview
| Shutdown date | Model / system | Recommended replacement |
|---|
2024-10-02: Assistants API beta v1
See the Assistants API migration guide.
| Shutdown date | Model / system | Recommended replacement |
|---|
2024-08-29: Fine-tuning training on babbage-002 and davinci-002
Fine-tuned models already created from these base models were not affected by this training deprecation.
| Shutdown date | Model / system | Recommended replacement |
|---|
2024-06-06: GPT-4 32K and Vision Preview models
| Shutdown date | Deprecated model | Deprecated model price | Recommended replacement |
|---|
2023-11-06: Chat model updates
Fine-tuned models created from these bases were not affected, but new fine-tuned versions could no longer be created.
| Shutdown date | Deprecated model | Deprecated model price | Recommended replacement |
|---|
2023-08-22: Fine-tunes endpoint
Models fine-tuned through /v1/fine-tunes also became inaccessible after shutdown.
| Shutdown date | System | Recommended replacement |
|---|---|---|
| 2024-01-04 | /v1/fine-tunes | /v1/fine_tuning/jobs |
2023-07-06: GPT and embeddings
InstructGPT models
| Shutdown date | Deprecated model | Deprecated model price | Recommended replacement |
|---|
Base GPT models
| Shutdown date | Deprecated model | Deprecated model price | Recommended replacement |
|---|
Edit models and endpoint
| Shutdown date | Model / system | Recommended replacement |
|---|
Fine-tuning GPT models
| Shutdown date | Deprecated model | Training price | Usage price | Recommended replacement |
|---|
First-generation text embedding models
| Shutdown date | Deprecated model | Deprecated model price | Recommended replacement |
|---|
2023-06-13: Updated chat models
| Shutdown date | Legacy model | Legacy model price | Recommended replacement |
|---|
| Shutdown date | Deprecated model | Deprecated model price | Recommended replacement |
|---|
2023-03-20: Codex models
| Shutdown date | Deprecated model | Recommended replacement |
|---|
2022-06-03: Legacy endpoints
| Shutdown date | System | Recommended replacement |
|---|---|---|
| 2022-12-03 | /v1/engines | /v1/models |
| 2022-12-03 | /v1/search | Search transition guide |
| 2022-12-03 | /v1/classifications | Classifications transition guide |
| 2022-12-03 | /v1/answers | Answers transition guide |
Currently Deprecated Models
AvalAI Catalog Update (Deprecated: September 4, 2026)
The following additional legacy model families and endpoints are no longer available through AvalAI. This catalog update supplements the provider-specific notices below; repeated aliases in provider notices refer to the same retirement.
Amazon Bedrock, Anthropic, Cohere, Meta, DeepSeek, and OpenAI OSS
Stability AI image and editing models
Migration path: Use a currently available image-generation or image-editing model from the live /v1/models catalog. Do not use the older Stability models previously recommended on this page.
NVIDIA NIM models
nvidia_nim.llama-3.2-nv-rerankqa-1b-v2,llama-3.2-nemoretriever-300m-embed-v1nvidia_nim.llama-3.2-nemoretriever-300m-embed-v2,nvidia_nim.llama-3.2-nemoretriever-1b-vlm-embed-v1nvidia_nim.llama-3.2-nv-embedqa-1b-v2,nvidia_nim.llama-3.2-nemoretriever-500m-rerank-v2nvidia_nim.nv-rerankqa-mistral-4b-v3,nvidia_nim.qwen3-next-80b-a3b-thinkingnvidia_nim.nvidia-nemotron-nano-9b-v2,nvidia_nim.llama-4-scout-17b-16e-instructnvidia_nim.llama-3.1-nemotron-ultra-253b-v1,nvidia_nim.eurollm-9b-instruct,nvidia_nim.gemma-3-1b-it,nvidia_nim.bge-m3
Additional Google, image, search, and speech models
models/gemini-2.0-flash-lite,gemini-2.5-flash-preview-04-17,gemini-2.5-flash-preview-09-2025imagen-4.0-fast-generate-preview-06-06,imagen-4.0-generate-001,imagen-4.0-ultra-generate-001,imagen-4.0-fast-generate-001sora,qwq-32b,google_pse-searchseedream-4-0-250828,seedream-4-5-251128
Migration path: Use gemini-3.1-flash-image for the retired Imagen 4 endpoints. For all other IDs, select a currently supported equivalent from the relevant provider page and confirm it in /v1/models.
Additional OpenAI aliases removed from the AvalAI catalog
gpt-4o-mini-search-preview,gpt-4o-search-preview,gpt-4o-mini-ttsgpt-5-chat-latest,gpt-5-codex,gpt-5.1-chat-latest,gpt-5.1-codex,gpt-5.1-codex-max,gpt-5.1-codex-minigpt-audio-mini,gpt-realtime-mini,o3-deep-research,o4-mini-deep-research,gpt-5.2-codex,gpt-5.2-chat-latest,gpt-5.3-chat-latest
The official shutdown history and replacements for these aliases appear in the OpenAI tables above. Availability through AvalAI has already ended for the IDs in this catalog-update section.
Additional Alibaba, Moonshot, Mistral, Cloudflare, and other models
qwen3-235b-a22b-thinking-250,qwen-turbo,qwen-turbo-2024-11-01qwen-vl-max,qwen-vl-max-2025-08-13,qwen-vl-plus,qwen-vl-plus-2025-08-15,qwen-vl-plus-2025-07-10,qwen-vl-plus-2025-01-25mistral-ocr-2505,mistral-ocr-2503cf.gemma-3-12b-it
Migration path: For OCR, use mistral-ocr-4-0 or its mistral-ocr-latest alias. For Qwen and other models, choose an available replacement from the provider documentation and verify the exact ID in /v1/models.
Moonshot.ai Legacy Models (Deprecated)
Moonshot.ai has deprecated the following legacy Kimi and Moonshot model IDs:
Migration Path: Migrate from these IDs to a currently supported Moonshot.ai model. Choose an appropriate replacement from the Moonshot.ai models page and verify availability through the live /v1/models catalog.
DeepSeek Chat & Reasoner Models (Retired: July 24, 2026)
DeepSeek retired the legacy aliases deepseek-chat and deepseek-reasoner on July 24, 2026, at 15:59 (UTC). For compatibility, these model names route to the DeepSeek V4 flagship family: deepseek-chat → deepseek-v4-flash (non-thinking mode) and deepseek-reasoner → deepseek-v4-pro (thinking mode).
Models Affected:
Migration Path: Migrate to the explicit DeepSeek V4 model IDs:
- deepseek-v4-flash - Recommended replacement for
deepseek-chat(fast, economical flagship with 1M context, supports both thinking and non-thinking modes) - deepseek-v4-pro - Recommended replacement for
deepseek-reasoner(most capable flagship with open-source SOTA Agentic Coding, 1M context, thinking mode by default)
ElevenLabs Legacy Models (Removed: July 9, 2026)
ElevenLabs deprecated and removed the following legacy models from the API on July 9, 2026:
| Shutdown date | Deprecated model | Recommended replacement |
|---|
Models Affected:
Migration Path: Migrate to the latest supported ElevenLabs models:
- scribe_v2 - State-of-the-art speech recognition with diarization, word-level timestamps, and entity detection (recommended replacement for
scribe_v1) - eleven_turbo_v2 / eleven_flash_v2 - High-quality, low-latency English TTS (recommended replacements for
eleven_monolingual_v1) - eleven_multilingual_v2 / eleven_turbo_v2_5 / eleven_flash_v2_5 - Modern multilingual TTS models (recommended replacements for
eleven_multilingual_v1)
For details on the replacement models, see the ElevenLabs Models page.
Anthropic Claude 4 Models (Deprecated: June 15, 2026)
Anthropic deprecated the following Claude 4 models on June 15, 2026:
Migration Path: Migrate to the latest Claude models:
- claude-sonnet-4-6 - Latest Claude Sonnet model
- claude-opus-4-8 - Latest Claude Opus model
Gemini 2.0 Flash & Flash Lite (Discontinued: June 1, 2026)
Google discontinued the following GA models on the Gemini API and Google AI Studio (AIS) on June 1, 2026:
| Model | Endpoint ID | Required Action |
|---|
Migration Path: Migrate to the following models:
- gemini-2.5-flash - Recommended replacement for Gemini 2.0 Flash
- gemini-2.5-flash-lite - Recommended replacement for Gemini 2.0 Flash Lite
Alibaba Qwen Legacy Snapshot Models (Decommissioned: May 13–31, 2026)
The Bailian Large Model Service Platform (Alibaba DashScope) decommissioned several historical snapshot model families between May 13 and May 31, 2026 (UTC+8). Calls to these retired IDs can fail or return no response.
Models Affected (all variants: base alias, -latest, and dated snapshots):
Migration Path: Migrate to a supported Qwen model:
- qwen3.7-max - Latest flagship agent foundation for advanced coding and reasoning (recommended replacement for
qwen-maxseries) - qwen3.7-plus - Balanced Qwen3.7 model for high-volume coding, multimodal reasoning, and agentic workloads
- qwen3.6-plus - Still-supported 1M-context model with agentic coding and multimodal capabilities
- qwen3.6-flash - Fast, cost-effective replacement for
qwen-turboseries - qwen3.6-max-preview - 1T+ parameter premium preview model for demanding tasks
- qwen3-vl-plus / qwen3-vl-flash - Modern vision-language replacements for
qwen-vl-max,qwen-vl-plus, andqvq-maxseries
For details on the replacement models, see the Alibaba Models page.
Gemini 2.5 Flash Lite Preview 09-2025 (Discontinued: March 31, 2026)
Google discontinued Gemini 2.5 Flash Lite Preview 09-2025 on the Gemini API and Google AI Studio (AIS) on March 31, 2026. This retirement does not apply to Vertex AI.
- Gemini 2.5 Flash Lite Preview 09-2025 was replaced by Gemini 3.1 Flash Lite Preview.
Migration Path: Use gemini-3.1-flash-lite-preview.
Gemini 3 Pro Preview (gemini-3-pro-preview) (Discontinued: March 9, 2026)
Google discontinued Gemini 3 Pro Preview (gemini-3-pro-preview) on the Gemini API and Google AI Studio (AIS) on March 9, 2026. The -latest alias switched to Gemini 3.1 Pro Preview on March 6, 2026.
Migration Path: Use gemini-3.1-pro-preview.
Gemini 2.5 Flash Image Preview (Discontinued: January 15, 2026)
Google discontinued Gemini 2.5 Flash Image Preview (gemini-2.5-flash-image-preview) on the Gemini API on January 15, 2026.
Migration Path: Use the generally available gemini-2.5-flash-image model.
Groq PlayAI TTS Models (Deprecated: December 31, 2025)
Groq has deprecated the PlayAI TTS models. These models are no longer available:
Important: Requests using these models will fail. Migrate to alternative TTS models available through AvalAI.
Google Gemma 3 Models (Deprecated: 2026-07-11)
The following Google Gemma 3 open models have been deprecated and are no longer available through AvalAI:
Migration Path: Use currently supported Gemini models available through AvalAI, such as gemini-2.5-flash or gemini-2.5-flash-lite, for chat and instruction-following workloads.
Z.AI GLM Legacy Models (Deprecated: 2026-06-27)
Z.AI has deprecated the following legacy GLM models in favor of the latest flagship glm-5.2 model:
Migration Path: Please migrate to the latest supported Z.AI GLM model:
- glm-5.2 - Latest flagship GLM model for complex software engineering, long-context reasoning, and stable agentic workflows, with a 1M-token context window and industry-leading coding performance
For details on the replacement model, see the Z.AI Models page.
MiniMax Legacy Models (Deprecated: 2026-06-27)
MiniMax has deprecated the following legacy models in favor of the latest flagship minimax-m3 model:
Migration Path: Please migrate to the latest supported MiniMax model:
- minimax-m3 - Latest flagship MiniMax model combining frontier coding capability, an ultra-long 1M-token context window, and native multimodality, built on the MiniMax Sparse Attention (MSA) architecture with toggleable thinking and autonomous long-horizon task support
For details on the replacement model, see the MiniMax Models page.
Google Programmable Search Engine (google_pse-search) (Deprecated: April 2026)
Google has deprecated the Programmable Search Engine (PSE) v1/search model, previously available as google_pse-search. This service has been discontinued by Google in favor of their AI-powered search capabilities built into Gemini models.
Deprecated Model:
Migration Path: You can either use the built-in search tool in the Gemini models, or switch to another v1/search provider:
- Gemini models with
google_searchtool - Built-in AI-powered search in Gemini 3 Flash, Gemini 3.1 Pro, and Gemini 2.5 Pro models. See the Web Search Capabilities Guide for implementation details. - Other
v1/searchproviders - Switch to an alternative search provider such asserper-search(lowest-cost Google-powered search). See the Search API reference for the full list of supportedv1/searchproviders.
Mistral Codestral Models (Deprecated: 2026-06-03)
The following Mistral Codestral model has been deprecated:
Migration Path: Use the latest supported Mistral coding models:
- codestral-latest - Latest Codestral model for code generation and completion
Cloudflare Workers AI Models (Deprecated: 2026-06-03)
The following Cloudflare Workers AI models have been deprecated and are no longer available:
Migration Path: Use currently supported models for chat, embeddings, and code generation available through AvalAI.
Google Gemini Preview & Experimental Models (Deprecated: 2025-11-18)
Google has deprecated the following preview and experimental Gemini models. Users should migrate to currently supported Gemini models, including gemini-3.1-pro-preview for advanced reasoning tasks.
Deprecated Models:
Migration Path: Use currently supported models:
- gemini-3.1-pro-preview - Latest Gemini Pro Preview model for advanced reasoning tasks
- gemini-2.5-pro - Stable Gemini Pro model
- gemini-2.5-flash - Stable Gemini Flash model
- gemini-2.5-flash-preview-09-2025 - Gemini Flash preview (September 2025)
- gemini-2.5-flash-lite - Gemini Flash Lite model
For more information, see our announcement.
Google Gemini Image & Embedding Models (Deprecated: 2025-10-28)
The following Google Gemini image and embedding models have been deprecated:
Image Generation Models
Migration Path: Use currently supported models:
- gemini-2.5-flash-image - Stable version of Gemini 2.5 Flash image generation
Embedding Models
- embedding-001 - Legacy embedding model
- embedding-gecko-001 - Legacy Gecko embedding model
- gemini-embedding-exp-03-07 - March 7 experimental embedding model
- gemini-embedding-exp - Experimental embedding model
Migration Path: Use currently supported embedding models:
- text-embedding-004 - Latest text embedding model
- text-multilingual-embedding-002 - Multilingual embedding model
BytePlus Seedream Models (Deprecated: 2026-05-06)
The following BytePlus Seedream image generation models have been deprecated:
Migration Path: Use the latest supported Seedream model:
- seedream-5-0-260128 - Latest Seedream 5.0 image generation and editing model with Chain of Thought reasoning, improved prompt optimization, MJ-style aesthetics, and enhanced high-resolution generation
For implementation examples, see Generate Images with Seedream.
OpenAI Models (Deprecated: 2025-10-28)
The following OpenAI models have been deprecated:
Image Generation Models
Migration Path: Use the latest OpenAI image model:
- gpt-image-2 - Latest OpenAI image generation and editing model with improved prompt adherence, visual fidelity, multilingual text rendering, and support for both
v1/images/generationsandv1/images/edits
For implementation examples, see Generate Images with GPT Image.
GPT-3.5 Models
- gpt-3.5-turbo - Legacy GPT-3.5 Turbo model
Migration Path: Use currently supported models:
- gpt-5-nano - More efficient and capable replacement
- gpt-5-mini - Enhanced performance model
GPT-4 Legacy Models
- gpt-4 - Original GPT-4 model
- gpt-4-0125-preview - January 25, 2024 preview version
- gpt-4-1106-preview - November 6, 2023 preview version
- gpt-4-turbo - Legacy GPT-4 Turbo model
- gpt-4-turbo-2024-04-09 - April 9, 2024 specific version
Migration Path: Use currently supported models:
- gpt-4.1 - Latest GPT-4 series model
- gpt-5-chat - Next generation model
- gpt-5-pro - Professional tier model
Reasoning Models
- o1-preview - Preview version of O1 reasoning model
- gpt-4.5-preview - Preview version of GPT-4.5
Migration Path: Use currently supported models:
- o3 - Stable version of O1 reasoning model
- o4-mini - Efficient reasoning model
- gpt-5-chat - Latest Chat model
Anthropic Claude Models (Deprecated: 2025-10-28)
The following Anthropic Claude models have been deprecated:
Migration Path: Use currently supported models:
- claude-opus-4-8 - Latest Claude Opus model
- claude-sonnet-4-6 - Latest Claude Sonnet model
- claude-haiku-4-5 - Efficient alternative
Stability AI Models (Deprecated: 2025-10-28)
The following Stability AI models have been deprecated:
Migration Path: Select a currently supported image-generation model from the live /v1/models catalog. The former replacements stability.sd3-5-large-v1:0 and stability.stable-image-ultra-v1:1 are also deprecated.
Google Gemini Models (Deprecated: 2025-09-27)
The following Google Gemini models have been officially deprecated by Google's Gemini API:
Core Gemini Models
Experimental Variants
Flash Models
Migration Path: Use currently supported models:
- gemini-2.5-pro - Stable Gemini Pro model
- gemini-2.5-flash - Stable Gemini Flash model
- gemini-2.5-flash-lite - Stable Gemini Flash Lite model
The former Gemini 2.0 replacements are also deprecated; verify the selected ID in the live /v1/models catalog.
Announcement: Google Gemini 1.5 Series Models Deprecation Notice
Migration Support
If you need assistance migrating from deprecated models:
- Review Current Usage: Identify which deprecated models you're currently using
- Select Alternatives: Choose appropriate replacement models based on your use case
- Update Implementation: Modify your code to use the new model names
- Test Thoroughly: Ensure your applications work correctly with the replacement models
- Monitor Performance: Verify that the new models meet your requirements
Support Resources
Historical Deprecations
This section will be updated as models are deprecated over time.
Last Updated: 2026-09-04
For the most current information about model availability, please refer to our Models Documentation or contact our support team.