Gemini API ilə memarlıq videolarının təhlili: addım-addım bələdçi

Bu bələdçidə nələri öyrənəcəksiniz?

Layihə videosunda hansı məkanların göründüyünü müəyyənləşdirmək, təqdimat qeydini qısa xülasəyə çevirmək və ya konkret bir saniyədə nə baş verdiyini soruşmaq üçün Gemini API-dən istifadə etmək olar. Google-un video anlama bələdçisində videonu təsvir etmək, məzmundan məlumat çıxarmaq və zaman işarələrinə əsasən sualları cavablandırmaq kimi istifadə üsulları göstərilir.

Bu təlimat memarlıq vizuallaşdırması (archviz), interyer dizaynı və layihə təqdimatlarında istifadə olunan hazır videoların təhlilinə yönəlib. Video yaratmaqdan fərqli olaraq, burada giriş əvvəlcədən hazırlanmış video faylı və ya ictimai YouTube videosudur. Nəticələr verilən sualdan asılı olaraq xülasə və ya konkret detallara dair cavablar ola bilər.

Tələblər və video seçimi

Google-un Gemini API sənədindəki nümunələr Python, JavaScript, Java, Go və REST üsullarını əhatə edir. Python nümunələrində google-genai kitabxanasından istifadə olunur, lakin bələdçidə bu nümunələr üçün tələb olunan kitabxana versiyası göstərilmir. Buna görə burada versiya nömrəsi verilmir. API-yə giriş və autentifikasiya üçün öz inkişaf mühitinizin API konfiqurasiyasından istifadə etməlisiniz; mənbədə hesab yaratmaq addımları ətraflı izah olunmur.

Videonu göndərməzdən əvvəl faylın ölçüsünü və istifadə qaydasını nəzərə alın:

• Google-un müqayisə cədvəlində Files API üçün ödənişli istifadədə 20 GB, pulsuz istifadədə isə 2 GB yuxarı həddi göstərilir. Bu üsul böyük fayllar, uzun videolar və yenidən istifadə olunacaq fayllar üçün uyğundur.

• Cloud Storage Registration hər fayl üçün 2 GB həddi ilə göstərilir; ümumi yaddaş limiti olmadığı qeyd olunur. Davamlı saxlanacaq və yenidən istifadə ediləcək fayllar üçün seçim kimi təqdim edilir.

• Cədvəldə Inline Data 100 MB-dan kiçik fayllar üçün göstərilir. Bununla belə, həmin bələdçi ümumi sorğunun 20 MB-dan az olduğu qısa videoları birbaşa sorğuya əlavə etməyi uyğun hesab edir. Buna görə üsul seçərkən yalnız video faylının deyil, sorğunun ümumi ölçüsünü də nəzərə alın.

• İctimai YouTube videoları da giriş üsulu kimi göstərilir.

Google əksər hallarda, xüsusən də 100 MB-dan böyük və ya müxtəlif sorğularda yenidən istifadə ediləcək videolar üçün Files API-ni tövsiyə edir. Sənəddə həmçinin ümumi sorğunun ölçüsü 20 MB-ı keçirsə, video uzundursa və ya eyni fayl bir neçə sorğuda istifadə olunacaqsa, Files API-dən istifadə etmək məsləhət görülür.

Video təhlili: addım-addım

1. Təhlilin məqsədini müəyyənləşdirin. “Videonu xülasə et” kimi ümumi sorğu əvəzinə, sizə hansı məlumatın lazım olduğunu yazın. Məsələn, məkanların ardıcıllığı, kadrlarda görünən material və işıqlandırma dəyişiklikləri, yaxud təqdimatda izah olunan dizayn qərarları barədə ayrıca suallar verə bilərsiniz. Modeldən videoda olmayan məlumatları çıxarmasını istəməkdənsə, cavabı görüntüdəki və ya nitqdəki sübutlara əsaslandırmasını bildirin.

