# Gemini API ile mimari görsel analizi: 5 prompt ve iş akışı

Kaynak: https://3dsinifi.com/haber/gemini-api-ile-mimari-gorsel-analizi-5-prompt-ve-is-akisi · Kategori: Eğitimler · Yayın: 11 Ekim 2026

> Gemini API, görselleri metinle birlikte modele ileterek açıklama, sınıflandırma ve görsel soru-cevap senaryolarında kullanılabiliyor. Bu rehber, mimari görseller için beş prompt ve temel aktarım yollarını anlatıyor.

## Kısaca
- Gemini API’ye görseller URL, satır içi veri veya Files API üzerinden gönderilebiliyor.
- Satır içi görsel verisi kullanılan toplam isteğin boyutu 20 MB ile sınırlı.
- Büyük dosyalar veya yeniden kullanılacak görseller için Files API öneriliyor.
- Açık ve belirli talimatlar, istenen yanıt biçimini ve kapsamını tarif etmeye yardımcı oluyor.

## Bu rehberde ne öğreneceksiniz?

Bir mimari fotoğrafı ya da render’ı modele iletip görselde seçilebilen öğeleri tarif ettirmek, görünür unsurları sınıflandırmak veya tasarım değerlendirmesi için odaklı sorular sormak mümkün. Bu rehber, Gemini API üzerinden tek bir görseli modele iletmeyi ve mimarlık, iç mimarlık ve görselleştirme işlerinde denenebilecek istemler kurmayı adım adım ele alıyor.

Gemini belgeleri; görsel açıklama, sınıflandırma ve görsel soru-cevap gibi çok modlu görevleri kapsıyor. Aşağıdaki mimari örnekler bu görevlerden hareketle hazırlanmış istem önerileridir; kaynaklar, burada sıralanan her özel kullanımın doğruluğunu veya belirli bir iş akışına uygunluğunu garanti etmiyor. Model yanıtı proje çizimi ya da teknik doğrulama yerine geçmez. Görseldeki bilgiyi düzenlemek ve ekip içi değerlendirmeyi desteklemek için bir başlangıç noktası olarak düşünülmeli.

## Gereksinimler ve görseli hazırlama

Örnekler Gemini API’de `gemini-3.8-flash` modelini kullanıyor. Kaynak dokümandaki kod örnekleri Python, JavaScript, Java, Go ve REST üzerinden istek oluşturmayı gösteriyor; ancak burada belirli bir SDK sürümü belirtilmiyor. REST örneğinde API anahtarı `GEMINI_API_KEY` değişkeniyle kullanılıyor. Kurulum ve erişim ayrıntılarını kullanılan geliştirme ortamına göre ayrıca kontrol etmek gerekir.

Önce analiz etmek istediğiniz tek bir görsel seçin: bir iç mekân render’ı, cephe görseli, vaziyet planı fotoğrafı veya malzeme örnekleri olabilir. İstemde modelden ne yapmasını beklediğinizi açıkça yazın. Örneğin yalnızca görünen öğeleri listelemesini, belirli bir görsel özelliğe odaklanmasını veya belirsiz noktaları işaretlemesini isteyin.

Görseli API’ye üç yolla iletebilirsiniz: erişilebilir bir görsel adresi, satır içi (base64 kodlanmış) görsel verisi veya Files API. Satır içi veri kullanıldığında metin istemleri ve diğer içerikler de hesaba katılarak toplam istek boyutu 20 MB’ı aşmamalı. Büyük dosyalar ya da aynı dosyanın birden fazla istekte kullanılması için Files API öneriliyor.

## Adım adım: görsel analizi için beş prompt

**1. Render’da görünenleri tarafsız biçimde listeleyin.** Görseli metinle birlikte API’ye gönderin ve aşağıdaki istemi ekleyin. İlk incelemede yorumdan çok gözlemlenebilir öğelere odaklanmak, sonraki değerlendirmeler için daha düzenli bir çıktı sağlayabilir.

```prompt
Bu mimari görselini incele. Yalnızca görüntüde seçilebilen öğeleri belirt: mekân türü, ana yüzeyler, mobilyalar, aydınlatma ve bitkiler. Bilgi görüntüden anlaşılamıyorsa bunu açıkça söyle. Yanıtı kısa, başlıklı maddeler hâlinde ver.
```

Bu istem, gözlemlenebilir öğelerle sınırlı bir açıklama talep ediyor. Gerektiğinde listedeki başlıkları proje görselinin içeriğine göre daraltın; görüntüde bulunmayan bilgileri tamamlamasını istemeyin.

