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

Bu rehberde ne öğreneceksiniz?

Bu eğitim, mimari sunum, şantiye kaydı, iç mekân turu veya tasarım süreci videosunu Gemini API üzerinden analiz etmek için temel bir iş akışı kurmayı anlatıyor. Amaç yeni video üretmek değil; mevcut bir videoyu modele verip özet, belirli sahnelerle ilgili yanıtlar veya içerik dökümü istemek. Google’ın video anlama belgesinde modellerin videoyu açıklama, bölümlere ayırma ve bilgileri çıkarma; video içeriği hakkında soruları yanıtlama ve zaman damgalarına başvurma kabiliyetleri sıralanıyor.

Örneklerde API’ye gönderilecek metin istekleri bulunuyor. Bunlar sonucu garanti eden komutlar değil; videodan ne tür bilgi istendiğini açıkça belirtmeye yarıyor. Çıktıyı proje kararı, ölçüm veya teknik doğrulama yerine kullanmadan önce kaynak görüntüyle karşılaştırmak gerekir.

Gerekenler ve dosya seçimi

İş akışı için Gemini API’ye erişim ve videoyu gönderebilecek bir entegrasyon gerekir. Resmî örnekler Python, JavaScript, Java, Go ve REST kullanıyor; aşağıdaki adımlar belirli bir programlama diline bağlı değil. REST örneğinde GEMINI_API_KEY adlı bir anahtar kullanılıyor. API erişimi veya hesap koşullarının ayrıntıları, burada kullanılan video belgelerinde açıklanmıyor.

Örnek API isteğinde model adı gemini-3.8-flash olarak verilmiş. Bu, video anlama örneğindeki model adıdır. Video oluşturma içinse ayrı bir rehber bulunuyor: Google, genel video üretimi ve konuşmalı düzenleme için Gemini Omni Flash’ı, sahne uzatma ya da son kare denetimi gibi ihtiyaçlar için Veo 3.1’i anıyor. Bu iki kullanım alanını karıştırmayın.

Dosyayı göndermeden önce boyutuna ve tekrar kullanılıp kullanılmayacağına bakın:

• Google, 100 MB üzerindeki veya uzun süreli videolar ve yeniden kullanılacak dosyalar için Files API’yi öneriyor. Belgedeki tabloda Files API üst sınırı ücretsiz kullanım için 2 GB, ücretli kullanım için 20 GB olarak listeleniyor.

• Cloud Storage Registration seçeneğinde dosya başına 2 GB sınırı belirtiliyor; depolama için ayrıca bir sınır olmadığı yazıyor.

• YouTube URL yöntemi herkese açık YouTube videoları için listelenmiş.

• Satır içi veri, tek seferlik küçük dosyalar için uygun. Belge tablosu bu yöntemi 100 MB altı ve kısa videolarla ilişkilendiriyor; ayrıca uygulama bölümünde toplam isteğin 20 MB’ın altında olması gerektiği belirtiliyor. Bu iki ölçüt farklı olduğundan, satır içi gönderimde daha düşük olan 20 MB toplam istek sınırını izlemek temkinli yaklaşımdır.

Adım adım analiz iş akışı

1. Videoda yanıtlanacak soruyu belirleyin. Genel bir “videoyu analiz et” isteği yerine, hangi bilgilerin aranacağını tarif edin. Örneğin iç mekân turunda mekân dizilimi, görünür malzemeler ve kameranın geçtiği bölümler ayrı başlıklar olabilir. Görüntüde olmayan ölçüleri veya gizli yapı katmanlarını modelin tespit edeceğini varsaymayın.

2. Dosyayı uygun yöntemle gönderin. Tekrarlı kullanım ya da büyük dosya söz konusuysa Files API’yi tercih edin. Resmî örnek akışta video yükleniyor, dosyanın işlenmesi bekleniyor ve durumu ACTIVE olduğunda dosya referansı metin isteğiyle birlikte gönderiliyor. İşlem başarısız olursa belge örneği FAILED durumunu hata olarak ele alıyor. Küçük video için satır içi veri kullanılabilir; dosyanın boyutunu toplam istek sınırına göre kontrol edin.

3. İsteği video içeriğiyle birlikte iletin. İstek, video girdisini ve analiz talebini metin girdisi olarak içerir. Python örneğinde dosya Files API üzerinden yükleniyor; daha küçük içerik örneğinde video baytları satır içi biçimde gönderiliyor. Hangi entegrasyon seçilirse seçilsin, video MIME türünün ve dosya referansının doğru iletilmesi gerekir.

4. İlk denemede sınırlı bir çıktı isteyin. Aşağıdaki örnekleri isteğin metin kısmına ayrı ayrı ekleyebilirsiniz. Her biri farklı bir mimari inceleme amacına yöneliktir.