2. Ötürmə üsulunu seçin. Kiçik və yalnız bir dəfə istifadə olunacaq klip üçün inline məlumatdan yararlanmaq olar; böyük, uzun və ya təkrar istifadə ediləcək videolar üçün Files API daha münasib seçimdir. Faylı yüklədikdən sonra emal olunmasını gözləməyi unutmayın: Google-un nümunələrində faylın statusu ACTIVE olana qədər yoxlanılır. Nümunədə fayl emalının uğursuz olması ehtimalı da nəzərə alınıb.

3. Sorğuya video və mətn girişini birlikdə əlavə edin. Bələdçinin nümunələrində video girişi fayl URI-si və MIME növü ilə, mətn girişi isə təhlil təlimatı ilə ötürülür. Nümunələrdə model adı kimi gemini-3.8-flash istifadə olunub. API sənədindəki model və əlçatanlıq məlumatlarını öz tətbiqiniz üçün yoxlayın; burada nümunədəki addan başqa versiya və ya əlçatanlıq zəmanəti nəzərdə tutulmur.

Aşağıdakı mətni video girişinin yanında mətn təlimatı kimi istifadə edə bilərsiniz:

Bu memarlıq layihəsi videosunu qısa şəkildə xülasə et. Görünən məkanları videoda göstərilmə ardıcıllığı ilə sadala. Videoda açıq şəkildə görünməyən xüsusiyyətləri təxmin etmə; əmin olmadığın detalları qeyd et.

Bu sorğu layihə qeydini nizamlı xülasəyə çevirməyə kömək edir. Nəticələrdən təqdimat qeydi və ya komandanın ilkin baxışı üçün istifadə etməzdən əvvəl onları görüntü ilə tutuşdurun.

1. Konkret araşdırma sualı verin. Gemini modelləri video məzmunu ilə bağlı sualları cavablandıra və zaman işarələrinə istinad edə bilir. Lövhə təqdimatında və ya kamera turunda vacib hissəni tapmaq üçün sualı məkan və ya hadisə əsasında dəqiqləşdirin:

Videoda mətbəx məkanının ilk dəfə göründüyü anı tap. Zaman işarəsini ver və həmin anda görünən sabit avadanlıqları yalnız görüntüdə seçilə bildikləri qədər təsvir et.

Bu sorğu konkret məkanı tapmağa yönəlib. Zaman işarəsini montaj və ya təqdimat axınında yoxlayın; mənbə bələdçisi nəticələrin hər zaman qüsursuz olacağına zəmanət vermir.

1. Material və işıq müşahidələrini ayrıca istəyin. Tək bir geniş sualda çoxlu detal istəmək əvəzinə, təhlili başlıqlara bölmək cavabı qiymətləndirməyi asanlaşdırır:

Bu interyer videosunda görünən səth və material xüsusiyyətlərini ardıcıllıqla təsvir et. Hər müşahidəni uyğun zaman işarəsi ilə əlaqələndir; materialın növü dəqiq seçilmirsə, təxmin kimi təqdim etmə.

Bu sorğu görüntüdəki səthləri təsvir etməyə yönəlib; modeldən dəqiq məhsul və ya material markası çıxarmasını istəmir. Dizayn qərarı verməzdən əvvəl real layihə sənədlərini əsas götürün.

1. Cavabı qısa yoxlama siyahısına çevirin. Təqdimat videosunda komandanın izləməli olduğu məqamlar varsa, modeldən videoda həqiqətən yer alan məlumatları ayırmasını istəyin:

Bu layihə təqdimatında açıq şəkildə bildirilən dizayn qərarlarını və cavabsız qalan sualları iki ayrı siyahıda xülasə et. Hər bəndi dəstəkləyən zaman işarəsini əlavə et; videoda cavabı olmayan məqamları boşluqları doldurmadan qeyd et.

Belə nəticə görüşdən sonrakı qeydləri nizamlamağa kömək edə bilər. Vacib qərarları görüş qeydi və ya layihə sənədləri ilə yoxlayın.

