Миграция с OpenAI Codex, Deep Research и Computer Use до shutdown 23 июля

22 апреля 2026 года OpenAI объявила о retirement набора устаревших снапшотов — вариантов Codex, моделей deep-research, превью computer-use и legacy ID search-preview. Все они прекращают работу 23 июля 2026 года. Сегодня 3 июля — осталось 20 дней.

Если ваш production-код вызывает любой из этих model ID, после shutdown запросы начнут возвращать ошибки. Это не постепенная деградация — endpoint просто перестаёт отвечать на старое имя. Вам нужно выполнить миграцию, протестировать и задеплоить до 23 июля.

Мы маршрутизируем OpenAI-совместимые запросы через настроенных провайдеров и поддерживаем routing и fallback между провайдерами/моделями там, где это реализовано в продукте. Мы не заявляем нулевой downtime, поддержку всех моделей или гарантированно минимальные цены. Все даты и цены в этом руководстве взяты из официальной документации OpenAI с указанием даты получения.

1. Меняйте три значения, а не три SDK. Замените api_key, base_url и model в существующем клиенте OpenAI. Код запроса и ответа оставьте неизменным.
2. Сопоставьте model ID явно. ID модели у целевого провайдера почти никогда не совпадает с OpenAI ID. Держите словарь { openai_id: target_id } вне бизнес-логики.
3. Проверьте формат streaming. SSE-чанки должны соответствовать контракту OpenAI: data: {...} + data: [DONE]. Прогоните один streaming вызов до продакшена.
4. Проверьте rate-limit заголовки. Некоторые провайдеры не возвращают x-ratelimit-*. Добавьте обёртку с безопасным дефолтом.
5. Оставьте путь отката. Раскатайте замену под feature flag, гоняйте оба endpoint в shadow-режиме 24 часа, затем переключайтесь.

Ответ за 30 секунд

• Дата shutdown: 23 июля 2026. Никакого grace period после этой даты (OpenAI Deprecations, получено 2026-07-03).
• Выводимые категории: Варианты Codex (gpt-5-codex, gpt-5.1-codex, gpt-5.1-codex-max, gpt-5.1-codex-mini), deep-research модели (o3-deep-research, o4-mini-deep-research), computer-use preview, legacy search-preview ID, снапшоты audio/realtime mini.
• Основные замены: gpt-5.5 (Codex/flagship), gpt-5.4-mini (mini/search-preview/computer-use), gpt-5.5-pro (deep research).
• Период уведомления: Это специализированные варианты (Codex, deep-research) и preview-модели — политика OpenAI предусматривает минимум 3 месяца для вариантов и от 2 недель для preview. Уведомление соответствует политике.
• Действуйте сейчас: Найдите model ID из списка ниже в кодовой базе. Проведите shadow-тест замен. Задеплойте до 20 июля.

Полная матрица замен

Все данные из OpenAI Deprecations, получено 2026-07-03.

Ключевая закономерность — три целевых замены: Варианты Codex и flagship chat переходят на gpt-5.5. Mini и preview варианты — на gpt-5.4-mini. Рабочие нагрузки deep-research — на gpt-5.5-pro. Audio/realtime получают обновлённые снапшоты того же класса.

Code diff: до и после

Варианты Codex (gpt-5-codex, gpt-5.1-codex, gpt-5.1-codex-max)

Эти ID использовались для code completion — как правило, в agentic-пайплайнах, CI code review или интеграциях Codex CLI. Замена — gpt-5.5.

# До
from openai import OpenAI
client = OpenAI()

response = client.chat.completions.create(
    model="gpt-5.1-codex",          # ← retirement 23 июля
    messages=[{"role": "user", "content": "Рефактори эту функцию: ..."}],
)

# После
response = client.chat.completions.create(
    model="gpt-5.5",                 # ✓ замена
    messages=[{"role": "user", "content": "Рефактори эту функцию: ..."}],
)

Для gpt-5.1-codex-mini (cost-оптимизированный вариант Codex) — замена gpt-5.4-mini:

# После (mini-нагрузки)
response = client.chat.completions.create(
    model="gpt-5.4-mini",            # ✓ замена для codex-mini
    messages=[{"role": "user", "content": "..."}],
)

Deep research (o3-deep-research, o4-mini-deep-research)

Deep-research модели использовались для долгосрочных исследовательских задач через Responses API. Замена — gpt-5.5-pro.

# До — Responses API с o3-deep-research
from openai import OpenAI
client = OpenAI()

response = client.responses.create(
    model="o3-deep-research",        # ← retirement 23 июля
    input="Сделай обзор состояния квантовой коррекции ошибок в 2026 году.",
    tools=[{"type": "web_search_preview"}],
)

