{
  "meta": {
    "api_version": "v1",
    "endpoint": "/api/v1/deprecations",
    "updated": "2026-08-31",
    "verified_date": "2026-08-31",
    "total": 48,
    "offset": 0,
    "limit": 50,
    "returned": 48,
    "provenance": "Each entry carries its provider source and record verification date. A benchr pick is editorial and separate from replacement_official."
  },
  "data": [
    {
      "id": "claude-3-5-sonnet",
      "kind": "model",
      "model_name": "Claude Sonnet 3.5 (both snapshots)",
      "provider": "Anthropic",
      "api_ids": [
        "claude-3-5-sonnet-20240620",
        "claude-3-5-sonnet-20241022"
      ],
      "status": "retired",
      "announced": "2025-08-13",
      "shutdown": "2025-10-28",
      "replacement_official": {
        "name": "Claude Sonnet 4.6",
        "api_id": "claude-sonnet-4-6"
      },
      "replacement_benchr_pick": null,
      "pricing_retiring": null,
      "pricing_replacement": null,
      "benchmark_delta": null,
      "page": null,
      "source": "https://platform.claude.com/docs/en/about-claude/model-deprecations",
      "verified": "2026-06-12"
    },
    {
      "id": "claude-3-opus",
      "kind": "model",
      "model_name": "Claude 3 Opus",
      "provider": "Anthropic",
      "api_ids": [
        "claude-3-opus-20240229"
      ],
      "status": "retired",
      "announced": "2025-06-30",
      "shutdown": "2026-01-05",
      "replacement_official": {
        "name": "Claude Opus 4.8",
        "api_id": "claude-opus-4-8"
      },
      "replacement_benchr_pick": null,
      "pricing_retiring": null,
      "pricing_replacement": {
        "input_per_million": 5,
        "output_per_million": 25
      },
      "benchmark_delta": null,
      "page": null,
      "source": "https://platform.claude.com/docs/en/about-claude/model-deprecations",
      "verified": "2026-06-12"
    },
    {
      "id": "claude-3-7-sonnet",
      "kind": "model",
      "model_name": "Claude Sonnet 3.7",
      "provider": "Anthropic",
      "api_ids": [
        "claude-3-7-sonnet-20250219"
      ],
      "status": "retired",
      "announced": "2025-10-28",
      "shutdown": "2026-02-19",
      "replacement_official": {
        "name": "Claude Sonnet 4.6",
        "api_id": "claude-sonnet-4-6"
      },
      "replacement_benchr_pick": null,
      "pricing_retiring": null,
      "pricing_replacement": {
        "input_per_million": 3,
        "output_per_million": 15
      },
      "benchmark_delta": null,
      "page": null,
      "source": "https://platform.claude.com/docs/en/about-claude/model-deprecations",
      "verified": "2026-06-12"
    },
    {
      "id": "claude-3-5-haiku",
      "kind": "model",
      "model_name": "Claude Haiku 3.5",
      "provider": "Anthropic",
      "api_ids": [
        "claude-3-5-haiku-20241022"
      ],
      "status": "retired",
      "announced": "2025-12-19",
      "shutdown": "2026-02-19",
      "replacement_official": {
        "name": "Claude Haiku 4.5",
        "api_id": "claude-haiku-4-5-20251001"
      },
      "replacement_benchr_pick": null,
      "pricing_retiring": null,
      "pricing_replacement": {
        "input_per_million": 1,
        "output_per_million": 5
      },
      "benchmark_delta": null,
      "page": null,
      "source": "https://platform.claude.com/docs/en/about-claude/model-deprecations",
      "verified": "2026-06-12"
    },
    {
      "id": "gemini-3-pro-preview",
      "kind": "model",
      "model_name": "Gemini 3 Pro Preview",
      "provider": "Google",
      "api_ids": [
        "gemini-3-pro-preview"
      ],
      "status": "retired",
      "announced": null,
      "shutdown": "2026-03-09",
      "shutdown_note": "Gemini API shutdown March 9, 2026; Google Cloud's Vertex AI docs list it discontinued as of March 26, 2026.",
      "replacement_official": {
        "name": "Gemini 3.1 Pro Preview",
        "api_id": "gemini-3.1-pro-preview"
      },
      "replacement_benchr_pick": {
        "name": "Gemini 3.1 Pro",
        "why": "Same pricing tier, stronger reasoning. Drop-in swap."
      },
      "pricing_retiring": {
        "input_per_million": 2,
        "output_per_million": 12
      },
      "pricing_replacement": {
        "input_per_million": 2,
        "output_per_million": 12
      },
      "benchmark_delta": null,
      "page": null,
      "source": "https://ai.google.dev/gemini-api/docs/deprecations",
      "verified": "2026-06-12"
    },
    {
      "id": "claude-3-haiku",
      "kind": "model",
      "model_name": "Claude Haiku 3",
      "provider": "Anthropic",
      "api_ids": [
        "claude-3-haiku-20240307"
      ],
      "status": "retired",
      "announced": "2026-02-19",
      "shutdown": "2026-04-20",
      "replacement_official": {
        "name": "Claude Haiku 4.5",
        "api_id": "claude-haiku-4-5-20251001"
      },
      "replacement_benchr_pick": null,
      "pricing_retiring": null,
      "pricing_replacement": {
        "input_per_million": 1,
        "output_per_million": 5
      },
      "benchmark_delta": null,
      "page": null,
      "source": "https://platform.claude.com/docs/en/about-claude/model-deprecations",
      "verified": "2026-06-12"
    },
    {
      "id": "dall-e",
      "kind": "model",
      "model_name": "DALL-E 2 and DALL-E 3",
      "provider": "OpenAI",
      "api_ids": [
        "dall-e-2",
        "dall-e-3"
      ],
      "status": "retired",
      "announced": null,
      "shutdown": "2026-05-12",
      "replacement_official": {
        "name": "GPT Image 2",
        "api_id": "gpt-image-2"
      },
      "replacement_benchr_pick": null,
      "pricing_retiring": null,
      "pricing_replacement": null,
      "benchmark_delta": null,
      "page": null,
      "source": "https://developers.openai.com/api/docs/deprecations",
      "verified": "2026-06-12"
    },
    {
      "id": "gemini-2-0-flash",
      "kind": "model",
      "model_name": "Gemini 2.0 Flash family",
      "provider": "Google",
      "api_ids": [
        "gemini-2.0-flash",
        "gemini-2.0-flash-lite"
      ],
      "status": "retired",
      "announced": null,
      "shutdown": "2026-06-01",
      "replacement_official": {
        "name": "Gemini 3.5 Flash",
        "api_id": "gemini-3.5-flash"
      },
      "replacement_benchr_pick": null,
      "pricing_retiring": null,
      "pricing_replacement": null,
      "benchmark_delta": null,
      "page": null,
      "source": "https://ai.google.dev/gemini-api/docs/deprecations",
      "verified": "2026-06-12",
      "shutdown_note": "Plain 2.0 Flash points to gemini-3.5-flash; 2.0 Flash Lite's official replacement is gemini-3.1-flash-lite."
    },
    {
      "id": "claude-sonnet-4",
      "kind": "model",
      "model_name": "Claude Sonnet 4",
      "provider": "Anthropic",
      "api_ids": [
        "claude-sonnet-4-20250514"
      ],
      "status": "retired",
      "announced": "2026-04-14",
      "shutdown": "2026-06-15",
      "replacement_official": {
        "name": "Claude Sonnet 4.6",
        "api_id": "claude-sonnet-4-6"
      },
      "replacement_benchr_pick": {
        "name": "Claude Sonnet 4.6",
        "why": "Same $3/$15 pricing, 1M context vs 200K, SWE-bench Verified 79.6% vs 72.7%."
      },
      "pricing_retiring": {
        "input_per_million": 3,
        "output_per_million": 15
      },
      "pricing_replacement": {
        "input_per_million": 3,
        "output_per_million": 15
      },
      "benchmark_delta": {
        "metric": "SWE-bench Verified",
        "retiring": 72.7,
        "replacement": 79.6
      },
      "page": "/deprecations/claude-sonnet-4",
      "source": "https://platform.claude.com/docs/en/about-claude/model-deprecations",
      "verified": "2026-06-12"
    },
    {
      "id": "claude-opus-4",
      "kind": "model",
      "model_name": "Claude Opus 4",
      "provider": "Anthropic",
      "api_ids": [
        "claude-opus-4-20250514"
      ],
      "status": "retired",
      "announced": "2026-04-14",
      "shutdown": "2026-06-15",
      "replacement_official": {
        "name": "Claude Opus 4.8",
        "api_id": "claude-opus-4-8"
      },
      "replacement_benchr_pick": {
        "name": "Claude Opus 4.8",
        "why": "$5/$25 vs $15/$75 — two-thirds cheaper — and SWE-bench Verified 88.6% vs 72.5%."
      },
      "pricing_retiring": {
        "input_per_million": 15,
        "output_per_million": 75
      },
      "pricing_replacement": {
        "input_per_million": 5,
        "output_per_million": 25
      },
      "benchmark_delta": {
        "metric": "SWE-bench Verified",
        "retiring": 72.5,
        "replacement": 88.6
      },
      "page": "/deprecations/claude-opus-4",
      "source": "https://platform.claude.com/docs/en/about-claude/model-deprecations",
      "verified": "2026-06-12"
    },
    {
      "id": "gemini-3-pro-image-preview",
      "kind": "model",
      "model_name": "Gemini 3 Pro Image Preview",
      "provider": "Google",
      "api_ids": [
        "gemini-3-pro-image-preview"
      ],
      "status": "retired",
      "announced": null,
      "shutdown": "2026-06-25",
      "shutdown_note": "Shutdown date June 25, 2026 has passed; re-confirmed retired on the official Gemini deprecations table June 28, 2026. Migrate to the GA gemini-3-pro-image.",
      "replacement_official": {
        "name": "Gemini 3 Pro Image (stable)",
        "api_id": "gemini-3-pro-image"
      },
      "replacement_benchr_pick": null,
      "pricing_retiring": null,
      "pricing_replacement": null,
      "benchmark_delta": null,
      "page": null,
      "source": "https://ai.google.dev/gemini-api/docs/deprecations",
      "verified": "2026-06-28"
    },
    {
      "id": "gemini-3-1-flash-image-preview",
      "kind": "model",
      "model_name": "Gemini 3.1 Flash Image Preview",
      "provider": "Google",
      "api_ids": [
        "gemini-3.1-flash-image-preview"
      ],
      "status": "retired",
      "announced": null,
      "shutdown": "2026-06-25",
      "shutdown_note": "Shutdown date June 25, 2026 has passed; confirmed retired on the official Gemini deprecations table June 28, 2026. Migrate to the GA gemini-3.1-flash-image.",
      "replacement_official": {
        "name": "Gemini 3.1 Flash Image (stable)",
        "api_id": "gemini-3.1-flash-image"
      },
      "replacement_benchr_pick": null,
      "pricing_retiring": null,
      "pricing_replacement": null,
      "benchmark_delta": null,
      "page": null,
      "source": "https://ai.google.dev/gemini-api/docs/deprecations",
      "verified": "2026-06-28"
    },
    {
      "id": "o3-deep-research",
      "kind": "model",
      "model_name": "o3-deep-research",
      "provider": "OpenAI",
      "api_ids": [
        "o3-deep-research-2025-06-26"
      ],
      "status": "retired",
      "announced": "2026-04-22",
      "shutdown": "2026-07-23",
      "replacement_official": {
        "name": "GPT-5.5 Pro",
        "api_id": "gpt-5.5-pro"
      },
      "replacement_benchr_pick": null,
      "pricing_retiring": null,
      "pricing_replacement": null,
      "benchmark_delta": null,
      "page": "/deprecations/openai-october-2026-retirements",
      "source": "https://developers.openai.com/api/docs/deprecations",
      "verified": "2026-07-27"
    },
    {
      "id": "gpt-5-chat-snapshots",
      "kind": "model",
      "model_name": "GPT-5 / 5.1 chat-latest snapshots",
      "provider": "OpenAI",
      "api_ids": [
        "gpt-5-chat-latest",
        "gpt-5.1-chat-latest"
      ],
      "status": "retired",
      "announced": "2026-04-22",
      "shutdown": "2026-07-23",
      "shutdown_note": "OpenAI listed these snapshots for removal on July 23, 2026. The later gpt-5.2-chat-latest and gpt-5.3-chat-latest shutdown is tracked separately for August 10.",
      "replacement_official": {
        "name": "GPT-5.5",
        "api_id": "gpt-5.5"
      },
      "replacement_benchr_pick": null,
      "pricing_retiring": null,
      "pricing_replacement": null,
      "benchmark_delta": null,
      "page": "/deprecations/openai-october-2026-retirements",
      "source": "https://developers.openai.com/api/docs/deprecations",
      "verified": "2026-07-27"
    },
    {
      "id": "openai-codex-models",
      "kind": "model",
      "model_name": "GPT-5 era Codex models",
      "provider": "OpenAI",
      "api_ids": [
        "gpt-5-codex",
        "gpt-5.1-codex",
        "gpt-5.1-codex-mini",
        "gpt-5.1-codex-max",
        "gpt-5.2-codex"
      ],
      "status": "retired",
      "announced": "2026-04-22",
      "shutdown": "2026-07-23",
      "shutdown_note": "gpt-5.1-codex-mini's official replacement is gpt-5.4-mini; the rest point to gpt-5.5.",
      "replacement_official": {
        "name": "GPT-5.5",
        "api_id": "gpt-5.5"
      },
      "replacement_benchr_pick": null,
      "pricing_retiring": null,
      "pricing_replacement": null,
      "benchmark_delta": null,
      "page": "/deprecations/openai-october-2026-retirements",
      "source": "https://developers.openai.com/api/docs/deprecations",
      "verified": "2026-07-27"
    },
    {
      "id": "o4-mini-deep-research",
      "kind": "model",
      "model_name": "o4-mini-deep-research",
      "provider": "OpenAI",
      "api_ids": [
        "o4-mini-deep-research-2025-06-26"
      ],
      "status": "retired",
      "announced": "2026-04-22",
      "shutdown": "2026-07-23",
      "replacement_official": {
        "name": "GPT-5.5 Pro",
        "api_id": "gpt-5.5-pro"
      },
      "replacement_benchr_pick": null,
      "pricing_retiring": null,
      "pricing_replacement": null,
      "benchmark_delta": null,
      "page": "/deprecations/openai-october-2026-retirements",
      "source": "https://developers.openai.com/api/docs/deprecations",
      "verified": "2026-07-27"
    },
    {
      "id": "computer-use-preview",
      "kind": "model",
      "model_name": "computer-use-preview",
      "provider": "OpenAI",
      "api_ids": [
        "computer-use-preview-2025-03-11"
      ],
      "status": "retired",
      "announced": "2026-04-22",
      "shutdown": "2026-07-23",
      "replacement_official": {
        "name": "GPT-5.4 mini",
        "api_id": "gpt-5.4-mini"
      },
      "replacement_benchr_pick": null,
      "pricing_retiring": null,
      "pricing_replacement": null,
      "benchmark_delta": null,
      "page": "/deprecations/openai-october-2026-retirements",
      "source": "https://developers.openai.com/api/docs/deprecations",
      "verified": "2026-07-27"
    },
    {
      "id": "deepseek-legacy-aliases-jul-2026",
      "kind": "model",
      "model_name": "deepseek-chat / deepseek-reasoner (legacy aliases)",
      "provider": "DeepSeek",
      "api_ids": [
        "deepseek-chat",
        "deepseek-reasoner"
      ],
      "status": "retired",
      "announced": null,
      "shutdown": "2026-07-24",
      "shutdown_note": "Official DeepSeek pricing/docs page confirms these legacy alias model names retire 2026-07-24 15:59 UTC in favor of explicit versioned names deepseek-v4-flash / deepseek-v4-pro. This is an alias rename, not a capability or pricing change — existing traffic on deepseek-chat/deepseek-reasoner must switch names before the date.",
      "replacement_official": {
        "name": "DeepSeek V4-Flash / DeepSeek V4-Pro",
        "api_id": "deepseek-v4-flash / deepseek-v4-pro"
      },
      "replacement_benchr_pick": null,
      "pricing_retiring": null,
      "pricing_replacement": null,
      "benchmark_delta": null,
      "page": "/articles/deepseek-api-aliases-retired",
      "source": "https://api-docs.deepseek.com/quick_start/pricing",
      "verified": "2026-08-14"
    },
    {
      "id": "claude-opus-4-7-fast-mode",
      "kind": "api_feature",
      "model_name": "Claude Opus 4.7 fast mode",
      "provider": "Anthropic",
      "api_ids": [
        "claude-opus-4-7 with speed: fast"
      ],
      "status": "retired",
      "announced": "2026-06-29",
      "shutdown": "2026-07-24",
      "shutdown_note": "Anthropic pricing docs state that fast mode for Claude Opus 4.7 is deprecated and will be removed on July 24, 2026. Fast mode remains available on Claude Opus 4.8; Opus 4.6 fast-mode requests already run at standard speed and standard rates as of June 29, 2026.",
      "replacement_official": {
        "name": "Claude Opus 4.8 fast mode or Claude Opus 4.7 standard mode",
        "api_id": "claude-opus-4-8 with speed: fast"
      },
      "replacement_benchr_pick": {
        "name": "Claude Opus 4.8 fast mode",
        "why": "Same Opus base price as 4.7, newer model, and fast mode remains supported."
      },
      "pricing_retiring": {
        "input_per_million": 30,
        "output_per_million": 150
      },
      "pricing_replacement": {
        "input_per_million": 10,
        "output_per_million": 50
      },
      "benchmark_delta": null,
      "page": null,
      "source": "https://platform.claude.com/docs/en/about-claude/pricing",
      "verified": "2026-07-27"
    },
    {
      "id": "claude-opus-4-1",
      "kind": "model",
      "model_name": "Claude Opus 4.1",
      "provider": "Anthropic",
      "api_ids": [
        "claude-opus-4-1-20250805"
      ],
      "status": "retired",
      "announced": "2026-06-05",
      "shutdown": "2026-08-05",
      "replacement_official": {
        "name": "Claude Opus 4.8",
        "api_id": "claude-opus-4-8"
      },
      "replacement_benchr_pick": {
        "name": "Claude Opus 4.8",
        "why": "Same migration as Opus 4: two-thirds cheaper, 88.6% vs 74.5% SWE-bench Verified."
      },
      "pricing_retiring": {
        "input_per_million": 15,
        "output_per_million": 75
      },
      "pricing_replacement": {
        "input_per_million": 5,
        "output_per_million": 25
      },
      "benchmark_delta": {
        "metric": "SWE-bench Verified",
        "retiring": 74.5,
        "replacement": 88.6
      },
      "page": "/deprecations/claude-opus-4",
      "source": "https://platform.claude.com/docs/en/about-claude/model-deprecations",
      "verified": "2026-08-08",
      "note": "Status flipped from deprecated to retired 2026-08-08: the August 5, 2026 shutdown date has passed, confirmed live on Anthropic's official model-deprecations table (claude-opus-4-1-20250805 listed as Retired)."
    },
    {
      "id": "gpt-5-2-5-3-chat-snapshots",
      "kind": "model",
      "model_name": "GPT-5.2 / 5.3 chat-latest snapshots",
      "provider": "OpenAI",
      "api_ids": [
        "gpt-5.2-chat-latest",
        "gpt-5.3-chat-latest"
      ],
      "status": "retired",
      "announced": "2026-05-08",
      "shutdown": "2026-08-10",
      "shutdown_note": "Shutdown date August 10, 2026 has passed. Re-read on 2026-08-24: OpenAI's deprecations page now carries the record under Past deprecations, headed \"2026-05-08: gpt-5.2-chat-latest and gpt-5.3-chat-latest model snapshots\". Migrate to gpt-5.6-sol.",
      "replacement_official": {
        "name": "GPT-5.6 Sol",
        "api_id": "gpt-5.6-sol"
      },
      "replacement_benchr_pick": null,
      "pricing_retiring": null,
      "pricing_replacement": null,
      "benchmark_delta": null,
      "page": "/deprecations/openai-october-2026-retirements",
      "source": "https://developers.openai.com/api/docs/deprecations",
      "verified": "2026-08-24"
    },
    {
      "id": "gemini-embedding-2-preview",
      "kind": "model",
      "model_name": "Gemini Embedding 2 Preview",
      "provider": "Google",
      "api_ids": [
        "embedding-2-preview"
      ],
      "status": "retired",
      "announced": null,
      "shutdown": "2026-08-10",
      "shutdown_note": "Shutdown date August 10, 2026 has passed. Re-read on 2026-08-24: Google's deprecations table still lists the August 10, 2026 shutdown for embedding-2-preview and marks already-shutdown models with a gray background. Replace embedding-2-preview with gemini-embedding-2.",
      "replacement_official": {
        "name": "Gemini Embedding 2",
        "api_id": "gemini-embedding-2"
      },
      "replacement_benchr_pick": null,
      "pricing_retiring": null,
      "pricing_replacement": null,
      "benchmark_delta": null,
      "page": null,
      "source": "https://ai.google.dev/gemini-api/docs/deprecations",
      "verified": "2026-08-24"
    },
    {
      "id": "google-imagen-4-aug-2026",
      "kind": "model",
      "model_name": "Imagen 4.0 image models",
      "provider": "Google",
      "api_ids": [
        "imagen-4.0-generate-001",
        "imagen-4.0-ultra-generate-001",
        "imagen-4.0-fast-generate-001"
      ],
      "status": "deprecated",
      "announced": "2026-06-15",
      "shutdown": "2026-08-17",
      "shutdown_note": "Google's Gemini deprecations table lists an August 17, 2026 shutdown for the three Imagen 4.0 generation IDs, with gemini-3.1-flash-image as the replacement. The date has passed as of the 2026-08-24 read; the table marks already-shutdown models with a gray background. Earlier Imagen 3.0 and Imagen 4.0 preview IDs were shut down before this wave. Checked 2026-08-31: the listed August 17 earliest date has passed, but Google's table does not yet mark the rows shut down, so the record stays deprecated.",
      "replacement_official": {
        "name": "Gemini 3.1 Flash Image",
        "api_id": "gemini-3.1-flash-image"
      },
      "replacement_benchr_pick": null,
      "pricing_retiring": null,
      "pricing_replacement": null,
      "benchmark_delta": null,
      "page": null,
      "source": "https://ai.google.dev/gemini-api/docs/deprecations",
      "verified": "2026-08-24",
      "verifiedDate": "2026-08-31"
    },
    {
      "id": "anthropic-prompt-tools-workbench",
      "kind": "platform",
      "model_name": "Anthropic experimental prompt tools API and Workbench",
      "provider": "Anthropic",
      "api_ids": [
        "experimental/generate_prompt",
        "experimental/improve_prompt",
        "experimental/templatize_prompt"
      ],
      "status": "retired",
      "announced": null,
      "shutdown": "2026-08-17",
      "shutdown_note": "Anthropic retired the experimental prompt tools APIs for generating, improving, and templatizing prompts, together with the Workbench, on August 17, 2026. The date has passed as of the 2026-08-24 read. This is a platform retirement, not a model retirement: no Claude model changed status alongside it, and Anthropic lists no successor product.",
      "replacement_official": null,
      "replacement_benchr_pick": {
        "name": "Prompts kept in application code",
        "why": "Anthropic names no successor to the prompt tools API or the Workbench, so prompt generation and templating move into your own codebase."
      },
      "pricing_retiring": null,
      "pricing_replacement": null,
      "benchmark_delta": null,
      "page": null,
      "source": "https://platform.claude.com/docs/en/release-notes/overview",
      "verified": "2026-08-24"
    },
    {
      "id": "assistants-api",
      "kind": "platform",
      "model_name": "OpenAI Assistants API",
      "provider": "OpenAI",
      "api_ids": [
        "assistants"
      ],
      "status": "retired",
      "announced": null,
      "shutdown": "2026-08-26",
      "replacement_official": {
        "name": "Responses API + Conversations API",
        "api_id": null
      },
      "replacement_benchr_pick": null,
      "pricing_retiring": null,
      "pricing_replacement": null,
      "benchmark_delta": null,
      "page": "/deprecations/openai-october-2026-retirements",
      "source": "https://developers.openai.com/api/docs/deprecations",
      "verified": "2026-06-12",
      "verifiedDate": "2026-08-28",
      "notes": "Retired. OpenAI's deprecations page now lists the Assistants API under Past deprecations and states it was sunset on August 26, 2026, following the August 20, 2025 deprecation announcement; the migration path is the Responses API plus the Conversations API. Confirmed on developers.openai.com/api/docs/deprecations on 2026-08-28."
    },
    {
      "id": "gemini-robotics-er-1-6-preview",
      "kind": "model",
      "model_name": "Gemini Robotics ER 1.6 Preview",
      "provider": "Google",
      "api_ids": [
        "gemini-robotics-er-1.6-preview"
      ],
      "status": "deprecated",
      "announced": "2026-07-30",
      "shutdown": "2026-08-31",
      "shutdown_note": "Announced with the July 30, 2026 public preview of Gemini Robotics ER 2. Google's deprecations table lists the August 31, 2026 shutdown and names gemini-robotics-er-2-preview as the replacement. Still scheduled as of the 2026-08-24 read.",
      "replacement_official": {
        "name": "Gemini Robotics ER 2 Preview",
        "api_id": "gemini-robotics-er-2-preview"
      },
      "replacement_benchr_pick": null,
      "pricing_retiring": null,
      "pricing_replacement": null,
      "benchmark_delta": null,
      "page": null,
      "source": "https://ai.google.dev/gemini-api/docs/deprecations",
      "verified": "2026-08-24"
    },
    {
      "id": "kimi-k2-5-moonshot-v1-aug-2026",
      "kind": "model",
      "model_name": "Kimi K2.5 and Moonshot V1 series",
      "provider": "Moonshot AI",
      "api_ids": [
        "kimi-k2.5",
        "moonshot-v1-8k",
        "moonshot-v1-32k",
        "moonshot-v1-128k",
        "moonshot-v1-8k-vision-preview",
        "moonshot-v1-32k-vision-preview",
        "moonshot-v1-128k-vision-preview"
      ],
      "status": "retired",
      "announced": null,
      "shutdown": "2026-08-31",
      "shutdown_note": "Moonshot's official model list says these endpoints stopped being available to newly registered users following the Kimi K3 launch and will reach full platform sunset on August 31, 2026. Existing-user availability before that date is not a promise beyond the stated sunset. Verified 2026-08-31 on Moonshot's model docs: the series is officially retired on August 31, 2026 and calls now return a 404 model-not-found error; the listed migration is kimi-k3.",
      "replacement_official": {
        "name": "Kimi K3",
        "api_id": "kimi-k3"
      },
      "replacement_benchr_pick": null,
      "pricing_retiring": null,
      "pricing_replacement": {
        "input_per_million": 3,
        "output_per_million": 15
      },
      "benchmark_delta": null,
      "page": "/articles/kimi-k3-review",
      "source": "https://platform.kimi.ai/docs/models",
      "verified": "2026-08-21",
      "verifiedDate": "2026-08-31"
    },
    {
      "id": "sora-2",
      "kind": "model",
      "model_name": "Sora 2 and Sora 2 Pro",
      "provider": "OpenAI",
      "api_ids": [
        "sora-2",
        "sora-2-pro"
      ],
      "status": "deprecated",
      "announced": "2026-04",
      "shutdown": "2026-09-24",
      "replacement_official": null,
      "replacement_benchr_pick": {
        "name": "Google Veo",
        "why": "OpenAI lists no replacement; the Videos API sunsets the same day. Veo is where the video market consolidated."
      },
      "pricing_retiring": null,
      "pricing_replacement": null,
      "benchmark_delta": null,
      "page": null,
      "source": "https://developers.openai.com/api/docs/deprecations",
      "verified": "2026-06-12"
    },
    {
      "id": "openai-videos-api",
      "kind": "platform",
      "model_name": "OpenAI Videos API",
      "provider": "OpenAI",
      "api_ids": [
        "videos"
      ],
      "status": "deprecated",
      "announced": "2026-04",
      "shutdown": "2026-09-24",
      "replacement_official": null,
      "replacement_benchr_pick": null,
      "pricing_retiring": null,
      "pricing_replacement": null,
      "benchmark_delta": null,
      "page": null,
      "source": "https://developers.openai.com/api/docs/deprecations",
      "verified": "2026-06-12"
    },
    {
      "id": "gemini-2-5-pro",
      "kind": "model",
      "model_name": "Gemini 2.5 Pro",
      "provider": "Google",
      "api_ids": [
        "gemini-2.5-pro"
      ],
      "status": "deprecated",
      "announced": null,
      "shutdown": "2026-10-16",
      "shutdown_note": "Google lists shutdown dates as the earliest possible date.",
      "replacement_official": {
        "name": "Gemini 3.1 Pro Preview",
        "api_id": "gemini-3.1-pro-preview"
      },
      "replacement_benchr_pick": {
        "name": "Gemini 3.1 Pro",
        "why": "Official path — but input jumps from $1.25 to $2.00 per 1M. Budget-sensitive workloads should also price DeepSeek V4-Pro or Claude Haiku 4.5."
      },
      "pricing_retiring": {
        "input_per_million": 1.25,
        "output_per_million": 10
      },
      "pricing_replacement": {
        "input_per_million": 2,
        "output_per_million": 12
      },
      "benchmark_delta": null,
      "page": "/deprecations/gemini-2-5-pro",
      "source": "https://ai.google.dev/gemini-api/docs/deprecations",
      "verified": "2026-06-12"
    },
    {
      "id": "gemini-2-5-flash",
      "kind": "model",
      "model_name": "Gemini 2.5 Flash",
      "provider": "Google",
      "api_ids": [
        "gemini-2.5-flash"
      ],
      "status": "deprecated",
      "announced": null,
      "shutdown": "2026-10-16",
      "replacement_official": {
        "name": "Gemini 3.5 Flash",
        "api_id": "gemini-3.5-flash"
      },
      "replacement_benchr_pick": {
        "name": "Gemini 3.5 Flash",
        "why": "Far stronger model, but input goes from $0.30 to $1.50 per 1M — a 5x increase. High-volume users should re-quote the bill before migrating."
      },
      "pricing_retiring": {
        "input_per_million": 0.3,
        "output_per_million": 2.5
      },
      "pricing_replacement": {
        "input_per_million": 1.5,
        "output_per_million": 9
      },
      "benchmark_delta": null,
      "page": "/deprecations/gemini-2-5-pro",
      "source": "https://ai.google.dev/gemini-api/docs/deprecations",
      "verified": "2026-06-12"
    },
    {
      "id": "gpt-4o",
      "kind": "model",
      "model_name": "GPT-4o",
      "provider": "OpenAI",
      "api_ids": [
        "gpt-4o-2024-05-13"
      ],
      "status": "deprecated",
      "announced": "2026-04-22",
      "shutdown": "2026-10-23",
      "replacement_official": {
        "name": "GPT-5.5",
        "api_id": "gpt-5.5"
      },
      "replacement_benchr_pick": {
        "name": "GPT-5",
        "why": "OpenAI points to GPT-5.5 ($5/$30); GPT-5 at $1.25/$10 is the closer cost match for most GPT-4o workloads."
      },
      "pricing_retiring": {
        "input_per_million": 5,
        "output_per_million": 15
      },
      "pricing_replacement": {
        "input_per_million": 5,
        "output_per_million": 30
      },
      "benchmark_delta": null,
      "page": "/deprecations/gpt-4o",
      "source": "https://developers.openai.com/api/docs/deprecations",
      "verified": "2026-06-12"
    },
    {
      "id": "gpt-4-0613",
      "kind": "model",
      "model_name": "GPT-4",
      "provider": "OpenAI",
      "api_ids": [
        "gpt-4-0613"
      ],
      "status": "deprecated",
      "announced": "2026-04-22",
      "shutdown": "2026-10-23",
      "replacement_official": {
        "name": "GPT-5.5",
        "api_id": "gpt-5.5"
      },
      "replacement_benchr_pick": {
        "name": "GPT-5",
        "why": "Cheaper than GPT-5.5 and far beyond 2023-era GPT-4 on every public benchmark."
      },
      "pricing_retiring": null,
      "pricing_replacement": {
        "input_per_million": 5,
        "output_per_million": 30
      },
      "benchmark_delta": null,
      "page": "/deprecations/openai-october-2026-retirements",
      "source": "https://developers.openai.com/api/docs/deprecations",
      "verified": "2026-06-12"
    },
    {
      "id": "gpt-4-turbo",
      "kind": "model",
      "model_name": "GPT-4 Turbo",
      "provider": "OpenAI",
      "api_ids": [
        "gpt-4-turbo",
        "gpt-4-1106-preview"
      ],
      "status": "deprecated",
      "announced": "2026-04-22",
      "shutdown": "2026-10-23",
      "replacement_official": {
        "name": "GPT-5.5",
        "api_id": "gpt-5.5"
      },
      "replacement_benchr_pick": {
        "name": "GPT-5",
        "why": "Drop-in for most GPT-4 Turbo workloads at a lower price than the official pick."
      },
      "pricing_retiring": null,
      "pricing_replacement": {
        "input_per_million": 5,
        "output_per_million": 30
      },
      "benchmark_delta": null,
      "page": "/deprecations/openai-october-2026-retirements",
      "source": "https://developers.openai.com/api/docs/deprecations",
      "verified": "2026-06-12"
    },
    {
      "id": "gpt-3-5-turbo",
      "kind": "model",
      "model_name": "GPT-3.5 Turbo",
      "provider": "OpenAI",
      "api_ids": [
        "gpt-3.5-turbo-0125"
      ],
      "status": "deprecated",
      "announced": "2026-04-22",
      "shutdown": "2026-10-23",
      "replacement_official": {
        "name": "GPT-5.4 mini",
        "api_id": "gpt-5.4-mini"
      },
      "replacement_benchr_pick": {
        "name": "GPT-5 Mini",
        "why": "$0.25/$2.00, in benchr's tracked set, and a clean swap for high-volume cheap workloads."
      },
      "pricing_retiring": null,
      "pricing_replacement": null,
      "benchmark_delta": null,
      "page": "/deprecations/openai-october-2026-retirements",
      "source": "https://developers.openai.com/api/docs/deprecations",
      "verified": "2026-06-12"
    },
    {
      "id": "o1",
      "kind": "model",
      "model_name": "o1",
      "provider": "OpenAI",
      "api_ids": [
        "o1-2024-12-17"
      ],
      "status": "deprecated",
      "announced": "2026-04-22",
      "shutdown": "2026-10-23",
      "replacement_official": {
        "name": "GPT-5.5",
        "api_id": "gpt-5.5"
      },
      "replacement_benchr_pick": {
        "name": "GPT-5.5",
        "why": "o1 billed $15/$60; GPT-5.5 reasons better at $5/$30."
      },
      "pricing_retiring": {
        "input_per_million": 15,
        "output_per_million": 60
      },
      "pricing_replacement": {
        "input_per_million": 5,
        "output_per_million": 30
      },
      "benchmark_delta": null,
      "page": "/deprecations/openai-october-2026-retirements",
      "source": "https://developers.openai.com/api/docs/deprecations",
      "verified": "2026-06-12"
    },
    {
      "id": "o1-pro",
      "kind": "model",
      "model_name": "o1-pro",
      "provider": "OpenAI",
      "api_ids": [
        "o1-pro-2025-03-19"
      ],
      "status": "deprecated",
      "announced": "2026-04-22",
      "shutdown": "2026-10-23",
      "replacement_official": {
        "name": "GPT-5.5 Pro",
        "api_id": "gpt-5.5-pro"
      },
      "replacement_benchr_pick": {
        "name": "GPT-5.5 Pro",
        "why": "o1-pro was OpenAI's most expensive model ever at $150/$600 per 1M tokens."
      },
      "pricing_retiring": {
        "input_per_million": 150,
        "output_per_million": 600
      },
      "pricing_replacement": null,
      "benchmark_delta": null,
      "page": "/deprecations/openai-october-2026-retirements",
      "source": "https://developers.openai.com/api/docs/deprecations",
      "verified": "2026-06-12"
    },
    {
      "id": "o3-mini",
      "kind": "model",
      "model_name": "o3-mini",
      "provider": "OpenAI",
      "api_ids": [
        "o3-mini-2025-01-31"
      ],
      "status": "deprecated",
      "announced": "2026-04-22",
      "shutdown": "2026-10-23",
      "replacement_official": {
        "name": "GPT-5.5",
        "api_id": "gpt-5.5"
      },
      "replacement_benchr_pick": null,
      "pricing_retiring": null,
      "pricing_replacement": null,
      "benchmark_delta": null,
      "page": "/deprecations/openai-october-2026-retirements",
      "source": "https://developers.openai.com/api/docs/deprecations",
      "verified": "2026-06-12"
    },
    {
      "id": "o4-mini",
      "kind": "model",
      "model_name": "o4-mini",
      "provider": "OpenAI",
      "api_ids": [
        "o4-mini-2025-04-16"
      ],
      "status": "deprecated",
      "announced": "2026-04-22",
      "shutdown": "2026-10-23",
      "replacement_official": {
        "name": "GPT-5.4 mini",
        "api_id": "gpt-5.4-mini"
      },
      "replacement_benchr_pick": null,
      "pricing_retiring": null,
      "pricing_replacement": null,
      "benchmark_delta": null,
      "page": "/deprecations/openai-october-2026-retirements",
      "source": "https://developers.openai.com/api/docs/deprecations",
      "verified": "2026-06-12",
      "shutdown_note": "Fine-tuned o4-mini variants (ft-o4-mini-2025-04-16) retire the same day."
    },
    {
      "id": "gpt-4-1-nano",
      "kind": "model",
      "model_name": "GPT-4.1 nano",
      "provider": "OpenAI",
      "api_ids": [
        "gpt-4.1-nano",
        "gpt-4.1-nano-2025-04-14"
      ],
      "status": "deprecated",
      "announced": "2026-04-22",
      "shutdown": "2026-10-23",
      "shutdown_note": "Only the nano tier has an announced date — gpt-4.1 and gpt-4.1-mini have NO published shutdown as of June 12, 2026.",
      "replacement_official": {
        "name": "GPT-5.4 nano",
        "api_id": "gpt-5.4-nano"
      },
      "replacement_benchr_pick": null,
      "pricing_retiring": null,
      "pricing_replacement": null,
      "benchmark_delta": null,
      "page": "/deprecations/openai-october-2026-retirements",
      "source": "https://developers.openai.com/api/docs/deprecations",
      "verified": "2026-06-12"
    },
    {
      "id": "gpt-image-1-base",
      "kind": "model",
      "model_name": "GPT Image 1",
      "provider": "OpenAI",
      "api_ids": [
        "gpt-image-1"
      ],
      "status": "deprecated",
      "announced": "2026-04-22",
      "shutdown": "2026-10-23",
      "shutdown_note": "The base gpt-image-1 goes October 23, 2026; GPT Image 1 mini and 1.5 follow December 1, 2026 (separate entry).",
      "replacement_official": {
        "name": "GPT Image 2",
        "api_id": "gpt-image-2"
      },
      "replacement_benchr_pick": null,
      "pricing_retiring": null,
      "pricing_replacement": null,
      "benchmark_delta": null,
      "page": "/deprecations/openai-october-2026-retirements",
      "source": "https://developers.openai.com/api/docs/deprecations",
      "verified": "2026-06-12"
    },
    {
      "id": "openai-prompts-api",
      "kind": "platform",
      "model_name": "OpenAI Reusable Prompts API",
      "provider": "OpenAI",
      "api_ids": [
        "v1/prompts"
      ],
      "status": "deprecated",
      "announced": "2026-06-03",
      "shutdown": "2026-11-30",
      "replacement_official": null,
      "replacement_benchr_pick": {
        "name": "Inline prompts",
        "why": "OpenAI lists no successor product; the migration is moving prompt content into application code."
      },
      "pricing_retiring": null,
      "pricing_replacement": null,
      "benchmark_delta": null,
      "page": null,
      "source": "https://developers.openai.com/api/docs/deprecations",
      "verified": "2026-06-12"
    },
    {
      "id": "openai-evals-platform",
      "kind": "platform",
      "model_name": "OpenAI Evals platform (dashboard + API)",
      "provider": "OpenAI",
      "api_ids": [
        "evals"
      ],
      "status": "deprecated",
      "announced": "2026-06-03",
      "shutdown": "2026-11-30",
      "replacement_official": null,
      "replacement_benchr_pick": null,
      "pricing_retiring": null,
      "pricing_replacement": null,
      "benchmark_delta": null,
      "page": null,
      "source": "https://developers.openai.com/api/docs/deprecations",
      "verified": "2026-06-12"
    },
    {
      "id": "openai-agent-builder",
      "kind": "platform",
      "model_name": "OpenAI Agent Builder",
      "provider": "OpenAI",
      "api_ids": [
        "agent-builder"
      ],
      "status": "deprecated",
      "announced": "2026-06-03",
      "shutdown": "2026-11-30",
      "replacement_official": {
        "name": "Agents SDK",
        "api_id": null
      },
      "replacement_benchr_pick": null,
      "pricing_retiring": null,
      "pricing_replacement": null,
      "benchmark_delta": null,
      "page": null,
      "source": "https://developers.openai.com/api/docs/deprecations",
      "verified": "2026-06-12"
    },
    {
      "id": "gpt-image-1",
      "kind": "model",
      "model_name": "GPT Image 1 mini and 1.5",
      "provider": "OpenAI",
      "api_ids": [
        "gpt-image-1-mini",
        "gpt-image-1.5"
      ],
      "status": "deprecated",
      "announced": "2026-06-02",
      "shutdown": "2026-12-01",
      "replacement_official": {
        "name": "GPT Image 2",
        "api_id": "gpt-image-2"
      },
      "replacement_benchr_pick": null,
      "pricing_retiring": null,
      "pricing_replacement": null,
      "benchmark_delta": null,
      "page": null,
      "source": "https://developers.openai.com/api/docs/deprecations",
      "verified": "2026-06-12"
    },
    {
      "id": "openai-gpt5-o3-snapshots-dec-2026",
      "kind": "model",
      "model_name": "Older GPT-5 and o3 model snapshots",
      "provider": "OpenAI",
      "api_ids": [
        "gpt-5-2025-08-07",
        "gpt-5-mini-2025-08-07",
        "gpt-5-nano-2025-08-07",
        "gpt-5-pro-2025-10-06",
        "o3-2025-04-16",
        "o3-pro-2025-06-10"
      ],
      "status": "deprecated",
      "announced": "2026-06-11",
      "shutdown": "2026-12-11",
      "shutdown_note": "Dated snapshots only — the floating gpt-5 / gpt-5-mini / gpt-5-nano aliases stay live. Per-id replacements on the OpenAI deprecations page: gpt-5-2025-08-07 and o3-2025-04-16 -> gpt-5.5; gpt-5-mini-2025-08-07 -> gpt-5.4-mini; gpt-5-nano-2025-08-07 -> gpt-5.4-nano; gpt-5-pro-2025-10-06 and o3-pro-2025-06-10 -> gpt-5.5-pro.",
      "replacement_official": {
        "name": "GPT-5.5 / GPT-5.4 mini / GPT-5.4 nano / GPT-5.5 Pro",
        "api_id": "gpt-5.5"
      },
      "replacement_benchr_pick": null,
      "pricing_retiring": null,
      "pricing_replacement": null,
      "benchmark_delta": null,
      "page": null,
      "source": "https://developers.openai.com/api/docs/deprecations",
      "verified": "2026-06-23"
    },
    {
      "id": "openai-legacy-audio-realtime-jan-2027",
      "kind": "model",
      "model_name": "OpenAI legacy audio, realtime, and transcription models",
      "provider": "OpenAI",
      "api_ids": [
        "gpt-realtime",
        "gpt-realtime-mini",
        "gpt-audio",
        "gpt-audio-mini",
        "gpt-4o-realtime",
        "gpt-4o-mini-realtime",
        "gpt-4o-audio",
        "gpt-4o-mini-audio",
        "gpt-4o-mini-transcribe-2025-03-20"
      ],
      "status": "deprecated",
      "announced": "2026-07-20",
      "shutdown": "2027-01-20",
      "shutdown_note": "OpenAI's page reads: \"On July 20, 2026, we notified developers using legacy audio, realtime, and transcription model families and snapshots of their deprecation and removal from the API on January 20, 2027.\" Replacements differ per family: realtime IDs move to gpt-realtime-2.1 (mini to gpt-realtime-2.1-mini), audio IDs to gpt-audio-1.5, and gpt-4o-mini-transcribe-2025-03-20 to gpt-4o-mini-transcribe-2025-12-15.",
      "replacement_official": {
        "name": "GPT Realtime 2.1 / GPT Audio 1.5",
        "api_id": "gpt-realtime-2.1"
      },
      "replacement_benchr_pick": null,
      "pricing_retiring": null,
      "pricing_replacement": null,
      "benchmark_delta": null,
      "page": null,
      "source": "https://developers.openai.com/api/docs/deprecations",
      "verified": "2026-08-24"
    },
    {
      "id": "claude-mythos-preview",
      "kind": "model",
      "model_name": "Claude Mythos Preview",
      "provider": "Anthropic",
      "api_ids": [
        "claude-mythos-preview"
      ],
      "status": "deprecated",
      "announced": null,
      "shutdown": null,
      "shutdown_note": "Anthropic's current model-status table lists Claude Mythos Preview as deprecated and gives no retirement date. The prior June 30, 2026 date was removed on July 27 rather than being treated as a confirmed retirement. Migrate to the Glasswing-gated Claude Mythos 5 (claude-mythos-5); general developers should use Claude Fable 5.",
      "replacement_official": {
        "name": "Claude Mythos 5",
        "api_id": "claude-mythos-5"
      },
      "replacement_benchr_pick": {
        "name": "Claude Mythos 5",
        "why": "Glasswing-gated successor; general developers should use Claude Fable 5 instead."
      },
      "pricing_retiring": null,
      "pricing_replacement": {
        "input_per_million": 10,
        "output_per_million": 50
      },
      "benchmark_delta": null,
      "page": null,
      "source": "https://platform.claude.com/docs/en/about-claude/model-deprecations",
      "verified": "2026-07-08"
    }
  ]
}