# Gemini API ile mimari video analizi: adım adım uygulama rehberi

Kaynak: https://3dsinifi.com/haber/gemini-api-ile-mimari-video-analizi-adim-adim-uygulama · Kategori: Eğitimler · Yayın: 25 Ekim 2026

> Bu rehber, Gemini API ile mimari video kayıtlarını özetleme ve içerik hakkında soru sorma adımlarını anlatıyor. Dosya boyutuna uygun aktarım yöntemini seçip videoyu işleme ve istem yazma sürecini açıklıyor.

## Kısaca
- Gemini modelleri videoları özetleyebilir, içerikle ilgili soruları yanıtlayabilir ve belirli zaman damgalarına atıfta bulunabilir.
- 100 MB üzerindeki veya yeniden kullanılacak dosyalar için kaynak, Files API yöntemini öneriyor.
- Kaynağın ayrıntılı yönergesine göre satır içi video aktarımı, toplam istek boyutu 20 MB’ın altındaysa uygun.
- Yüklenen dosya işlenince durumunun ACTIVE olmasını bekleyip Interactions API ile analiz isteği gönderin.

## Bu rehberde ne öğreneceksiniz?

Gemini API, videolardan bilgi çıkarmak ve video içeriği hakkında soruları yanıtlamak için kullanılabiliyor. Bu rehberde mimari proje sunumu, şantiye kaydı veya mekân turu gibi videoları analiz etmek için uygun aktarım yolunu seçme, dosyanın işlenmesini bekleme ve işe yönelik istemler hazırlama adımları ele alınıyor. Gemini modelleri videoyu betimleyebilir, içerikten bilgi çıkarabilir ve belirli zaman damgalarına referans verebilir. Böylece uzun bir kaydı baştan sona elle izlemek yerine, inceleme için bir özet veya odaklı yanıt talep edilebilir.

Buradaki örnekler video üretimine değil, mevcut videoyu anlamaya yöneliktir. Google’ın video üretimi rehberi, bu iş için Gemini Omni Flash’i tanımlıyor; video anlama ise ayrı bir kullanım. Bu ayrımı korumak, analiz isteğinde yanlış modele veya iş akışına yönelme riskini azaltır.

## Gereksinimler

İş akışı için Gemini API erişimi, bir video dosyası veya herkese açık bir YouTube videosu ve metin istemi gerekir. Resmî örnekte Python istemcisi `google-genai`, Files API ve Interactions API kullanılıyor. Kaynak belirli bir SDK sürümü veya hesap açma adımı belirtmediğinden burada sürüm numarası ya da kayıt koşulu verilmiyor. API istemcisinin kimlik doğrulamasını ortamınıza göre tamamlayın; kaynakta REST örneği `GEMINI_API_KEY` değişkenini kullanıyor.

Aktarım yöntemini dosyanın boyutuna ve tekrar kullanım ihtiyacına göre seçin:

- **Files API:** Kaynak, 100 MB üzerindeki dosyalar, uzun videolar ve tekrar kullanılacak içerikler için bu yöntemi öneriyor. Belgede kapasite, ücretli kullanımda 20 GB; ücretsiz kullanımda 2 GB olarak veriliyor.
- **Cloud Storage Registration:** Dosya başına 2 GB sınırı ve depolama için sınır olmadığı belirtiliyor; büyük, uzun süre saklanacak ve tekrar kullanılacak içeriklere yönelik.
- **Satır içi veri:** Belgede küçük dosyalar için uygun olduğu aktarılıyor. Ayrıntılı yönerge, toplam istek boyutu 20 MB’ın altındaki kısa videoları bu yöntemle göndermeyi öneriyor; bu nedenle pratikte daha kısıtlayıcı olan 20 MB eşiğini esas alın.
- **YouTube URL’si:** Herkese açık videolar için desteklenen bir girdi yöntemi.

## Adım adım video analizi

### 1. İnceleme hedefini belirleyin

Videoyu göndermeden önce analizden beklenen sonucu netleştirin. Bir proje sunumunda genel özet, mekân turunda görünen malzemelerin listesi veya kayıt içindeki belirli bir ana dair açıklama istenebilir. Tek istekte çok farklı çıktılar talep etmek yerine, ana amacı ve yanıt biçimini açıkça yazın. Modelin videoda bulunmayan bilgileri tamamlamasını önlemek için yalnızca kayıtta görülenleri raporlamasını da isteyebilirsiniz.

