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

> Видите gemini-3-pro-preview not found или 404 NOT_FOUND? Gemini 3 Pro Preview был отключён 9 марта 2026 года. Ниже -- правильная замена, фикс для Vertex AI и готовые примеры миграции.

- Source: https://www.aifreeapi.com/ru/posts/gemini-3-pro-preview-not-found
- Language: ru
- Published: 2026-03-19
- Updated: 2026-03-19
- Publisher: AI Free API (https://www.aifreeapi.com)

Если вы видите `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 | Вы всё ещё вызываете отключённый ID модели | Замените его на `gemini-3.1-pro-preview` |
| Старый prompt в AI Studio внезапно не работает | Сохранённый prompt всё ещё привязан к старой модели | Откройте prompt и смените модель на `gemini-3.1-pro-preview` |
| Vertex AI падает даже после rename | Вы изменили имя модели, но не location | Установите `GOOGLE_CLOUD_LOCATION=global` |
| Wrapper продолжает показывать старую ошибку | Где-то осталась скрытая ссылка на старый ID | Выполните поиск по `gemini-3-pro-preview` |
| Вы не хотите ещё одну preview-зависимость | Нужен более стабильный путь с Pro-моделью | Используйте `gemini-2.5-pro` |
| Вы думаете перейти на `gemini-3-pro-image-preview` | Это image-модель, а не замена текстового Pro | Не делайте так, если ваш workflow не про генерацию изображений |

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

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

![Таймлайн, показывающий последовательность событий в феврале и марте 2026 года, приведшую к отключению Gemini 3 Pro Preview](https://www.aifreeapi.com/posts/ru/gemini-3-pro-preview-not-found/img/shutdown-migration-timeline.png)

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

| Дата | Что изменилось | Почему это важно |
|---|---|---|
| 19 февраля 2026 | Google выпустил [`gemini-3.1-pro-preview`](https://ai.google.dev/gemini-api/docs/changelog) | Появился преемник старой Pro Preview-линии |
| 26 февраля 2026 | Google объявил, что [`gemini-3-pro-preview` будет отключён 9 марта 2026](https://ai.google.dev/gemini-api/docs/changelog) | Началась официальная миграция |
| 6 марта 2026 | В [официальной теме форума](https://discuss.ai.google.dev/t/migrate-from-gemini-3-pro-preview-to-gemini-3-1-pro-preview-before-march-9-2026/127062) Google предупредил пользователей `-latest` aliases о переходе на 3.1 | Некоторые инструменты начали вести себя иначе ещё до финального выключения |
| 9 марта 2026 | На странице [deprecations](https://ai.google.dev/gemini-api/docs/deprecations) модель отмечена как отключённая, а в [release notes](https://ai.google.dev/gemini-api/docs/changelog) объяснён переход к 3.1 | После этой даты старый ID уже не является безопасной целью |

Текущая [страница моделей](https://ai.google.dev/gemini-api/docs/models) прямо показывает предупреждение: 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`

![Таблица решений, сравнивающая Gemini 3.1 Pro Preview как прямого преемника и Gemini 2.5 Pro как более стабильный fallback](https://www.aifreeapi.com/posts/ru/gemini-3-pro-preview-not-found/img/replacement-decision-board.png)

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

| Если ваша цель... | Используйте | Почему |
|---|---|---|
| Остаться на официальной линии-преемнике Gemini 3 Pro | `gemini-3.1-pro-preview` | Это прямая замена, которую указывает Google |
| Вернуть рабочую Pro-модель с меньшим риском preview | `gemini-2.5-pro` | Это более консервативный и стабильный fallback |
| Работать с генерацией/редактированием изображений | `gemini-3-pro-image-preview` или другая image-модель | Это отдельная продуктовая линия |

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

- Если вы брали 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](/ru/posts/gemini-3-1-pro-vs-gemini-2-5-pro).

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

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

| Имя модели | Что это такое | Когда использовать |
|---|---|---|
| `gemini-3-pro-preview` | Старая отключённая текстовая Pro Preview-модель | Больше не использовать |
| `gemini-3.1-pro-preview` | Текущий preview-преемник | Использовать, если нужен путь Gemini 3 Pro |
| `gemini-2.5-pro` | Активный fallback класса Pro | Использовать, если приоритет -- стабильность |
| `gemini-3-pro-image-preview` | Image-модель 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](https://docs.cloud.google.com/vertex-ai/generative-ai/docs/start/get-started-with-gemini-3) говорит, что `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"
```

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

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

| Шаг | Что проверить | Почему именно в таком порядке |
|---|---|---|
| 1 | Заменить `gemini-3-pro-preview` на `gemini-3.1-pro-preview` или `gemini-2.5-pro` | Сначала нужно убрать отключённую модель |
| 2 | Найти все старые ссылки в коде и конфигурации | Одного скрытого default достаточно, чтобы ошибка осталась |
| 3 | Для Vertex AI выставить `GOOGLE_CLOUD_LOCATION=global` | Это самый частый второй сбой после rename |
| 4 | Перепроверить на минимальном запросе | Так вы подтверждаете сам факт успешной миграции |
| 5 | Обновить prompts AI Studio, screenshots и runbooks | Чтобы старая конфигурация не вернулась позже |
| 6 | Сравнить 3.1 Preview и 2.5 Pro на реальных задачах | Чтобы решить, стоит ли повышать 3.1 до default |

Практическая ценность этого порядка в том, что он отделяет сам факт отключения модели от последующих ошибок конфигурации. Сначала вы убираете старый 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 ошибки остались

![Дерево решений, показывающее, что проверять, если ошибки продолжаются после переименования Gemini 3 Pro Preview на актуальную модель](https://www.aifreeapi.com/posts/ru/gemini-3-pro-preview-not-found/img/post-migration-troubleshooting-map.png)

Если вы уже переименовали модель, не стоит продолжать считать все последующие ошибки тем же самым `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](/ru/posts/gemini-api-error-troubleshooting-guide).

Ещё один практический совет: после таких отключений полезно обновить не только код, но и все операционные артефакты вокруг него. Если в 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](/ru/posts/gemini-3-1-pro-timeout-fix).

На практике многие команды делают это поэтапно: сначала возвращают работоспособность на `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`.