# После
response = client.responses.create(
    model="gpt-5.5-pro",             # ✓ замена
    input="Сделай обзор состояния квантовой коррекции ошибок в 2026 году.",
    tools=[{"type": "web_search_preview"}],
)

Важно: gpt-5.5-pro существенно дороже o3-deep-research. Если стоимость критична, сначала протестируйте gpt-5.5 — многие исследовательские задачи он решает без необходимости в Pro-уровне. Подробности — в разделе цен ниже.

Computer use (computer-use-preview)

Приложения computer-use использовали computer-use-preview для управления браузером/рабочим столом. OpenAI сопоставляет его с gpt-5.4-mini.

# До
response = client.responses.create(
    model="computer-use-preview",    # ← retirement 23 июля
    input=[{"type": "text", "text": "Открой терминал и выполни `ls -la`."}],
    tools=[{"type": "computer_use_preview", "display_width": 1024, "display_height": 768, "environment": "browser"}],
)

# После — gpt-5.4-mini с инструментом computer_use
response = client.responses.create(
    model="gpt-5.4-mini",            # ✓ замена согласно уведомлению OpenAI
    input=[{"type": "text", "text": "Открой терминал и выполни `ls -la`."}],
    tools=[{"type": "computer_use_preview", "display_width": 1024, "display_height": 768, "environment": "browser"}],
)

Тщательно тестируйте: gpt-5.4-mini — модель общего назначения. Перед деплоем убедитесь, что процент выполнения задач computer-use соответствует вашему baseline.

Web search preview (gpt-4o-search-preview, gpt-4o-mini-search-preview)

Это были модели с инструментом web_search_preview. Переходят на gpt-5.4-mini с текущим (не preview) инструментом web search.

# До
response = client.chat.completions.create(
    model="gpt-4o-search-preview",   # ← retirement 23 июля
    messages=[{"role": "user", "content": "Какие сейчас цены на модели OpenAI?"}],
)

# После — gpt-5.4-mini через Responses API с web_search
response = client.responses.create(
    model="gpt-5.4-mini",            # ✓ замена
    input="Какие сейчас цены на модели OpenAI?",
    tools=[{"type": "web_search_preview"}],
)

Responses API — официальный дом для web search в будущем. Если вы ещё на Chat Completions, эта миграция — хороший повод перейти на Responses API. Подробнее в нашем руководстве по миграции Assistants → Responses API.

Ценовая дельта

Цены из OpenAI API Pricing, получено 2026-07-03.

Предупреждение для deep research: Если вы используете o3-deep-research в масштабе, gpt-5.5-pro за $30/$180 за миллион токенов — это существенный рост расходов. Прежде чем переходить на Pro, оцените, справится ли gpt-5.5. Прогоните один и тот же батч задач через обе модели и сравните качество вывода.

Codex/mini: gpt-5.4-mini за $0.75/$4.50 находится в схожем ценовом диапазоне. Большинство команд увидят нейтральное или незначительное изменение стоимости.

Search-preview: Эти модели раньше оплачивались только по токенным ставкам модели. Замена gpt-5.4-mini с инструментом web search тарифицирует $10 за 1 000 поисковых вызовов плюс токены модели. При высоком объёме поиска — это значимый рост расходов.

Подводные камни и чеклист миграции

Аутентификация и заголовки

