Gemini API ile mimari videoları analiz etme: adım adım rehber

Bu rehberde ne öğreneceksiniz?

Bir proje videosunda hangi mekânların göründüğünü çıkarmak, sunum kaydını kısa bir özete dönüştürmek veya belirli bir saniyede ne olduğunu sormak için Gemini API kullanılabilir. Google’ın video anlama kılavuzu; videoyu açıklama, içerikten bilgi çıkarma ve zaman damgalarına göre soru yanıtlama gibi kullanım biçimlerini belgeliyor.

Bu anlatım, mimari görselleştirme (archviz), iç mimarlık ve proje sunumlarında kullanılan mevcut videoları analiz etmeye odaklanıyor. Video üretiminden farklı olarak burada girdi, önceden hazırlanmış bir video dosyası ya da herkese açık bir YouTube videosu. Sonuçlar, modele iletilen soruya bağlı olarak özet veya belirli ayrıntılara yönelik yanıtlar olabilir.

Gerekenler ve video seçimi

Google’ın Gemini API dokümanında kullanılan örnekler Python, JavaScript, Java, Go ve REST yöntemlerini kapsıyor. Python örneklerinde google-genai kütüphanesi yer alıyor; ancak kılavuz, bu örnekler için gerekli bir kütüphane sürümü belirtmiyor. Bu nedenle burada sürüm numarası verilmiyor. API’ye erişim ve kimlik doğrulama için kendi geliştirme ortamınızın API yapılandırmasını kullanmanız gerekir; kaynak, hesap oluşturma adımlarını ayrıntılandırmıyor.

Videoyu göndermeden önce dosya boyutunu ve kullanım şeklini değerlendirin:

• Google’ın karşılaştırma tablosunda Files API için ücretli kullanımda 20 GB, ücretsiz kullanımda 2 GB üst sınırı belirtiliyor. Bu yöntem büyük dosyalar, uzun videolar ve tekrar kullanılacak dosyalar için uygun.

• Cloud Storage Registration, dosya başına 2 GB sınırıyla listeleniyor; depolama için toplam sınır olmadığı belirtiliyor. Kalıcı ve yeniden kullanılabilir dosyalara yönelik bir seçenek olarak sunuluyor.

• Inline Data, tablodaki açıklamada 100 MB altı dosyalar için gösteriliyor. Ancak aynı rehber, toplam istek boyutu 20 MB’ın altındaki kısa videoları doğrudan isteğe eklemeyi uygun buluyor. Bu nedenle yöntemi seçerken yalnızca video dosyasını değil, isteğin toplam boyutunu da hesaba katın.

• Herkese açık YouTube videoları da girdi yöntemi olarak listeleniyor.

Google, çoğu kullanımda ve özellikle 100 MB üzerindeki ya da farklı isteklerde yeniden kullanılacak videolarda Files API’yi öneriyor. Doküman ayrıca toplam istek 20 MB’ı aşıyorsa, video süresi uzunsa veya aynı dosya birden fazla istemde kullanılacaksa Files API kullanılmasını tavsiye ediyor.

Adım adım video analizi

1. Analiz hedefini belirleyin. “Videoyu özetle” gibi genel bir istek yerine, hangi bilginin gerekli olduğunu yazın. Örneğin mekân sıralaması, kadrajda görülen malzeme ve aydınlatma değişimleri ya da sunumda açıklanan tasarım kararları ayrı ayrı sorulabilir. Modelden videoda bulunmayan bilgileri çıkarsamasını istemek yerine, yanıtı görüntüdeki veya anlatımdaki kanıta dayandırmasını belirtin.

2. Aktarım yöntemini seçin. Küçük ve tek seferlik bir klipte inline veri kullanılabilir; büyük, uzun veya yeniden kullanılacak videoda Files API daha uygun seçenektir. Dosyayı yükleyip işlenmesini bekleme adımını atlamayın: Google’ın örneklerinde dosya, durumu ACTIVE olana kadar kontrol ediliyor. Dosya işlemenin başarısız olması da olası bir durum olarak örnekte ele alınıyor.

3. İsteğe video ve metin girdisini birlikte ekleyin. Kılavuzun örneklerinde video girdisi bir dosya URI’si ve MIME türüyle, metin girdisi ise analiz talimatıyla aktarılıyor. Model adı olarak örneklerde gemini-3.8-flash kullanılmış. API dokümanındaki model ve erişilebilirlik bilgilerini kendi uygulamanız için kontrol edin; burada örnekteki ad dışında sürüm veya erişim garantisi varsayılmıyor.

Aşağıdaki metni, video girdisinin yanında metin talimatı olarak kullanabilirsiniz:

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.

Bu istem, proje kaydını düzenli bir özete dönüştürmeye yardımcı olur. Sonuçları sunum notu veya ekip içi ilk inceleme için kullanmadan önce görüntüyle karşılaştırın.

