Kısaca
- Başlamak için Google hesabı ve Google AI Studio üzerinden oluşturulmuş bir API anahtarı gerekiyor.
- Gemini API, REST üzerinden veya Python, Go, Node.js, Java ve C# SDK’larıyla kullanılabiliyor.
- Rehberdeki istemler; mekân düzeni, malzeme, ışık, kamera ve görsel tutarlılığı değerlendirmeye odaklanıyor.
- API’nin 3D sahneleri anlama örneği bulunuyor; sonuçlar tasarım kararı yerine geçmemeli, kaynak görselle karşılaştırılmalı.
Neler öğreneceksiniz?
Bu rehberde, Gemini API’ye mimari bir görsel veya 3D sahneyle birlikte nasıl açık ve sınırları belirli sorular yöneltilebileceğini ele alıyoruz. Amaç, görseli otomatik olarak tasarlatmak değil; mekânsal ilişkileri tarif etmek, sunum öncesi kontrol noktaları oluşturmak ve sahne hakkında daha düzenli notlar elde etmek.
Google’ın Gemini API Cookbook’u, temel istem oluşturma ve çok modlu girdi konularını başlangıç başlıkları arasında sayıyor. Aynı kaynakta 3D sahneleri anlamaya yönelik bir örnek de yer alıyor. Aşağıdaki istemler bu belgelerden kopyalanmış değildir; mimarlık ve görselleştirme iş akışlarına uyarlanmış özgün örneklerdir. Modelin yanıtı, görseldeki gerçek ölçülerin veya tasarım kararlarının doğrulanmış kaydı olarak kabul edilmemelidir.
Gereksinimler
Başlamak için bir Google hesabı ve Google AI Studio üzerinden oluşturulmuş bir API anahtarı gerekir. Gemini API, REST API olarak doğrudan çağrılabilir; ayrıca Python, Go, Node.js, Java ve C# için resmi SDK’lar sunuluyor. Cookbook, ilk aşamada kimlik doğrulama ve “Get Started” kılavuzlarını izlemeyi öneriyor.
Bu rehberde belirli bir yazılım sürümü şartı yok. API’ye görsel eklemek için kullandığınız istemci veya kodun çok modlu girdiyi desteklemesi gerekir. API anahtarını gizli tutun; proje veya müşteri görsellerini kullanmadan önce kurumunuzun veri paylaşım kurallarını kontrol edin. Kullanım maliyeti seçilen modele ve kullanım koşullarına göre değişebileceğinden, iş öncesinde ilgili modelin güncel fiyatlandırmasını inceleyin.
Adım adım mimari görsel analizi
İncelenecek girdiyi belirleyin. Tek bir iç mekân render’ı, cephe görseli ya da 3D sahne görüntüsüyle başlayın. Analiz sorusunu görselin kapsamına göre daraltın: Örneğin sadece dolaşım izlenimi veya ışık dağılımı hakkında geri bildirim isteyin. Görselde bulunmayan ölçüleri modelden kesinmiş gibi çıkarmasını beklemeyin.
İsteminizde görevi ve sınırları belirtin. “Görseli analiz et” gibi geniş bir talep yerine, hangi unsurların inceleneceğini ve yanıtın nasıl düzenleneceğini yazın. Görseli API çağrınıza çok modlu girdi olarak ekleyin.
Mekânsal ilişkileri tarif ettirin. Bu örnek, bir iç mekân render’ındaki görülebilir ilişkileri düzenli notlara dönüştürmeye yöneliktir.
Bu iç mekân görselini mimari sunum kontrolü için incele. Görülebilen ana mekânları, açıklıkların konumunu ve mobilyaların birbirleriyle ilişkisini ayrı maddeler hâlinde tarif et. Görselde açıkça seçilemeyen bilgileri tahmin etme; belirsiz noktaları ayrıca belirt.Yanıtı, proje ekibinin görselle aynı anda kontrol edebileceği bir gözlem listesi olarak kullanın. “Görülebilen” ve “belirsiz” ayrımı, çıkarımları tasarım verisi gibi değerlendirme riskini azaltır.
Malzeme ve ışık incelemesini ayrı istemlerle yapın. Tek bir talepte çok sayıda farklı değerlendirme istemek yerine, görselin belirli bir yönünü hedefleyin. Böylece çıkan notları render revizyonlarına göre ayırmak kolaylaşır.
Bu mimari görselde seçilebilen yüzey ve malzeme özelliklerini tarif et. Renk, parlaklık ve doku izlenimlerini gözleme dayalı olarak ayır; gerçek malzeme türünü görselden kesin belirleyemiyorsan bunu açıkça yaz. Görselde olmayan ürün veya malzeme adı ekleme.Bu istem, malzeme listesi oluşturmaz; yalnızca görselde algılanabilen izlenimleri sınıflandırmayı hedefler. Gerçek malzeme seçimi için proje dokümanlarını ve numuneleri esas alın.
Görseldeki ışık ve gölge dağılımını sunum kontrolü açısından değerlendir. Aydınlık ve karanlık bölgeleri, öne çıkan yansımaları ve okunması zorlaşan alanları ayrı başlıklarda belirt. Işık kaynağının yönü kesin seçilemiyorsa tahmin yürütme.Bu çıktıyı render ayarlarını doğrudan değiştiren bir talimat değil, sahneyi tekrar gözden geçirmek için kontrol listesi olarak değerlendirin.
Kamera ve kadrajı kontrol ettirin. Özellikle sunum görsellerinde kadrajın hangi tasarım öğelerini öne çıkardığını ve hangi alanları dışarıda bıraktığını sorabilirsiniz.
Bu mimari görselin kadrajını incele. Görselde en çok dikkat çeken üç unsuru ve kadraj nedeniyle daha az görünür kalan alanları belirt. Perspektif veya gerçek mekân ölçüsü hakkında kesin sonuç çıkarma; yalnızca görüntüde görülenleri değerlendir.Son turda tutarlılık kontrolü isteyin. Önceki yanıtları proje gerçeği olarak kabul etmek yerine, görsel üzerinde ekipçe kontrol edilecek sorular üretmesini isteyin.
Bu görsel için tasarım ekibinin doğrulaması gereken beş kontrol sorusu hazırla. Sorular; mekânsal ilişki, malzeme okunabilirliği, ışık ve kadrajla ilgili olsun. Görselde doğrulanamayan bir durumu gerçekmiş gibi ifade etme.Yaygın hatalar
Ölçü veya teknik özellikleri görselden kesin çıkarmak: Perspektifli bir görüntü, tek başına doğrulanmış ölçü bilgisi değildir. Ölçü, malzeme kodu veya ürün adı gerekiyorsa proje kaynaklarına başvurun.
Bir isteme birden fazla iş yüklemek: Mekân okuması, malzeme yorumu ve kadraj eleştirisini ayrı istemlere bölün. Bu, yanıtları karşılaştırmayı kolaylaştırır.
Belirsizliği istemde dışarıda bırakmak: Modelin tahminde bulunmasını istemiyorsanız, bilinmeyenleri açıkça belirtmesini ve görselde seçilemeyen bilgileri uydurmamasını yazın.
Yanıtı tasarım onayı saymak: Çıktı, ekip içi kontrol ve tartışma için yardımcı olabilir; proje çizimleri, model ve sorumlu tasarım değerlendirmesinin yerini tutmaz.
Maliyet ve erişim koşullarını kontrol etmemek: API anahtarı oluşturmak başlangıç adımlarından biridir; hangi modelin kullanılacağına karar vermeden önce ilgili erişim ve fiyatlandırma bilgilerini inceleyin.
Mimarlık ve görselleştirme iş akışına etkisi
Bu yaklaşım, özellikle render öncesi veya sunum öncesi hızlı bir görsel kontrol listesi hazırlamak isteyen mimarlık ofisleri, iç mimarlar ve archviz ekipleri için yararlı olabilir. Öğrenciler de bir görselde hangi unsurların açıkça okunabildiğini, hangilerinin yoruma açık kaldığını ayırma pratiği yapabilir. Daha karmaşık 3D içerikler için kaynakta 3D sahne anlama örneği bulunuyor; ancak kullanılan veri biçimi ve uygulama ayrıntıları için ilgili API kılavuzuna bakılmalı.
İş akışında donanımdan önce API erişimi, anahtar güvenliği ve maliyet koşulları gözden geçirilmeli. Kaynaklar belirli bir yerel donanım gereksinimi vermediğinden, bu rehber bir ekran kartı veya iş istasyonu öneremez. Üretim kararlarında görseli, model çıktısını ve proje dokümanlarını birlikte değerlendirin.
Sonraki adımlar
İlk denemeyi tek bir görselle ve tek bir değerlendirme hedefiyle yapın. Sonuçları ekip içinde görselle karşılaştırıp hangi istemlerin işe yaradığını kaydedin. Ardından Gemini API Cookbook’taki kimlik doğrulama ve başlangıç kılavuzlarına, çok modlu girdi açıklamalarına ve 3D sahne örneğine geçin. Kodla ilerleyen ekipler REST API’yi veya resmi SDK’lardan birini tercih edebilir.
Kaynak ve lisans
Google’ın Gemini API Cookbook’u, CC BY 4.0 lisansı altında yayımlanmıştır. Bu rehber, kaynaktaki başlangıç yolu, çok modlu girdi ve 3D sahne örneği bilgileri temel alınarak Türkçeye uyarlanmıştır. İstem örnekleri mimarlık ve görselleştirme bağlamında özgün olarak hazırlanmıştır.
Sık sorulan sorular
Gemini API ile mimari görsel analizi için ne gerekir?
Google hesabı ve Google AI Studio üzerinden oluşturulmuş API anahtarı gerekir. API, REST üzerinden veya Python, Go, Node.js, Java ve C# SDK’larıyla kullanılabilir.
Gemini API 3D sahneleri inceleyebilir mi?
Gemini API Cookbook’ta 3D sahneleri anlamaya yönelik bir örnek bulunuyor. Uygulama ayrıntıları için ilgili API kılavuzuna başvurulmalı.
Gemini API’nin mimari görsel analizinde verdiği yanıtlar kesin ölçü sağlar mı?
Bu rehberdeki istemler gözle görülen unsurları tarif etmeye yöneliktir; kesin ölçü veya malzeme bilgisi sağlamaz. Bu tür veriler proje kaynaklarından doğrulanmalıdır.
Kaynaklar
1 kaynakKaynak metinler yeniden yayımlanmaz; kısa alıntılar tırnak içinde verilir, geri kalanı özgün özet ve yorumdur.
Mimarlık ve archviz ekipleri için en pratik kullanım, modeli tasarım kararlarını veren bir araç gibi değil, gözden kaçabilecek noktaları listeleyen bir yardımcı olarak konumlandırmak. Ayrı istemlerle mekân, malzeme ve ışığı incelemek, ekip içi geri bildirimi daha düzenli hâle getirebilir.
Türkiye’deki ofisler ve öğrenciler için başlamadan önce API maliyetini, anahtar güvenliğini ve müşteri görsellerinin paylaşım koşullarını değerlendirmek önemli. Kaynaklar yerel donanım gereksinimi belirtmiyor; bu nedenle yeni bir iş istasyonu yatırımı gerektirdiği sonucuna varılamaz. Çıktılar ölçü veya malzeme doğrulaması yerine geçmemeli.




Yorumlar 0