**2. Tek bir tasarım ölçütüne odaklanın.** Görsel soru-cevap, genel bir açıklama istemekten daha hedefli olabilir. Soruyu değerlendirilmek istenen tasarım kararına göre sınırlandırın ve modelden görselde bulunmayan bilgileri çıkarsamasını istemeyin.

```prompt
Bu iç mekân görselinde gün ışığının hangi bölgelere ulaştığını tarif et. Sadece görüntüde görülebilen ışık ve gölge dağılımına dayan. Pencere yönü veya günün saati görüntüden kesin olarak anlaşılamıyorsa tahmin yürütme; belirsizliği belirt.
```

Bu örnek, ışık ve gölge dağılımı gibi görselde incelenebilecek tek bir konuya odaklanıyor. Görselin kanıtlamadığı yön veya saat bilgilerini yanıtın dışında bırakmasını da açıkça belirtiyor.

**3. Görselde seçilebilen yüzeyleri sınıflandırın.** Gemini belgeleri sınıflandırma görevlerini kapsıyor. Kategorileri ve çıktı düzenini istemin içinde tanımlayın. Bu örnekte amaç, teknik standartları doğrulamak değil, görselde gözlemlenen yüzeyleri gruplamak.

```prompt
Görselde seçilebilen yüzeyleri şu gruplara ayır: duvar, zemin, tavan ve sabit mobilya. Her grupta görülen yüzeyin rengini ve dokusunu yalnızca görseldeki izlenime göre tarif et. Malzeme türünü kesin olarak belirleyemiyorsan olası malzeme adı verme; “görselden belirlenemiyor” yaz.
```

Kategoriler önceden tanımlandığı için sonuçları gözden geçirmek kolaylaşabilir. Buna rağmen görüntüden kesin malzeme türü çıkarmak her zaman mümkün olmayabilir; istemde bu belirsizliği belirtmek, yanıtın sınırını açık tutar.

**4. Görseldeki yerleşim ilişkilerini tarif ettirin.** Birden fazla görüntüyü aynı istekte karşılaştırmak kaynakta gösterilmiyor. Bu nedenle aşağıdaki örnek, tek bir görselde görülebilen yerleşim ilişkilerine odaklanıyor.

```prompt
Bu iç mekân görselinde mobilyaların ve dolaşım alanlarının kadraj içinde nasıl konumlandığını tarif et. Yalnızca görüntüde seçilebilen ilişkilere dayan; ölçü, geçiş genişliği veya planda görünmeyen başka bilgiler üretme. Emin olmadığın noktaları ayrıca belirt.
```

Bu istem, modelden plan ya da ölçü çıkarmasını istemiyor; yalnızca kadrajda görülen ilişkileri söze dökmesini talep ediyor. Böyle bir açıklamayı tasarım kararı olarak değil, görsel üzerinden hazırlanmış bir gözlem notu olarak değerlendirin.

**5. Kısa bir görsel açıklaması hazırlatın.** Sunum paftası, görsel arşivi veya ekip içi paylaşım için kısa bir metin gerekiyorsa uzun analiz yerine sözcük sınırı ve içerik biçimi verin. Yanıtı son kullanım öncesinde görselle karşılaştırarak kontrol edin.

```prompt
Bu mimari render için Türkçe, en fazla iki cümlelik tarafsız bir görsel açıklaması yaz. Mekânın kullanımını, kadrajda öne çıkan tasarım öğelerini ve görünen ışık koşullarını aktar. Görselde doğrulanamayan proje bilgisi, konum veya tasarımcı adı ekleme.
```

Bu istem, kısa ve tarafsız bir açıklama biçimi tanımlıyor. Görselde doğrulanmayan proje bilgilerini dışarıda tutma talebi de, metnin yanlışlıkla proje künyesi gibi kullanılmasını önlemeye yardımcı olabilir.

## Sık yapılan hatalar ve kontrol adımları

“Bu görseli analiz et” gibi kapsamı belirsiz bir talimat, neyin inceleneceğini ve yanıtın nasıl düzenleneceğini modele bırakır. Görevi, gözlem ölçütlerini ve çıktı biçimini açıkça belirtin. Kısa liste veya belirli başlıklar istemek, yanıtı incelemeyi kolaylaştırabilir.

