Gemini 3 Pro Preview не найден: как быстро исправить ошибку после отключения (2026)

Если вы видите gemini-3-pro-preview not found, model not found или 404 NOT_FOUND, главный ответ теперь простой: Google отключил Gemini 3 Pro Preview 9 марта 2026 года, поэтому старый ID модели больше не является рабочей целью по умолчанию. Прямая замена -- gemini-3.1-pro-preview. Если вы уже изменили имя модели, но Vertex AI всё равно падает, следующая проверка -- не API key, а location, потому что Google сейчас документирует gemini-3.1-pro-preview как модель, доступную в Vertex AI только через global endpoint.

Эта статья разделяет три вещи, которые SERP часто смешивает: старую отключённую модель, правильную замену и конфигурационные ошибки, из-за которых всё ещё кажется, будто «новая модель тоже не работает». Если времени мало, начните с быстрой таблицы и чеклиста миграции.

Кратко: таблица быстрых исправлений

Суть в том, что это теперь прежде всего проблема жизненного цикла модели, а не проблема повторных попыток.

Почему теперь появляется ошибка gemini-3-pro-preview not found

Официальные страницы Google довольно ясны, но информация разнесена по нескольким документам. На практике цепочка выглядела так:

Текущая страница моделей прямо показывает предупреждение: Gemini 3 Pro Preview был shut down 9 марта 2026 года, и нужно мигрировать на Gemini 3.1 Pro Preview.

Важно: это не значит, что ваш проект, API key или история AI Studio были удалены. В официальном ответе на форуме Google написал, что проекты, ключи и сохранённые prompts остаются, но всё, что всё ещё ссылается на gemini-3-pro-preview, после 9 марта будет возвращать ошибку.

Правильная замена: gemini-3.1-pro-preview или gemini-2.5-pro

Многие страницы ограничиваются советом «переименуйте модель в 3.1». Для части команд этого достаточно, но не для всех. Реальный вопрос обычно звучит так: вы хотите остаться на актуальной Gemini 3 Pro-линии или вам важнее быстрее вернуть стабильный Pro-уровень без нового preview-риска?

Практически это означает:

• Если вы брали Gemini 3 Pro Preview ради самой новой Gemini 3 Pro-линии, переходите на gemini-3.1-pro-preview.
• Если вам важнее стабильность и меньшая турбулентность, разумнее выбрать gemini-2.5-pro.

Для более широкого сравнения смотрите нашу статью Gemini 3.1 Pro vs Gemini 2.5 Pro.

Не путайте похожие названия моделей

Сейчас названий у Gemini достаточно много, и многие миграции ломаются просто потому, что команда выбирает похожую, но неправильную строку.

Самая частая ошибка -- перейти с gemini-3-pro-preview на gemini-3-pro-image-preview, потому что названия похожи. Для chat, coding, анализа и reasoning это неправильное направление.

Исправление по поверхности: API, AI Studio, Vertex AI и wrappers

Gemini API / SDK

python

model = "gemini-3-pro-preview"

# прямой преемник
model = "gemini-3.1-pro-preview"

# более стабильный fallback
model = "gemini-2.5-pro"

Google AI Studio

Если старый prompt перестал работать, не начинайте с гипотезы о сломанном проекте. Чаще всего сохранённый prompt всё ещё привязан к gemini-3-pro-preview. Откройте его и поменяйте выбор модели на gemini-3.1-pro-preview.

Vertex AI

Это второй большой источник проблем. Текущий гайд по Gemini 3 в Vertex AI говорит, что gemini-3.1-pro-preview доступен только через global endpoint.

bash
export GOOGLE_CLOUD_PROJECT="your-project-id"
export GOOGLE_CLOUD_LOCATION="global"
export GOOGLE_GENAI_USE_VERTEXAI=True

Если вы оставили региональную location, миграция может продолжать падать даже при правильном имени модели.

Wrappers, шаблоны и скрытые defaults

Проверьте также:

• .env файлы
• defaults внутри wrappers
• CI/CD secrets
• сохранённые prompts
• test fixtures
• админ-панели
• очереди задач со старым payload

И выполните глобальный поиск:

bash
rg "gemini-3-pro-preview"

Пока строка где-то существует, старая модель всё ещё может вызываться из какого-то куска системы.

Чеклист миграции для реального проекта

Практическая ценность этого порядка в том, что он отделяет сам факт отключения модели от последующих ошибок конфигурации. Сначала вы убираете старый ID, затем очищаете скрытые ссылки и только потом разбираете endpoint, параметры и поведение wrapper. Это уменьшает риск ложного вывода «3.1 тоже сломан», когда на самом деле система всё ещё дергает старую модель из другого места.

Если проект большой, полезно также временно зафиксировать явный allowlist допустимых моделей в одном месте конфигурации. Тогда любой старый job, admin-панель или внутренний сервис, который попытается отправить gemini-3-pro-preview, будет ломаться предсказуемо и заметно уже внутри вашей системы, а не в виде плавающей внешней ошибки. Для миграций такого типа это часто быстрее, чем пытаться на глаз найти все устаревшие маршруты.

Ещё одна полезная практика для команд, у которых несколько сред, -- проверить миграцию по уровням: локальная разработка, staging, production и фоновые задачи. Очень часто основной API-маршрут уже переведён на новый ID, а batch-job, cron или старый internal tool продолжает жить на прошлой строке модели. Из-за этого возникает впечатление, что ошибка «возвращается случайно», хотя на самом деле её поднимают разные части системы.