Örneğin, bir iç mekân videosundan kısa ve düzenli bir gözlem özeti almak için şu istem kullanılabilir:

```prompt
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 istem, videoda görülebilen mekân, dolaşım, aydınlatma ve malzeme öğelerini ayrı başlıklarda toplar. Görüntüde seçilemeyen bir malzemenin kesin adını yazmak yerine, yalnızca gözlemlenebilir ayrıntılara dayanmasını ister.

### 2. Dosyaya uygun aktarım yöntemini seçin

Video büyükse, uzunsa veya sonraki istemlerde yeniden kullanılacaksa Files API’yi tercih edin. Kısa bir dosya için satır içi aktarım düşünülebilir; ancak toplam isteğin 20 MB’ın altında kalmasına dikkat edin. Herkese açık YouTube videosu için URL yöntemini değerlendirin. Dosya boyutlarını ve kullanım koşullarını göndermeden önce kontrol edin; kaynak kapasite bilgilerini ücretsiz ve ücretli kullanıma göre ayrı veriyor.

### 3. Files API ile yükleyin ve işlenmesini bekleyin

Resmî Python örneği, dosyayı `client.files.upload` ile yükleyip durum `ACTIVE` olana kadar kontrol ediyor. Dosyanın yüklenmiş olması analize hemen hazır olduğu anlamına gelmiyor; işleme tamamlanana kadar bekleyin. Aşağıdaki örnekte beş saniyelik aralıklarla durum sorgulanıyor. Bu kod, kaynaktaki açık lisanslı örneğe dayalıdır:

```python
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` alanını analiz edilecek dosyanın yolu ile değiştirin. Kaynak örneği, dosya referansı hazır olduktan sonra bu referansın video girdisi olarak kullanılmasını gösteriyor. İşleme başarısız olursa dosyayı hazır kabul etmeyin; durumun ilerlediğini doğrulayın.

### 4. Videoyu istemle birlikte Interactions API’ye gönderin

Dosya `ACTIVE` durumuna geldikten sonra video URI’sini ve metin istemini aynı etkileşimin girdilerine ekleyin. Kaynaktaki örnek `gemini-3.8-flash` model adını kullanıyor. Aşağıdaki istem, bir sunum videosundaki mekânsal sıralamayı ve geçişleri incelemeye yöneliktir:

```prompt
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.
```

Zaman damgası istemek, gözlemleri kaydın belirli bölümleriyle ilişkilendirmeye yardımcı olur. Modelin ölçü veya tasarım niyeti gibi videodan doğrulanamayacak sonuçlar çıkarmamasını açıkça belirtmek, yanıtı görsel inceleme sınırında tutar.

### 5. Çıktıyı proje işine göre daraltın

İlk yanıt genel kaldıysa, videoyu yeniden tarif etmek yerine takip sorusunu belirli bir konuya odaklayın. Gemini’nin video rehberi, çok turlu konuşmalı düzenlemeyi video üretimi bağlamında anlatıyor; video anlama belgesi ise videolar hakkında soru sorma ve zaman damgalarına referans verme becerilerini belirtiyor. Bu analiz senaryosunda soruyu, gözden geçirilmesi gereken bölüm veya gözlem türüyle sınırlandırın.

```prompt
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 istem, yanıtı aydınlatma ve malzeme görünümündeki değişikliklerle sınırlar. “Belirsiz” işaretlemesini istemek, düşük görüntü kalitesinde veya kadraj dışında kalan ayrıntıların kesin bilgi gibi sunulmasını önlemeye yardımcı olur.

## Sık karşılaşılan hatalar

