Veo 3.1 API: отключение старых моделей, переход на Gemini Omni и стоимость интеграции

Если ваше приложение вызывает Veo 3.1 через Gemini API, самая важная новость сейчас — назначенная на 22 октября 2026 года возможная дата отключения предварительных моделей Veo 3.1. Разработчикам нельзя просто продолжать отправлять запросы на старые model ID и ждать прежнего поведения. Google рекомендует переход на Gemini Omni Flash (gemini-omni-1.1-flash) либо на стабильные модели через Gemini Enterprise Agent Platform, если это соответствует вашей инфраструктуре.

Новичку, которому нужен не программный интерфейс, а создание роликов вручную, лучше использовать инструкцию по Google Veo 3.1 в Flow. Здесь рассматривается именно работающая интеграция через API.

Какие модели затронуты

Источник — официальный перечень deprecations Google. Объявление касается Gemini API preview endpoint; оно не означает автоматического закрытия всех версий Veo в потребительском Google Flow. Для Flow есть отдельная таблица поддерживаемых моделей.

Почему недостаточно заменить имя модели одной строкой

Старый код Veo использовал отдельный процесс видеогенерации, специфические поля модели, асинхронное ожидание результата и ограничения на типы входов. Gemini Omni Flash работает через Interactions API и позволяет вести последовательное редактирование и мультимодальную работу с контекстом. Различаются формат ответа, параметры разрешения, работа с изображениями и правила безопасности. При миграции сначала проверьте бизнес-функции, а затем переписывайте клиент.

Первый видеозапрос к Gemini Omni Flash на Python

Установите актуальный официальный SDK google-genai, настройте API-ключ в переменной окружения, включите подходящий биллинг и убедитесь, что модель доступна вашему проекту. Ниже — пример по документации Google Gemini Omni:

import base64
from google import genai

client = genai.Client()

response = client.interactions.create(
    model="gemini-omni-1.1-flash",
    input=(
        "A ceramic mug on a wooden table at sunrise. "
        "Slow cinematic camera push-in, realistic steam, "
        "quiet room ambience, no text."
    ),
    response_format={
        "type": "video",
        "aspect_ratio": "16:9"
    }
)

with open("result.mp4", "wb") as output:
    output.write(base64.b64decode(response.output_video.data))

Этот пример относится к Omni, а не к старому endpoint Veo. Не вставляйте API-ключ прямо в исходный код или публичный репозиторий. В промышленном приложении добавьте обработку исключений, проверку наличия output_video, ограничения времени ожидания, логирование затрат и политику повторных попыток.

Список проверок при миграции

1. Найдите в коде и конфигурации все три старых ID Veo 3.1, включая тестовые и фоновые задания.
2. Зафиксируйте поддерживаемые функции текущего приложения: текст в видео, первый кадр, конечный кадр, продление, аудио, 9:16.
3. Определите, какой из доступных продуктов Google обеспечивает каждую функцию. Не считайте функции разных API взаимозаменяемыми.
4. Перепишите отправку запросов и получение файла согласно Interactions API или корпоративному API.
5. Протестируйте одинаковые референсы и запросы: длина, разрешение, стабильность персонажа, качество аудио.
6. Добавьте лимиты расходов, ретраи с backoff, логирование модельных версий и проверку региональных правил.
7. Переключите продакшн-поток после тестирования и удалите зависимость от preview ID.

Что учитывать в стоимости

Исторически для Veo 3.1 preview Google приводила тариф за секунду итогового видео, и бесплатный API-уровень для этих моделей не предоставлялся. Однако после прекращения preview цены и способы тарификации выбранной замены будут другими. Перед запуском расчитайте месячный бюджет заново: средняя длина ролика, количество повторных генераций, редакционные тесты, исходные файлы, разрешение и выбранная платформа.

Если вам нужен не API, а стоимость генерации в интерфейсе Flow, используйте сравнение кредитов и тарифов. Если задача — выбрать между возможностями моделей, поможет Veo или Gemini Omni.

Общие проблемы после перехода