1. Belirli bir inceleme sorusu sorun. Gemini modelleri, video içeriği hakkında soru yanıtlayabiliyor ve zaman damgalarına atıfta bulunabiliyor. Bir pafta sunumunda ya da kamera turunda kritik bölümü bulmak için soruyu mekân veya olay üzerinden daraltın:

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 istem, belirli bir mekânı aramaya yöneliktir. Zaman damgasını montaj ya da sunum akışında kontrol edin; kaynak kılavuz sonuçların her durumda hatasız olacağını garanti etmiyor.

1. Malzeme ve ışık gözlemlerini ayrı isteyin. Tek bir geniş soruda çok sayıda ayrıntı istemek yerine, incelemeyi başlıklara bölmek yanıtı değerlendirmeyi kolaylaştırır:

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 istem, görseldeki yüzeyleri tarif etmeye odaklanır; modelden kesin ürün veya malzeme markası çıkarmasını istemez. Tasarım kararı vermeden önce gerçek proje dokümanlarını esas alın.

1. Yanıtı kısa bir kontrol listesine dönüştürün. Sunum videosunda ekip için takip edilecek noktalar varsa, modelden videoda gerçekten geçen bilgileri ayırmasını isteyin:

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.

Bu tür bir çıktı toplantı sonrası notları düzenlemekte işe yarayabilir. Önemli kararları toplantı kaydı veya proje dokümanlarıyla doğrulayın.

Sık yapılan hatalar

Dosya boyutunu yanlış yöntemle göndermek: Inline Data için dokümandaki tablo 100 MB altını belirtse de, aynı kılavuz doğrudan inline kullanımı toplam isteğin 20 MB altındaki kısa videolarla sınırlandırıyor. Büyük dosyalarda veya uzun videolarda Files API önerisini izleyin.

Dosya hazır olmadan analiz başlatmak: Google’ın örneklerinde yüklemeden sonra işlem durumu sorgulanıyor ve dosya ACTIVE olana dek bekleniyor. Bu adım tamamlanmadan sonraki isteğe geçmeyin.

Görüntüden kesin olmayan bilgi çıkarmak: Bir yüzeyin gerçek malzemesi, ölçüsü veya ürün adı videoda görünmeyebilir. İstemde yalnızca görülebilir bulguları istemek ve belirsizliği açıkça işaretletmek, yanlış kesinlik riskini azaltır.

Video analizini video üretimiyle karıştırmak: Gemini API’nin video üretim sayfası, Veo 3.1 Preview’ın 22 Ekim 2026’da kapatıldığını ve video üretimi için Gemini Omni Flash’a yönlendirme yapıldığını belirtiyor. Bu değişiklik, mevcut videoyu analiz etmeye yönelik bu adımlarla aynı işlem değil.

Mimarlık ve görselleştirme iş akışında kullanım

Bu yaklaşım; proje sunumlarını, iç mekân kamera turlarını veya şantiye kayıtlarını hızlıca taramak isteyen mimarlık ofisleri, iç mimarlar ve görselleştirme ekipleri için başlangıç noktası olabilir. Örneğin videoda hangi mekânın ne zaman göründüğünü bulmak, toplantı kaydından tasarım kararlarını derlemek veya bir sunumun ilk özetini çıkarmak mümkün. Ancak kaynaklar modelin BIM dosyalarını, çizimleri ya da 3D sahneleri doğrudan analiz ettiğini söylemiyor; burada anlatılan, video içeriğiyle çalışma.

İş akışını kurmadan önce dosya boyutu, süre ve yeniden kullanım ihtiyacına göre aktarım yöntemini belirleyin. Büyük veya uzun kayıtlar Files API’ye yöneliyor; ücretli ve ücretsiz kullanım için kaynakta farklı dosya sınırları listeleniyor. Fiyat, proje gizliliği, saklama süresi veya belirli bir iş istasyonunda gereken donanım hakkında bu kılavuz bilgi vermiyor; bunları kendi kullanım koşullarınız üzerinden ayrıca değerlendirin.

Sonraki adımlar

İlk denemeyi kritik karar içermeyen kısa bir proje kaydıyla yapın. Önce genel özet isteyin, ardından belirli mekân veya zaman damgasına odaklanan sorularla sonucu sınayın. Yanıtlarda görünür kanıt ile model yorumunu ayırın; ekip içinde paylaşılacak notları kaynak video ve proje belgeleriyle karşılaştırın. Aynı videoyu birden fazla istekte kullanacaksanız Google’ın Files API önerisini dikkate alın.

Kaynak ve lisans

Bu rehber, Google’ın Gemini API “Video understanding” ve “Video generation in the Gemini API” kılavuzları temel alınarak Türkçeye uyarlanmıştır. Her iki sayfada da aksi belirtilmedikçe içerik için CC BY 4.0 lisansı belirtiliyor.