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

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

Gemini API videolardan məlumat çıxarmaq və video məzmunu ilə bağlı sualları cavablandırmaq üçün istifadə oluna bilər. Bu bələdçi memarlıq layihəsinin təqdimatı, tikinti sahəsinin çəkilişi və ya məkan turu kimi videoları təhlil etmək üçün uyğun ötürmə üsulunu seçmək, faylın emalını gözləmək və məqsədəuyğun sorğular hazırlamaq addımlarını əhatə edir. Gemini modelləri videonu təsvir edə, məzmundan məlumat çıxara və konkret vaxt nişanlarına istinad edə bilər. Beləliklə, uzun çəkilişə başdan sona əl ilə baxmaq əvəzinə, nəzərdən keçirmək üçün xülasə və ya konkret suala cavab istəmək mümkündür.

Buradakı nümunələr video yaratmağa deyil, mövcud videonu anlamağa yönəlib. Google-ın video yaratma bələdçisində bu iş üçün Gemini Omni Flash göstərilir; videonu anlama isə ayrıca istifadə sahəsidir. Bu fərqi nəzərə almaq təhlil sorğusunda yanlış modelə və ya iş axınına yönəlmək riskini azaldır.

Tələblər

Bu iş axını üçün Gemini API-yə giriş, video faylı və ya hamı üçün açıq YouTube videosu, eləcə də mətn sorğusu lazımdır. Rəsmi nümunədə Python klienti google-genai, Files API və Interactions API istifadə olunur. Mənbədə konkret SDK versiyası və ya hesab yaratmaq mərhələsi göstərilmədiyinə görə burada versiya nömrəsi və qeydiyyat şərti verilmir. API klientinin autentifikasiyasını mühitinizə uyğun tamamlayın; mənbədəki REST nümunəsi GEMINI_API_KEY dəyişənindən istifadə edir.

Ötürmə üsulunu faylın həcminə və təkrar istifadə ehtiyacına əsasən seçin:

• Files API: Mənbə 100 MB-dan böyük fayllar, uzun videolar və təkrar istifadə ediləcək məzmun üçün bu üsulu tövsiyə edir. Sənəddə tutum ödənişli istifadə üçün 20 GB, pulsuz istifadə üçün isə 2 GB göstərilir.

• Cloud Storage Registration: Hər fayl üçün 2 GB həddi olduğu, yaddaş həcminə isə məhdudiyyət qoyulmadığı bildirilir; bu üsul böyük, uzun müddət saxlanacaq və təkrar istifadə ediləcək məzmunlar üçündür.

• Birbaşa əlavə edilən məlumat: Sənəddə kiçik fayllar üçün uyğun olduğu bildirilir. Ətraflı təlimat ümumi sorğunun həcmi 20 MB-dan az olan qısa videoları bu üsulla göndərməyi tövsiyə edir; buna görə praktikada daha məhdudlaşdırıcı olan 20 MB həddini əsas götürün.

• YouTube URL-i: Hamı üçün açıq videolar üçün dəstəklənən giriş üsuludur.

Videonun addım-addım təhlili

1. Təhlil məqsədini müəyyənləşdirin

Videonu göndərməzdən əvvəl təhlildən gözlədiyiniz nəticəni dəqiqləşdirin. Layihə təqdimatının ümumi xülasəsini, məkan turunda görünən materialların siyahısını və ya çəkilişdəki konkret anın təsvirini istəyə bilərsiniz. Bir sorğuda çox fərqli nəticələr tələb etməkdənsə, əsas məqsədi və cavab formatını aydın yazın. Modelin videoda olmayan məlumatları özü tamamlamasının qarşısını almaq üçün yalnız çəkilişdə görünənləri bildirməsini də istəyə bilərsiniz.

Məsələn, interyer videosundan qısa və strukturlaşdırılmış müşahidə xülasəsi almaq üçün bu sorğudan istifadə etmək olar:

Analyze this interior architecture video. Summarize the visible spaces, circulation, lighting, and materials. Use only details that can be observed in the video, and organize the response by topic.