Bu mimari iç mekân videosunu sahne sırasına göre özetle. Görüntüde açıkça görülen mekânları, malzeme izlenimlerini ve kamera hareketlerini ayrı maddeler hâlinde belirt. Görüntüde olmayan bilgileri tahmin etme; belirsiz noktaları açıkça işaretle.

Bu istek, genel anlatımı mekân, malzeme ve kamera hareketi olarak ayırır. Malzeme ifadelerini kesin teknik tanım gibi değil, videoda görülen görsel izlenim olarak değerlendirin.

Videoda girişten ana yaşam alanına geçişin görüldüğü bölümü bul. İlgili zaman damgasını belirt ve o anda kadrajda görünen mekânsal ilişkileri kısaca açıkla. Bölüm net değilse bunu söyle; zaman veya plan bilgisi uydurma.

Bu metin, zaman damgasına dayalı bir sahne sorusu yöneltir. Modelin yanıtındaki zamanı videoda açıp kontrol edin; belge zaman damgalarına referans verme kabiliyetinden söz etse de her istekte kusursuz eşleşme garantisi vermez.

Bu şantiye videosunda tamamlanmış görünen imalatları ve hâlen devam ettiği açıkça anlaşılan işleri ayır. Her bulguyu videoda görülen sahneyle ilişkilendir; yapısal güvenlik, ölçü veya mevzuat uygunluğu hakkında çıkarım yapma.

Bu örnek, görsel kaydı düzenlemeye yardımcı olacak bir sınıflandırma ister; ancak videodan güvenlik ya da uygunluk onayı üretmez. Yanıtları saha ekibinin kayıtlarıyla karşılaştırın.

1. Yanıtı gözden geçirip isteği daraltın. Genel özet yetersiz kalırsa videoda görünen belirli bir mekânı, sahneyi veya zaman aralığını tarif ederek yeni bir soru sorun. Gemini’nin video anlama kabiliyetleri içerik hakkında soru sormayı ve zaman damgalarına referans vermeyi kapsıyor. Sonucu kullanmadan önce önemli bulguları videoda doğrulayın.

Sık yapılan hatalar

Dosya boyutu yöntemini kontrol etmemek: Büyük veya tekrar kullanılacak dosyalarda Files API öneriliyor. Küçük dosyalarda satır içi yöntem düşünülse bile belgede toplam istek için 20 MB ölçütü ayrıca veriliyor; yalnızca video dosyasının boyutuna bakmak yeterli olmayabilir.

İşleme tamamlanmadan analiz istemek: Files API örneği, yüklemeden sonra dosya ACTIVE olana kadar bekliyor. İşleme durumu beklenmeden dosya referansını kullanmak örnek akışla uyumlu değil.

Video analizini video üretimiyle karıştırmak: Mevcut bir kaydı incelemek için video anlama rehberi kullanılmalı. Video üretimi ve düzenleme için belgede Gemini Omni Flash ve Veo 3.1 ayrı iş akışları olarak tanımlanıyor.

Görselden teknik kesinlik çıkarmak: Modelden görünür unsurları açıklamasını isteyin; görüntüde yer almayan ölçüleri, malzeme özelliklerini veya uygulama uygunluğunu doğrulanmış bilgi gibi sunmayın. Zaman damgası ve sahne eşleşmesini de kaynak video üzerinden kontrol edin.

Mimarlık ve iç mekân iş akışlarına etkisi

Bu yöntem, uzun sunum videolarında sahneleri bulmak, iç mekân turunu başlıklandırmak veya şantiye kaydından gözle görülen işleri ayıklamak isteyen mimarlık ofisleri, iç mimarlar ve öğrenciler için başlangıç noktası olabilir. Özellikle tekrar kullanılacak büyük dosyalarda Files API yaklaşımı pratik; küçük, tek seferlik denemelerde satır içi gönderim alternatif. Ancak kaynak, kullanım maliyetini veya belirli bir donanım gereksinimini açıklamıyor. Bu nedenle maliyet ve uyumluluk koşulları uygulama öncesinde ayrıca incelenmeli; model yanıtı teknik onay yerine geçmemeli.

Sonraki adımlar

Önce kısa ve temsil gücü olan bir kayıt üzerinde genel özet alın; ardından sahne ya da zaman damgası odaklı sorularla çıktıyı daraltın. Aynı videoya birden fazla istek gönderecekseniz Google’ın Files API önerisini değerlendirin. API’de video üretimi de gerekiyorsa Gemini Omni Flash ve Veo 3.1 belgelerini, video anlama akışından ayrı olarak inceleyin.

Kaynak ve lisans

Bu rehber, Google’ın Gemini API video anlama ve video oluşturma belgelerindeki bilgiler temel alınarak Türkçeye uyarlanmıştır. Her iki kaynak da CC BY 4.0 lisanslıdır.