Tez-tez edilən səhvlər

Faylı yanlış üsulla göndərmək: Inline Data üçün sənəddəki cədvəldə 100 MB-dan kiçik fayllar göstərilsə də, həmin bələdçi inline istifadəsini ümumi sorğunun 20 MB-dan az olduğu qısa videolarla məhdudlaşdırır. Böyük fayllar və uzun videolar üçün Files API tövsiyəsinə əməl edin.

Fayl hazır olmadan təhlilə başlamaq: Google-un nümunələrində yükləmədən sonra emal statusu yoxlanılır və fayl ACTIVE olana qədər gözlənilir. Bu addım tamamlanmadan növbəti sorğuya keçməyin.

Görüntüdən dəqiq olmayan məlumat çıxarmaq: Səthin real materialı, ölçüsü və ya məhsul adı videoda görünməyə bilər. Sorğuda yalnız görünən dəlilləri istəmək və qeyri-müəyyənliyi açıq şəkildə bildirməyi tələb etmək yanlış əminlik riskini azaldır.

Video təhlilini video yaratmaqla qarışdırmaq: Gemini API-nin video yaratma səhifəsində Veo 3.1 Preview-ın 22 oktyabr 2026-cı ildə dayandırıldığı və video yaratmaq üçün Gemini Omni Flash-a yönləndirmə edildiyi bildirilir. Bu dəyişiklik hazırkı videonu təhlil etmək üçün təsvir olunan addımlarla eyni əməliyyat deyil.

Memarlıq və vizuallaşdırma iş axınında istifadə

Bu yanaşma layihə təqdimatlarını, interyer kamera turlarını və ya tikinti sahəsinin qeydlərini tez nəzərdən keçirmək istəyən memarlıq ofisləri, interyer dizaynerləri və vizuallaşdırma komandaları üçün başlanğıc nöqtəsi ola bilər. Məsələn, videoda hansı məkanın nə vaxt göründüyünü tapmaq, görüş qeydindən dizayn qərarlarını toplamaq və ya təqdimatın ilkin xülasəsini hazırlamaq mümkündür. Lakin mənbələr modelin BIM fayllarını, çertyojları və ya 3D səhnələri birbaşa təhlil etdiyini bildirmir; burada söhbət video məzmunu ilə işləməkdən gedir.

İş axınını qurmazdan əvvəl fayl ölçüsünə, müddətinə və yenidən istifadə ehtiyacına əsasən ötürmə üsulunu müəyyənləşdirin. Böyük və ya uzun qeydlər üçün Files API nəzərdə tutulub; mənbədə ödənişli və pulsuz istifadə üçün fərqli fayl limitləri göstərilir. Bu bələdçi qiymət, layihənin məxfiliyi, saxlama müddəti və ya konkret iş stansiyası üçün tələb olunan avadanlıq barədə məlumat vermir; bunları öz istifadə şərtlərinizə əsasən ayrıca qiymətləndirin.

Növbəti addımlar

İlk sınağı kritik qərarlar ehtiva etməyən qısa layihə qeydi ilə edin. Əvvəlcə ümumi xülasə istəyin, sonra konkret məkan və ya zaman işarəsinə yönələn suallarla nəticəni yoxlayın. Cavablarda görünən sübutla modelin şərhini bir-birindən ayırın; komanda daxilində paylaşılacaq qeydləri mənbə video və layihə sənədləri ilə tutuşdurun. Eyni videonu bir neçə sorğuda istifadə edəcəksinizsə, Google-un Files API tövsiyəsini nəzərə alın.

Mənbə və lisenziya

Bu bələdçi Google-un Gemini API “Video understanding” və “Video generation in the Gemini API” təlimatları əsasında Azərbaycan dilinə uyğunlaşdırılıb. Hər iki səhifədə başqa cür qeyd edilmədiyi təqdirdə, məzmun üçün CC BY 4.0 lisenziyası göstərilir.