Новая модель отвечает в другом формате. Проверьте объект результата Interactions API и наличие видео перед декодированием.

Не воспроизводится старый кадр. Перенесите исходные изображения и условия формата по новой схеме; старые параметры Veo могут не поддерживаться.

Не удаётся редактировать загруженное видео. Проверьте ограничения страны, продукта и типа контента. Не всякая функция разрешена в любом регионе.

Если генерация используется в клиентском бизнес-процессе, заранее согласуйте миграцию с ответственными за безопасность материалов и права: см. план применения Veo в компании.

Практика миграции работающего продукта

План перехода для работающего продукта

Начните с инвентаризации. Найдите все старые идентификаторы в конфигурации приложения, фоновых задачах, тестах, очередях и примерах кода для команды. Затем сохраните набор эталонных входов, на которых можно сравнить новую модель со старой: один текстовый запрос, один исходный кадр, один запрос с речью и один вертикальный формат. Без таких эталонов после миграции сложно понять, исправлена ли техническая проблема или модель просто стала выдавать другие художественные решения.

Проверка формата ответа

В примере Interactions API видео возвращается в виде кодированных данных, которые SDK предоставляет через output_video. Не предполагайте, что поле присутствует при любом исходе. Если запрос завершается ошибкой модерации, квоты или биллинга, результат может не содержать видео. В промышленном коде проверяйте завершённость взаимодействия, наличие видеоданных и тип результата, а затем только декодируйте и сохраняйте файл.

Что делать с повторными запросами

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

Как организовать учёт расходов

Логируйте модель, длительность, выходное разрешение, статус генерации, число попыток и итоговую стоимость по данным платформы. Не используйте потребительские кредиты Google Flow как основание для расчёта цены вызова Gemini API: это разные продукты и биллинговые схемы. У Veo preview действовала плата за секунды видео; для Gemini Omni и корпоративных решений нужен новый расчёт по актуальной странице цен.

Защита ключей и клиентских материалов

Храните API-ключи в секрет-хранилище или переменных окружения сервера, не в браузерном JavaScript публичной страницы. Ограничивайте доступ сотрудников, не записывайте чувствительные входы в общедоступные логи и определяйте срок хранения загруженных фото и видео. Если компания работает с клиентскими материалами, проверьте условия передачи данных конкретному продукту Google, региональные требования и договорные обязательства.

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

Даже успешный запрос на gemini-omni-1.1-flash не означает, что все прежние приёмы Veo доступны в новом API без изменений. Первый и последний кадры, референсы, продление, разрешение и редактирование могут иметь другую структуру входов. Создайте список функций, которым пользуются реальные клиенты, и протестируйте каждую на новом интерфейсе. При несовместимости используйте отдельный рабочий процесс, а не автоматически удаляйте функцию из продукта.

Как проверить запуск после перехода

1. Текстовый запрос выдаёт корректный mp4 с нужным разрешением.
2. Запрос с изображением использует предоставленный объект, не заменяя его произвольно.
3. Вертикальный формат 9:16 действительно воспроизводится на целевых устройствах.
4. Ошибки квоты и недоступности модели корректно обрабатываются.
5. Пользователь видит статус ожидания без ложного обещания, что видео готово.
6. Отчёт об использовании позволяет связать расход с конкретным заданием.

Что делать с устаревшими инструкциями в интернете

Если руководство рекомендует старые ID veo-3.1-*-preview без предупреждения о запланированном отключении не ранее 22 октября 2026 года, его нельзя использовать для нового проекта без обновления. Сверяйте дату документации и наличие раздела deprecations, даже если пример кода выглядит корректным. Для потребительского Flow эти советы не применяются напрямую, потому что интерфейс поддерживает собственный набор моделей и функций.

Вывод

Если ваша интеграция зависит от preview Veo 3.1, миграцию следует подготовить к объявленной дате — не ранее 22 октября 2026 года. Для нового проекта начинайте с документации действующей модели, а не с примера кода для endpoint, который уже выводится из эксплуатации.