- **Büyük videoyu satır içi göndermek:** Kaynağın ayrıntılı yönergesi, toplam isteği 20 MB’ın altında olan kısa videoları satır içi aktarıma uygun görüyor. Büyük dosyalarda Files API’yi değerlendirin.
- **Dosya işlenmeden analiz istemek:** Yüklemeden sonra `ACTIVE` durumunu kontrol edin; örnekte dosya durumu düzenli olarak sorgulanıyor.
- **Geniş veya muğlak istem yazmak:** “Videoyu analiz et” gibi genel bir talep yerine, özet, mekânsal geçiş ya da görünür malzeme gibi tek bir amaca odaklanın.
- **Görüntüde olmayan bilgiyi beklemek:** Video anlama, içerikteki görsel bilgileri incelemeye yarar; kayıt dışındaki proje ölçülerini veya tasarım kararlarını doğruladığı varsayılmamalıdır.
- **Video üretimi rehberiyle analiz rehberini karıştırmak:** Mevcut videoyu anlamak için video anlama dokümantasyonunu izleyin. Google, Veo 3.1 Preview’ın Gemini API’de 22 Ekim 2026’da kapatıldığını ve video üretimi için Gemini Omni Flash’e geçişi bildiriyor; bu değişiklik analiz adımlarının yerine geçmiyor.

## Mimarlık, iç mimarlık ve archviz iş akışında kullanım

Mimarlık ve iç mimarlık ekipleri, proje turu veya mekân kaydından ilk gözlem özeti çıkarmak, önemli bölümleri zaman damgalarıyla bulmak ve kayıtla ilgili soruları yanıtlamak için bu yöntemi deneyebilir. Archviz ekipleri de mevcut bir video sunumunun içeriğine yönelik soru-cevap akışını inceleyebilir. Ancak çıktı, videonun gösterdiği içerikle sınırlı tutulmalı; ölçü, teknik uygunluk veya projede uygulanabilirlik gibi kayıtla doğrulanmayan konular ayrıca kontrol edilmelidir.

Ücretli ve ücretsiz Files API sınırları farklı verildiği için ekipler, proje dosyasını göndermeden önce boyutunu ve kullandıkları erişim koşullarını gözden geçirmeli. Kaynak donanım gereksinimi, fiyatlandırma ayrıntısı veya yerel yazılım entegrasyonu açıklamıyor; bu nedenle iş akışını mevcut modelleme ya da render araçlarına bağlanmış gibi varsaymayın.

## Sonraki adımlar

Önce kısa ve izinli bir proje videosuyla özet istemini deneyin; ardından zaman damgası veya belirli gözlem türleri isteyen takip soruları ekleyin. Dosya büyükse ya da tekrar kullanılacaksa Files API yaklaşımını değerlendirin. Sonuçları proje notlarına aktarmadan önce videoyu ilgili zamanlarda açıp modelin gözlemlerini doğrulayın. Dosya yükleme veya model seçimiyle ilgili uygulama ayrıntıları için Gemini API’nin resmî video anlama ve video üretimi belgelerine başvurun.

## Kaynak ve lisans

Bu rehber, Google’ın Gemini API video anlama ve video üretimi belgelerindeki bilgiler temel alınarak Türkçeye uyarlanmıştır. Her iki kaynak da CC BY 4.0 lisanslıdır. Python kod örneği açık lisanslı video anlama belgesinden alınmıştır.

## Pro ipucu
Büyük veya yeniden kullanılacak videoları Files API ile yükleyin ve analiz istemine geçmeden önce dosya durumunun ACTIVE olduğunu doğrulayın.

## 3dsınıfı yorumu
Türkiye’deki mimarlık ofisleri ve öğrenciler için bu yaklaşım, proje turu ya da mekân videosundan ilk gözlem ve zaman damgalı inceleme notları çıkarmayı hızlandırabilir. Özellikle uzun kayıtlarda, belirli bir bölümü yeniden bulmaya yardımcı olması pratik değer taşıyor.

Bunu ölçüm veya teknik doğrulama aracı gibi değerlendirmemek gerekir; önemli bulgular videoyla karşılaştırılmalı. Dosya boyutu ve ücretsiz/ücretli kullanım sınırları da yükleme öncesinde kontrol edilmeli. Kaynaklar donanım gereksinimi ve fiyat ayrıntısı vermediğinden, ekipler mevcut bütçe ve erişim koşullarını ayrıca değerlendirmeli.

## Kaynaklar
- [ai.google.dev (CC BY 4.0)](https://ai.google.dev/gemini-api/docs/video) (özet)
- [ai.google.dev (CC BY 4.0)](https://ai.google.dev/gemini-api/docs/video-understanding) (özet)

_Yapay zekâ ile yazıldı, kaynaklarla doğrulandı. © 3dsınıfı_