Bu sorğu videoda görünən məkan, hərəkət marşrutu, işıqlandırma və materialları ayrı başlıqlar altında qruplaşdırır. Görüntüdə seçilməyən materialın dəqiq adını yazmaq əvəzinə, yalnız müşahidə edilə bilən detallara əsaslanmağı tələb edir.

2. Fayla uyğun ötürmə üsulunu seçin

Video böyükdürsə, uzundursa və ya sonrakı sorğularda yenidən istifadə ediləcəksə, Files API-yə üstünlük verin. Qısa fayl üçün birbaşa əlavə etmə üsulunu seçmək olar; lakin ümumi sorğunun 20 MB-dan az olmasına diqqət edin. Hamı üçün açıq YouTube videosu üçün URL üsulunu nəzərdən keçirin. Göndərməzdən əvvəl fayl həcmini və istifadə şərtlərini yoxlayın; mənbədə tutum məlumatları pulsuz və ödənişli istifadə üçün ayrıca verilir.

3. Files API ilə yükləyin və emalın tamamlanmasını gözləyin

Rəsmi Python nümunəsində fayl client.files.upload vasitəsilə yüklənir və status ACTIVE olana qədər yoxlanılır. Faylın yüklənməsi onun dərhal təhlilə hazır olması demək deyil; emal tamamlanana qədər gözləyin. Aşağıdakı nümunədə status beş saniyəlik fasilələrlə yoxlanılır. Bu kod mənbədəki açıq lisenziyalı nümunəyə əsaslanır:

from google import genai
import time

client = genai.Client()
myfile = client.files.upload(file="path/to/sample.mp4")

while not myfile.state or myfile.state.name != "ACTIVE":
    print("Processing video...")
    time.sleep(5)
    myfile = client.files.get(name=myfile.name)

path/to/sample.mp4 hissəsini təhlil ediləcək faylın yolu ilə əvəz edin. Mənbədəki nümunə fayl istinadı hazır olduqdan sonra həmin istinaddan video girişi kimi istifadə etməyi göstərir. Emal uğursuz olarsa, faylı hazır hesab etməyin; statusun dəyişdiyini təsdiqləyin.

4. Videonu sorğu ilə birlikdə Interactions API-yə göndərin

Fayl ACTIVE statusuna keçdikdən sonra video URI-sini və mətn sorğusunu eyni qarşılıqlı əlaqənin girişlərinə əlavə edin. Mənbədəki nümunədə gemini-3.8-flash model adı istifadə olunur. Aşağıdakı sorğu təqdimat videosunda məkanların ardıcıllığını və keçidləri təhlil etməyə yönəlib:

Review this architectural walkthrough in chronological order. Describe how the spaces connect, identify visible transitions, and refer to relevant moments with timestamps when possible. Do not infer dimensions or design intent that the video does not show.

Vaxt nişanları istəmək müşahidələri çəkilişin konkret hissələri ilə əlaqələndirməyə kömək edir. Modeldən ölçülər və ya dizayn niyyəti kimi videodan təsdiqlənə bilməyən nəticələr çıxarmamasını açıq şəkildə bildirmək cavabı vizual təhlil çərçivəsində saxlayır.

5. Nəticəni layihə işinə uyğun dəqiqləşdirin

İlk cavab ümumi alındısa, videonu yenidən təsvir etmək əvəzinə növbəti sualı konkret mövzuya yönəldin. Gemini-nin video bələdçisi video yaratma kontekstində çoxmərhələli dialoqla düzəlişləri izah edir; videonu anlama sənədində isə videolar barədə suallar vermək və vaxt nişanlarına istinad etmək imkanları göstərilir. Bu təhlil ssenarisində sualı nəzərdən keçirilməli hissə və ya müşahidə növü ilə məhdudlaşdırın.

From the video, list only the visible changes in lighting and material appearance between the main spaces. For each observation, include a timestamp when available and mark anything uncertain as unclear.

Bu sorğu cavabı işıqlandırma və material görünüşündəki dəyişikliklərlə məhdudlaşdırır. “Aydın deyil” kimi işarələmə tələb etmək, görüntü keyfiyyəti zəif olduqda və ya detallar kadrdan kənarda qaldıqda onların dəqiq məlumat kimi təqdim edilməsinin qarşısını almağa kömək edir.