Görselde görünmeyen bilgileri kesinmiş gibi istemek de yanıltıcı sonuçlar doğurabilir. Bir render, yapım detaylarını veya malzeme ürün adlarını her zaman göstermez. İstemde “görüntüden anlaşılamıyorsa belirt” gibi bir kısıt kullanın ve önemli gözlemleri özgün görselle karşılaştırın. Model yanıtını proje çizimi, teknik şartname ya da yerinde inceleme yerine kullanmayın.

Aktarım yöntemini dosya boyutu ve tekrar kullanım ihtiyacına göre seçin. Satır içi görsel verisinin toplam istek için 20 MB sınırı bulunuyor. Büyük dosyada veya görseli tekrar kullanma ihtiyacında Files API’yi değerlendirin. İstemle görselin birlikte gönderildiğini ve kullanılan MIME türünün görselle eşleştiğini kontrol edin; kaynak örnekleri görsel içeriğinin tür bilgisini de istek içinde veriyor.

İlk yanıtı nihai kabul etmek yerine istemi iyileştirin. İstenen kapsam daraltılabilir, çıktı biçimi netleştirilebilir veya belirsizliğin nasıl ifade edileceği yazılabilir. Prompt tasarımı yinelemeli bir süreçtir; farklı denemelerin sonuçlarını kullanım amacına göre gözden geçirmek öneriliyor.

## Mimarlık ve görselleştirme iş akışında yeri

Bu yaklaşım; render’ları açıklama, tek bir görseldeki öğeleri sınıflandırma veya tasarım toplantısı öncesinde gözlemleri düzenli biçimde not etme ihtiyacı olan ekipler için yararlı olabilir. Öğrenciler de sunum görselleri için açıklama taslakları hazırlatıp bunların gerçekten görselde görünenlerle sınırlı olup olmadığını kontrol edebilir.

Ancak kaynak belgeler, mimari yazılımlarla doğrudan entegrasyon, yerel donanım gereksinimi, API fiyatı veya proje verilerinin saklanma koşulları hakkında bilgi vermiyor. Bu nedenle iş akışına geçmeden önce kullanılan API erişiminin maliyetini ve koşullarını, ofis politikasını ve görsellerin paylaşımına ilişkin kuralları ayrıca inceleyin. Müşteri veya proje açısından hassas görselleri göndermeden önce kurum içi izinleri kontrol edin.

## Sonraki adımlar

Önce kritik olmayan tek bir görselle deneme yapın. Aynı görsel üzerinde açıklama, sınıflandırma ve soru-cevap istemlerini ayrı ayrı deneyip hangi yanıt biçiminin ekibin ihtiyacına uyduğunu değerlendirin. Tekrarlanan analizlerde Files API kullanımını, tek seferlik ve küçük isteklerde ise uygun aktarım yolunu değerlendirebilirsiniz.

Yanıtlar tutarlı değilse istemi daha somut hâle getirin: incelenecek öğeleri, gözlem sınırını ve istenen çıktı biçimini yazın. Sonuçları görselin kendisiyle karşılaştırın; modelin göremediği veya görselin doğrulamadığı bilgileri proje verisi olarak kabul etmeyin.

## Kaynak ve lisans

Bu eğitim, Google’ın Gemini API görsel anlama ve prompt tasarımı belgelerinden Türkçeye uyarlanmıştır. Her iki kaynak da CC BY 4.0 lisanslıdır. Mimari görsellere yönelik prompt örnekleri bu rehber için özgün olarak hazırlanmıştır.

## Pro ipucu
Malzeme, ölçü veya konum gibi görselden kesin çıkarılamayabilecek bilgiler için prompta “anlaşılamıyorsa belirt” kısıtını ekleyin.

## 3dsınıfı yorumu
Mimarlık ofisleri ve görselleştirme ekipleri için en pratik kullanım, tekil görselleri açıklamak ve tasarım değerlendirmelerinde gözlemleri ortak bir biçime sokmak olabilir. Bu yaklaşım sunum hazırlığını destekleyebilir; ancak model yanıtı proje doğrulaması veya teknik karar yerine geçmez.

Türkiye’deki ofisler için denemeden önce API erişim maliyetini, görsel paylaşım politikasını ve müşteri verilerinin kullanımına ilişkin koşulları kontrol etmek önemli. Kaynaklar fiyat, donanım ihtiyacı ve veri saklama ayrıntılarını açıklamıyor. Bu nedenle hassas görsellerle başlamamak ve çıktıları özgün görselle karşılaştırmak yerinde olur.

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

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