Gemini API Image Generation 2026: как исправить failed to fetch после отключения preview-моделей

Два дедлайна по отключению Gemini Image API работают одновременно. Первый наступит через пять дней. Если ваш pipeline по-прежнему использует preview-идентификатор модели изображений, он перестанет отвечать 25 июня. Второй — затрагивающий GA-endpoint'ы Imagen 4 — даёт время до 17 августа. Оба этапа требуют принятия routing-решения сегодня, а не во время дежурного инцидента.

Что произошло

Официальный changelog Gemini API содержит два объявления об устаревании из мая и июня 2026 года, затрагивающие идентификаторы моделей для генерации изображений:

Волна 1 — 25 июня 2026 года (срочно):

• gemini-3.1-flash-image-preview — отключение
• gemini-3-pro-image-preview — отключение

Эти модели были объявлены устаревшими 28 мая 2026 года, когда Google выпустил GA-замены: gemini-3.1-flash-image (Nano Banana 2) и gemini-3-pro-image (Nano Banana Pro). Минимальный срок уведомления для preview-ID — две недели; 25 июня — жёсткий дедлайн.

Волна 2 — 17 августа 2026 года (планирование):

• imagen-4.0-generate-001
• imagen-4.0-ultra-generate-001
• imagen-4.0-fast-generate-001

Это GA-endpoint'ы Imagen 4, объявленные устаревшими 15 июня 2026 года. Полные пути миграции пока не опубликованы, но официальная страница устаревания Gemini будет обновляться. Командам, использующим endpoint'ы Imagen 4, отведено около восьми недель.

Почему это важно для инженерных команд

Генерация изображений всё активнее встраивается в production-pipeline — для мультимодальных агентов, создающих превью, брендинговые материалы, инфографику для отчётов или UI-макеты. Описываемая структура устаревания обладает двумя свойствами, которые делают её рискованней обычного завершения поддержки модели:

Две волны — два разных кода ответа. После отключения preview-идентификатора 25 июня API-вызовы будут возвращать ошибку, а не плавную деградацию. Команды, использующие preview-строку в конфигурации вместо GA-строки, столкнутся с жёсткими сбоями, а не с ухудшением качества. Это отличается от мягкого устаревания, при котором модель просто перенаправляется.

Ситуация с Imagen 4 принципиально иная. GA-endpoint'ы Imagen 4 (imagen-4.0-*) заменяются — это не переход preview→GA, а смена поколения GA-моделей. Целевые кандидаты для миграции из текущей линейки Gemini Image — те же модели, что заменили preview-волну: gemini-3.1-flash-image и gemini-3-pro-image. Перекрытие возможностей между Imagen 4 и нативными моделями Gemini 3.x существенно — обе поддерживают текстовый рендеринг, а Flash Image поддерживает генерацию изображений из видео — однако API-контракт различается: Imagen 4 использует путь imageGeneration, тогда как модели Gemini 3.x Image работают через стандартный API generateContent.

Конфигурация маршрутизации требует двух отдельных обновлений. Команда, которая сегодня устранит Волну 1, переключив preview-ID на GA-ID, не закроет Волну 2. 17 августа потребуется второй проход.

Угол routing/operator

Если вы маршрутизируете запросы на генерацию изображений через прокси или gateway, устаревание порождает задачу аудита model ID на уровне routing-слоя, а не только прикладного:

Проведите аудит allowlist идентификаторов моделей. Любая routing-таблица, псевдоним модели или fallback-цепочка, ссылающаяся на gemini-3.1-flash-image-preview, gemini-3-pro-image-preview или любой вариант imagen-4.0-*, должна быть обновлена в два прохода. Preview-ID следует деактивировать до 25 июня; Imagen 4 ID — до 17 августа.

Волна 1 затрагивает также Firebase AI Logic. SDK Firebase AI Logic маршрутизировал к моделям Imagen, которые выводятся из эксплуатации — в документации Firebase явно указано, что все модели Imagen в этом SDK устарели с датой отключения 24 июня. Командам, использующим Firebase для генерации изображений в мобильных или веб-приложениях, необходимо мигрировать на SDK Gemini Image.

Паритет моделей между заменами Волны 1 и Волной 2. GA-модели Gemini Image, заменяющие preview-волну (gemini-3.1-flash-image, gemini-3-pro-image), являются и целями миграции для части Волны 2. Это означает, что routing-политика может консолидироваться, а не расширяться: вы переходите к меньшему числу хорошо поддерживаемых model ID, а не фрагментируете настройки по новым провайдерам.

Несовместимость API generateContent и endpoint'а Imagen. Если существующий pipeline был построен под формат endpoint'а Imagen 4, миграция на gemini-3-pro-image потребует изменения формата API-вызова, а не просто замены строки model ID. Запланируйте короткий цикл интеграционного тестирования до 17 августа.

Что стоит проверить операторам TheRouter

Если вы маршрутизируете вызовы генерации изображений через TheRouter, сверьте сконфигурированные model ID с обоими дедлайнами. Изменение routing-политики простое: замените строки preview-идентификаторов и зафиксируйте дату 17 августа для endpoint'ов Imagen 4 в календаре устаревания.

Для команд, строящих мультипровайдерную маршрутизацию генерации изображений — например, переключение между моделями Gemini Image и wan2.7-image-pro на DashScope в зависимости от типа контента или стоимости — переход 25 июня является удачным триггером для проверки конфигурации fallback. Любая fallback-цепочка, в которой preview-идентификатор указан как резервный вариант, будет давать тихий сбой после 25 июня при недоступности основной модели.

Ранее мы рассматривали устаревание endpoint'ов Vertex AI Imagen и Veo (отключение 30 июня). Устаревания Gemini API, описанные здесь, — это отдельная система с другими model ID, другими путями endpoint'ов и другими датами отключения. Оба направления требуют внимания.

Чек-лист для операторов

До 25 июня:

1. Найдите в кодовой базе, конфигурационных файлах и routing-таблицах строки gemini-3.1-flash-image-preview и gemini-3-pro-image-preview
2. Замените на gemini-3.1-flash-image (Flash-уровень) или gemini-3-pro-image (Pro-уровень) соответственно
3. Перезапустите интеграционные тесты — GA-контракт стабилен, но стоит проверить в конкретной среде

До 17 августа:

1. Проведите аудит всех ссылок на imagen-4.0-generate-001, imagen-4.0-ultra-generate-001 и imagen-4.0-fast-generate-001
2. Определите целевой путь миграции — gemini-3.1-flash-image покрывает большинство сценариев Imagen 4, включая текстовый рендеринг и генерацию изображений из видео
3. Учтите изменение формата API, если pipeline использовал специфический формат Imagen
4. Отслеживайте публикацию официального руководства по миграции на странице устаревания Gemini

Двухволновая структура характерна для зрелого мультимодального API, однако одновременное существование пятидневного дедлайна и восьминедельного планового окна превращает это в задачу расстановки приоритетов, а не простую миграцию.