Tez-tez rast gəlinən səhvlər

• Böyük videonu birbaşa əlavə etmək: Mənbənin ətraflı təlimatında ümumi sorğu həcmi 20 MB-dan az olan qısa videoların birbaşa əlavə edilməsi uyğun sayılır. Böyük fayllar üçün Files API-ni nəzərdən keçirin.

• Fayl emal olunmadan təhlil istəmək: Yükləmədən sonra ACTIVE statusunu yoxlayın; nümunədə faylın statusu mütəmadi sorğulanır.

• Geniş və ya qeyri-müəyyən sorğu yazmaq: “Videonu təhlil et” kimi ümumi tapşırıq əvəzinə xülasə, məkan keçidləri və ya görünən materiallar kimi bir məqsədə fokuslanın.

• Görüntüdə olmayan məlumatları gözləmək: Videonu anlama məzmundakı vizual məlumatları təhlil etmək üçündür; çəkilişdə görünməyən layihə ölçülərini və ya dizayn qərarlarını təsdiqlədiyi güman edilməməlidir.

• Video yaratma bələdçisini təhlil bələdçisi ilə qarışdırmaq: Mövcud videonu anlamaq üçün videonu anlama sənədlərindən istifadə edin. Google bildirir ki, Veo 3.1 Preview Gemini API-də 22 October 2026-cı ildə dayandırılıb və video yaratmaq üçün Gemini Omni Flash-ə keçid edilir; bu dəyişiklik təhlil addımlarını əvəz etmir.

Memarlıq, interyer dizaynı və archviz iş axınında istifadə

Memarlıq və interyer dizaynı komandaları layihə turu və ya məkan çəkilişindən ilkin müşahidə xülasəsi hazırlamaq, vacib hissələri vaxt nişanları ilə tapmaq və video ilə bağlı sualları cavablandırmaq üçün bu üsulu sınaqdan keçirə bilər. Archviz komandaları da mövcud video təqdimatın məzmunu ilə bağlı sual-cavab iş axınını nəzərdən keçirə bilər. Bununla belə, nəticələr videoda göstərilənlərlə məhdudlaşdırılmalı; ölçülər, texniki uyğunluq və ya layihədə tətbiq imkanları kimi çəkilişlə təsdiqlənməyən məsələlər ayrıca yoxlanılmalıdır.

Files API-nin ödənişli və pulsuz istifadə hədləri fərqli göstərildiyinə görə komandalar layihə faylını göndərməzdən əvvəl onun həcmini və istifadə etdikləri giriş şərtlərini yoxlamalıdır. Mənbədə aparat tələbləri, qiymət təfərrüatları və ya yerli proqram təminatı ilə inteqrasiya izah olunmur; buna görə iş axınının mövcud modelləşdirmə və ya render alətlərinə qoşulduğunu fərz etməyin.

Növbəti addımlar

Əvvəlcə qısa və istifadəsinə icazə verilmiş layihə videosunda xülasə sorğusunu sınayın; sonra vaxt nişanı və ya konkret müşahidə növü tələb edən əlavə suallar verin. Fayl böyükdürsə və ya təkrar istifadə ediləcəksə, Files API üsulunu nəzərdən keçirin. Nəticələri layihə qeydlərinə əlavə etməzdən əvvəl videonu uyğun vaxtlarda açıb modelin müşahidələrini yoxlayın. Fayl yükləmə və ya model seçimi ilə bağlı tətbiq təfərrüatları üçün Gemini API-nin rəsmi videonu anlama və video yaratma sənədlərinə müraciət edin.

Mənbə və lisenziya

Bu bələdçi Google-ın Gemini API ilə videonu anlama və video yaratma sənədlərindəki məlumatlar əsasında Azərbaycan dilinə uyğunlaşdırılıb. Hər iki mənbə CC BY 4.0 lisenziyası ilə yayımlanıb. Python kod nümunəsi açıq lisenziyalı videonu anlama sənədindən götürülüb.