Коротко
- Модели Gemini могут кратко пересказывать видео, отвечать на вопросы о его содержании и ссылаться на конкретные временные метки.
- Для файлов размером более 100 МБ или файлов, которые будут использоваться повторно, Google рекомендует Files API.
- Небольшие видео можно прикреплять непосредственно к запросу; в руководстве этот способ ограничен случаями, когда общий размер запроса не превышает 20 МБ.
- Veo 3.1 Preview был отключён в Gemini API 22 октября 2026 года; это руководство посвящено анализу уже существующих видео, а не их созданию.
Что вы узнаете из этого руководства?
Gemini API можно использовать, чтобы определить, какие помещения показаны в видео проекта, превратить запись презентации в краткое содержание или спросить, что происходит в определённую секунду. В руководстве Google по пониманию видео описаны такие сценарии, как описание ролика, извлечение информации из его содержания и ответы на вопросы с учётом временных меток.
Руководство посвящено анализу уже готовых видео, используемых в архитектурной визуализации (archviz), дизайне интерьеров и презентациях проектов. В отличие от генерации видео, на вход здесь подаётся заранее подготовленный видеофайл или общедоступное видео на YouTube. В зависимости от заданного вопроса ответ может быть кратким пересказом или содержать сведения о конкретных деталях.
Что потребуется и как выбрать видео
Примеры в документации Google Gemini API охватывают Python, JavaScript, Java, Go и REST. В примерах на Python используется библиотека google-genai, однако в руководстве не указана необходимая для этих примеров версия библиотеки. Поэтому здесь номер версии не приводится. Для доступа к API и аутентификации используйте настройки API в своей среде разработки; исходный материал не описывает подробно создание учётной записи.
Перед отправкой видео оцените размер файла и то, как планируете его использовать:
В сравнительной таблице Google для Files API указан предел в 20 ГБ при платном использовании и 2 ГБ при бесплатном. Этот способ подходит для больших файлов, длинных видео и файлов, которые будут использоваться повторно.
Для Cloud Storage Registration указан предел в 2 ГБ на файл; при этом общий лимит хранилища не установлен. Этот вариант предназначен для постоянного хранения файлов и их повторного использования.
В описании Inline Data в таблице указаны файлы размером менее 100 МБ. Однако в том же руководстве говорится, что напрямую добавлять к запросу целесообразно короткие видео, если общий размер запроса не превышает 20 МБ. Поэтому при выборе метода учитывайте не только размер видео, но и общий размер запроса.
В качестве входных данных также можно использовать общедоступные видео на YouTube.
Для большинства сценариев Google рекомендует Files API, особенно если размер видео превышает 100 МБ или файл планируется использовать в разных запросах. В документации также советуют использовать Files API, если общий размер запроса превышает 20 МБ, видео длинное или один и тот же файл будет использоваться в нескольких запросах.
Пошаговый анализ видео
Определите цель анализа. Вместо общего запроса вроде «Кратко перескажи видео» укажите, какая именно информация нужна. Например, можно отдельно спросить о последовательности помещений, изменениях материалов и освещения в кадре или дизайнерских решениях, описанных в презентации. Попросите модель опираться на свидетельства из изображения или повествования, а не делать выводы о том, чего нет в видео.
Выберите способ передачи. Для небольшого ролика, который будет обработан один раз, можно использовать inline-данные; для большого, длинного или предназначенного для повторного использования видео лучше подойдёт Files API. Не пропускайте загрузку файла и ожидание его обработки: в примерах Google статус файла проверяется, пока он не станет
ACTIVE. В примерах также учитывается вероятность сбоя обработки файла.Добавьте видео и текстовый ввод в один запрос. В примерах из руководства видео передаётся как URI файла с MIME-типом, а текстовый ввод содержит инструкции для анализа. В качестве имени модели в примерах используется
gemini-3.8-flash. Проверьте сведения о моделях и их доступности в документации API для своего приложения; кроме имени, указанного в примере, здесь не предполагаются гарантии версии или доступности.
В качестве текстовой инструкции рядом с видео можно использовать следующий запрос:
Bu mimari proje videosunu kısa bir özette anlat. Görünen mekânları videoda izlendikleri sırayla listele. Videoda açıkça görülmeyen özellikleri tahmin etme; emin olmadığın ayrıntıları belirt.Этот запрос поможет превратить запись проекта в структурированное краткое содержание. Прежде чем использовать результат в заметках к презентации или для первичного внутреннего обзора, сверьте его с видео.
Задайте конкретный вопрос для проверки. Модели Gemini могут отвечать на вопросы о содержании видео и указывать временные метки. Чтобы найти важный фрагмент презентации планшета или виртуального тура, сформулируйте вопрос, привязав его к помещению или событию:
Videoda mutfak mekânının ilk göründüğü zamanı bul. Zaman damgasını ver ve o anda görülebilen sabit donatıları, yalnızca görüntüde seçilebildikleri ölçüde açıkla.Этот запрос помогает найти конкретное помещение. Проверьте временную метку в монтаже или последовательности презентации: исходное руководство не гарантирует безошибочность результатов во всех случаях.
Запросите отдельные наблюдения о материалах и свете. Вместо того чтобы задавать один широкий вопрос о множестве деталей, разбейте анализ на отдельные темы — так ответы будет проще оценить:
Bu iç mekân videosunda görülebilen yüzey ve malzeme özelliklerini sıralı biçimde açıkla. Her gözlemi ilgili zaman damgasıyla eşleştir; malzeme türü kesin seçilemiyorsa bunu tahmin olarak sunma.Этот запрос сосредоточен на описании поверхностей в кадре и не просит модель определить точную марку продукта или материала. При принятии дизайнерских решений ориентируйтесь на документацию по реальному проекту.
Преобразуйте ответ в краткий контрольный список. Если из видео презентации нужно извлечь пункты для дальнейшей работы команды, попросите модель отделить сведения, которые действительно прозвучали в видео:
Bu proje sunumunda açıkça belirtilen tasarım kararlarını ve çözümsüz bırakılan soruları iki ayrı listede özetle. Her maddeyi destekleyen zaman damgasını ekle; videoda yanıtı olmayan noktaları boşlukları doldurmadan belirt.Такой результат может пригодиться при подготовке заметок после встречи. Важные решения сверьте с записью встречи или проектной документацией.
Распространённые ошибки
Неподходящий способ передачи файла: хотя в таблице документации для Inline Data указаны файлы размером менее 100 МБ, в том же руководстве прямое использование inline ограничено короткими видео, если общий размер запроса не превышает 20 МБ. Для больших файлов и длинных видео следуйте рекомендации использовать Files API.
Запуск анализа до готовности файла: в примерах Google после загрузки проверяется статус обработки, и система ждёт, пока файл не станет ACTIVE. Не переходите к следующему запросу, пока этот шаг не завершён.
Попытка определить по изображению то, чего нельзя установить точно: реальный материал поверхности, размеры или название продукта могут быть не видны в видео. Просите указывать только наблюдаемые признаки и явно отмечать неопределённость — это снижает риск ложной уверенности.
Путаница между анализом и созданием видео: на странице Google о генерации видео указано, что Veo 3.1 Preview был отключён 22 октября 2026 года, а для создания видео предлагается использовать Gemini Omni Flash. Это изменение не относится к описанному здесь анализу уже существующих видео.
Применение в архитектурных и визуализационных рабочих процессах
Этот подход может стать отправной точкой для архитектурных бюро, дизайнеров интерьеров и команд визуализации, которым нужно быстро просмотреть презентации проектов, видеотуры по интерьерам или записи со стройки. Например, можно найти, когда в видео появляется то или иное помещение, собрать дизайнерские решения из записи встречи или подготовить краткий первый пересказ презентации. Однако в источниках не говорится, что модель напрямую анализирует BIM-файлы, чертежи или 3D-сцены; здесь описана работа с видеоконтентом.
Прежде чем настраивать рабочий процесс, выберите способ передачи с учётом размера и длительности файла, а также того, понадобится ли использовать его повторно. Для больших или длинных записей рекомендуется Files API; для платного и бесплатного использования в источнике указаны разные ограничения на размер файлов. В руководстве нет сведений о стоимости, конфиденциальности проекта, сроке хранения или оборудовании, необходимом для конкретной рабочей станции. Эти условия следует отдельно оценить с учётом вашего сценария использования.
Дальнейшие шаги
Для первого теста возьмите короткую запись проекта, в которой нет критически важных решений. Сначала попросите составить общее резюме, а затем проверьте результат вопросами о конкретных помещениях или временных метках. Отделяйте видимые свидетельства от интерпретаций модели; заметки, которыми планируете делиться с командой, сверяйте с исходным видео и проектной документацией. Если один и тот же ролик будет использоваться в нескольких запросах, учитывайте рекомендацию Google использовать Files API.
Источник и лицензия
Это руководство адаптировано на турецкий язык на основе руководств Google Gemini API «Video understanding» и «Video generation in the Gemini API». Если не указано иное, на обеих страницах для материалов обозначена лицензия CC BY 4.0.
Источники
Источников: 2Тексты источников не перепечатываются; короткие цитаты отмечены, остальное — наш пересказ и комментарий.
Для архитектурных бюро и студентов самое практичное применение — не просматривать длинную презентацию или видеоэкскурсию по интерьеру целиком, а сначала найти нужные фрагменты и основные решения. Такой предварительный обзор особенно полезен для видео с записями встреч и презентациями проектов; при этом результат модели не заменяет фиксацию проектных решений.
Перед использованием в Турции важно проверить ограничения на передачу файлов и различия между платным и бесплатным тарифами. В источниках не раскрываются цены, условия конфиденциальности и требования к специализированному оборудованию. Поэтому перед загрузкой видео с конфиденциальными проектами командам следует отдельно оценить внутренние правила работы с данными и условия API.
Частые вопросы
Может ли Gemini API анализировать архитектурные видео?
Модели Gemini могут кратко пересказывать видео, отвечать на вопросы о его содержании и ссылаться на конкретные временные метки. Результат зависит от переданных модели видео и текста.
Какой способ использовать для загрузки видео в Gemini API?
Для больших или длинных видео, а также файлов, которые будут использоваться повторно, Google рекомендует Files API. Небольшие видео можно прикреплять непосредственно к запросу; в руководстве для этого способа рекомендуется, чтобы общий размер запроса не превышал 20 МБ.
Доступен ли Veo 3.1 Preview в Gemini API?
Согласно руководству Google, Veo 3.1 Preview был отключён в Gemini API 22 октября 2026 года. Это изменение касается генерации видео; понимание видео рассматривается в отдельном руководстве.