Никаких изменений аутентификации не требуется. Все замены используют тот же заголовок Authorization: Bearer $OPENAI_API_KEY и тот же base URL (https://api.openai.com/v1).

Форматы model ID и алиасы

OpenAI принимает как снапшот с датой (o3-deep-research-2025-06-26), так и алиас без даты (o3-deep-research). Оба варианта выводятся 23 июля. Ищите обе формы в коде.

Различия в API-интерфейсе

• Codex → gpt-5.5: Тот же интерфейс Chat Completions или Responses API. Меняется только поле model.
• o3-deep-research → gpt-5.5-pro: Тот же интерфейс Responses API. Параметр reasoning.effort по-прежнему работает на gpt-5.5-pro. Структурных изменений не требуется.
• computer-use-preview → gpt-5.4-mini: Схема инструмента computer_use_preview не изменилась. Меняется только model.
• search-preview → gpt-5.4-mini + web_search: Если вы на Chat Completions с search-preview, рассмотрите переход на Responses API с инструментом web_search_preview.

Фиксация снапшота и rollback

Если нужно сохранить стабильный профиль ответов модели для критичной нагрузки, можно зафиксировать датированный снапшот замены (например, gpt-5.5-2026-05-15, если доступен). Проверьте OpenAI models reference на предмет доступных снапшотов каждой замены.

До 23 июля некритичные пути могут продолжать вызывать старые model ID. После 23 июля rollback невозможен — endpoints уходят в offline.

Rollback-план

Рекомендуем поэтапный подход:

1. Сейчас (3–10 июля): Найдите все вызовы устаревших model ID. Обновите model ID в коде. Задеплойте на staging.
2. 10–17 июля: Проведите shadow-тест на новых и старых model ID. Сравните вывод и латентность.
3. 17–20 июля: Переведите production-трафик на новые model ID. Отключите старые ID в router config.
4. 20–23 июля: Полный перевод production. Мониторьте error rate на старых ID — если ошибок нет, миграция завершена.

Если после деплоя обнаружена регрессия, rollback — это возврат поля model к старому ID, но только до 23 июля. После этой даты rollback недоступен.

Интеграция с TheRouter: fallback-конфигурация на переходный период

Если вы маршрутизируете OpenAI-совместимый трафик через TheRouter, можно настроить автоматический fallback с устаревших model ID на замены на период перехода. Это страховка для вызывающих сторон, которые не успеют до 20 июля.

{
  "routes": [
    {
      "match": { "model": "gpt-5.1-codex" },
      "rewrite_model": "gpt-5.5",
      "provider": "openai",
      "comment": "gpt-5.1-codex retirement 23 июля — переписываем в gpt-5.5"
    },
    {
      "match": { "model": "o3-deep-research" },
      "rewrite_model": "gpt-5.5-pro",
      "provider": "openai",
      "comment": "o3-deep-research retirement 23 июля — переписываем в gpt-5.5-pro"
    },
    {
      "match": { "model": "computer-use-preview" },
      "rewrite_model": "gpt-5.4-mini",
      "provider": "openai",
      "comment": "computer-use-preview retirement 23 июля — переписываем в gpt-5.4-mini"
    },
    {
      "match": { "model": "gpt-4o-search-preview" },
      "rewrite_model": "gpt-5.4-mini",
      "provider": "openai",
      "comment": "gpt-4o-search-preview retirement 23 июля — переписываем в gpt-5.4-mini"
    }
  ]
}

TheRouter маршрутизирует OpenAI-совместимые запросы и поддерживает routing/fallback там, где это реализовано в продукте. Перед тем как полагаться на этот механизм как страховку, убедитесь, что gpt-5.5, gpt-5.4-mini и gpt-5.5-pro доступны в вашей конфигурации провайдера OpenAI.

Подробнее — в нашем руководстве по миграции на OpenAI через TheRouter и документации по model fallback.

Связь с другими волнами deprecation

Волна 23 июля отличается от двух других активных событий deprecation OpenAI:

• 11 декабря 2026: Шесть снапшотов первого поколения GPT-5 и O3 (gpt-5-2025-08-07, o3-2025-04-16 и др.) — в нашем руководстве по планированию миграции с GPT-5.
• 30 ноября 2026: Reusable prompts OpenAI, платформа Evals и Agent Builder — анонс 3 июня 2026, не model ID.

Сначала разберитесь с июлём. После этого дедлайна займитесь декабрьской волной.

Production-чеклист

Выполните до 23 июля:

• Найдите в кодовой базе все строки с устаревшими model ID (полный список — в матрице замен выше)
• Определите API-интерфейс каждого вызова: Chat Completions, Responses API или legacy Assistants
• Сопоставьте каждый устаревший ID с заменой по таблице выше
• Обновите поля model во всех вызовах и конфигурационных файлах
• Задеплойте на staging и запустите существующий test suite
• Shadow-тест (10–17 июля) production-трафика на новых и старых model ID
• Аудит стоимости: оцените месячный расход токенов по новым ценам — особенно для deep-research
• Конфиг TheRouter: при необходимости добавьте правила model-rewrite для вызывающих, которые ещё не мигрировали
• Задеплойте на production до 20 июля (3-дневный буфер до shutdown)
• Мониторьте error rate на старых ID — нулевые ошибки = успешная миграция
• После cutover удалите ссылки на старые model ID из кода

Полезные ссылки

• OpenAI Deprecations — источник истины, получено 2026-07-03
• OpenAI API Pricing — цены на модели, получено 2026-07-03
• OpenAI models reference — доступность снапшотов
• Миграция Assistants → Responses API — для search-preview на Chat Completions или Assistants
• Руководство по декабрьской волне GPT-5 — следующая волна deprecation OpenAI
• Страница провайдера OpenAI — статус routing на TheRouter
• Документация по model fallback — настройка fallback-маршрутизации