Готовые примеры миграции

Python

python
from google import genai

client = genai.Client(api_key="YOUR_API_KEY")

response = client.models.generate_content(
    model="gemini-3.1-pro-preview",
    contents="Объясни TLS handshake простыми словами."
)

print(response.text)

Node.js

javascript
import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });

const response = await ai.models.generateContent({
  model: "gemini-3.1-pro-preview",
  contents: "Объясни TLS handshake простыми словами."
});

console.log(response.text);

curl

bash
curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.1-pro-preview:generateContent?key=$GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "parts": [
          { "text": "Объясни TLS handshake простыми словами." }
        ]
      }
    ]
  }'

Troubleshooting: что проверять, если после rename ошибки остались

Если вы уже переименовали модель, не стоит продолжать считать все последующие ошибки тем же самым not found. На этом этапе вы, скорее всего, уже перешли к другой диагностической ветке.

1. Неправильный endpoint или location

Для Vertex AI это по-прежнему наиболее вероятная причина. Если GOOGLE_CLOUD_LOCATION не равен global, исправьте это первым делом.

2. Где-то всё ещё живёт старая ссылка

Старая ссылка может оставаться в prompt, default-конфиге фреймворка, payload очереди или тестовой фикстуре.

3. Вы перешли в неправильное семейство моделей

Если вы заменили текстовую модель на gemini-3-pro-image-preview, это не правильная миграция, а смена семейства.

4. Теперь вы диагностируете уже другой тип ошибки

После правильного rename следующая проблема может быть уже такой:

• 404 NOT_FOUND из-за неверной поверхности или path
• 400 INVALID_ARGUMENT из-за параметров
• 503 UNAVAILABLE из-за временной перегрузки

Если тип ошибки изменился после rename, это часто хороший знак: значит, вы уже прошли слой «отключённой модели». Для широкого troubleshooting используйте нашу полную инструкцию по ошибкам Gemini API.

Ещё один практический совет: после таких отключений полезно обновить не только код, но и все операционные артефакты вокруг него. Если в runbook, onboarding-документе или шаблоне тикета до сих пор фигурирует gemini-3-pro-preview, команда почти гарантированно вернётся к той же ошибке через неделю или месяц. Успешная миграция здесь означает не просто «один запрос снова заработал», а то, что старая модель перестала существовать во всей рабочей системе как допустимый выбор.

Если вы хотите быстро проверить, закрыта ли именно проблема shutdown, полезно отправить один минимальный запрос напрямую в ту же поверхность, где возникала ошибка. Когда такой тест проходит на gemini-3.1-pro-preview или gemini-2.5-pro, а продовый сценарий всё ещё ломается, это почти всегда указывает на локальную конфигурацию, wrapper или старый сохранённый prompt, а не на отсутствие новой модели как таковой.

Именно поэтому в postmortem по таким инцидентам обычно стоит фиксировать не только «какой ID модели поставить», но и «в каких местах он вообще может задаваться». Для будущих отключений это превращает разовый пожар в повторяемую операционную процедуру: есть список поверхностей, ответственный за каждую из них и быстрый способ доказать, что старая модель больше нигде не живёт.

Стоит ли сразу поднимать 3.1 Pro Preview

Если вы изначально выбрали Gemini 3 Pro Preview, потому что хотели именно самую новую Pro-линию Gemini 3, тогда gemini-3.1-pro-preview -- правильная замена. Но это не значит, что каждая команда должна немедленно сделать её default.

Если реальная цель -- быстро вернуть рабочий Pro-класс с меньшей волатильностью, gemini-2.5-pro будет более консервативным выбором. Если после перехода на 3.1 вы столкнётесь с timeout или overload, посмотрите и нашу статью про timeouts Gemini 3.1 Pro.

На практике многие команды делают это поэтапно: сначала возвращают работоспособность на gemini-2.5-pro, затем отдельно тестируют gemini-3.1-pro-preview на реальных workload и только после этого решают, делать ли её новой моделью по умолчанию. Такой порядок скучнее, чем немедленный апгрейд, но он лучше подходит для продовых систем, где важнее предсказуемость, чем скорость перехода на самый новый preview.

FAQ

Google полностью удалил Gemini 3 Pro Preview?
Да. Официальная страница deprecations указывает, что gemini-3-pro-preview был отключён 9 марта 2026 года.

gemini-3.1-pro-preview -- это официальная замена?
Да. И таблица deprecations, и release notes указывают именно на gemini-3.1-pro-preview.

AI Studio удалил мои проекты или prompts?
Нет. Google пишет в официальной теме форума, что проекты, ключи и сохранённые prompts остаются. Ошибка возникает из-за ссылок на старую модель.

Почему Vertex AI всё ещё падает после rename?
Наиболее вероятная причина -- location. Сейчас документация требует global.

Можно просто перейти на gemini-3-pro-image-preview?
Нет, если только ваш workflow не связан с генерацией изображений.

Что делать, если я не хочу ещё одну preview-зависимость?
Используйте gemini-2.5-pro как более стабильный fallback.

Итог

gemini-3-pro-preview not found больше не является расплывчатой проблемой. С 9 марта 2026 года старая модель отключена, поэтому главный фикс -- перестать её вызывать. Если вам нужен официальный преемник, переходите на gemini-3.1-pro-preview. Если приоритет -- стабильность, используйте gemini-2.5-pro. И если Vertex AI всё ещё падает даже после rename, сначала проверьте GOOGLE_CLOUD_LOCATION=global.