# Gemma’nın görsel girdisini mimari görsellerde deneme: istem rehberi

Kaynak: https://3dsinifi.com/haber/gemmanin-gorsel-girdisini-mimari-gorsellerde-deneme-istem · Kategori: Eğitimler · Yayın: 15 Kasım 2026

> Gemma belgeleri görsel girdilerin işlenmesini destekliyor; ancak mimari plan ve render’lara özel bir yetenek doğrulamıyor. Bu rehber, genel görsel desteği mimari görsellerle deneyenler için seçenekleri ve kontrol adımlarını anlatıyor.

## Kısaca
- Gemini API belgeleri, Gemma 4 için görsel girdi örneği sunuyor; mimari görsellerdeki başarıyı ayrıca doğrulamıyor.
- API yolunda Google hesabı ve Google AI Studio’dan alınan API anahtarı gerekiyor.
- Gemma kütüphanesi rehberi, görsel istemler için Gemma 3 veya üzeri, 4B ya da daha büyük bir model ve Gemma3Tokenizer koşullarını belirtiyor.
- Gemma belgeleri eski olarak işaretlenmiş; güncel kurulum ve model bilgileri yeni dokümantasyondan kontrol edilmeli.

## Bu rehberde ne öğreneceksiniz?

Gemma belgeleri, modellerin görsel girdileri metinle birlikte işleyebildiğini gösteriyor. Bu, mimari planları veya iç mekân render’larını özel olarak yorumlayabildiğinin ya da bu tür çıktılara güvenilebileceğinin kanıtı değil. Buradaki amaç, genel görsel girdi özelliğini mimari görsellerle denemek için nasıl bir istem kurulabileceğini ve sonuçların nasıl temkinli değerlendirileceğini anlatmak.

Rehberde iki ayrı yol ele alınıyor: Gemini API üzerinden barındırılan Gemma modellerini kullanmak ve Gemma library for JAX örneğini izleyerek bir kütüphane ortamında çalışmak. Bu seçeneklerin kurulum adımları farklı. Ayrıca ilgili Gemma sayfaları eski dokümantasyon uyarısı taşıyor; aktarılan koşulları uygulamadan önce güncel belgelerle karşılaştırmak gerekiyor.

## Gereksinimler: hesap, yazılım ve model

**Gemini API yolu:** Kaynaklarda API kullanımı için Google hesabı ve Google AI Studio’dan edinilen API anahtarı isteniyor. Gemma API sayfası, Gemma 4 modelleri arasında `gemma-4-31b-it` ve `gemma-4-26b-a4b-it` adlarını listeliyor. Görsel örneğinde `gemma-4-26b-a4b-it` modeliyle dosya yükleme ve görseli metinle birlikte gönderme gösterilmiş. API sayfası eski olarak işaretlendiği için model adlarını ve istemci yöntemlerini güncel kabul etmeden önce yeni dokümantasyonu kontrol edin.

**Gemma library for JAX yolu:** Kütüphane rehberi, görsel girdi için Gemma 3 veya üzeri bir modelin 4B ya da daha büyük olmasını ve `Gemma3Tokenizer` kullanılmasını şart koşuyor. Örnekte Gemma kütüphanesinin kurulumu, Kaggle hesabı ve API anahtarıyla erişim, Colab ortamı, JAX ve model parametrelerinin yüklenmesi yer alıyor. Colab çalışma ortamının modeli çalıştırmaya yetecek kaynaklara sahip olması gerektiği belirtiliyor; rehber belirli bir donanım miktarı vermiyor.

Bu kurulum örneği de eski olarak işaretlenmiş. Kütüphane adı, model yapılandırması ve bağımlılıkları işe başlamadan önce güncel kaynaklardan doğrulayın. Sağlanan belgeler API ücretlerini belirtmiyor; kullanım maliyetini ayrıca araştırmak gerekiyor.

## Adım adım mimari görselle deneme

### 1. Görseli ve deneme amacını seçin

İlk denemede tek bir görsel ve dar kapsamlı bir soru kullanın. Bir render’daki görünür yüzeyleri tarif ettirmek veya bir plan görselinde okunabilen bağlantıları listeletmek, genel görsel girdi desteğini sınamak için örnek deneyler olabilir. Bunlar kaynakların Gemma için doğruladığı özel mimari görevler değildir; sonuçlar modelin bu görsellerde ne yapabildiğini görmek için bir deneme olarak ele alınmalı.

Görselin neyi kanıtlayabileceğini baştan sınırlayın. Render gerçek ölçüleri, yapım detaylarını veya kullanılan malzemenin kesin türünü tek başına doğrulamaz. Plan görselindeki küçük yazılar da yanlış okunabilir. Önemli proje bilgilerini çizim ya da sahne dosyasıyla karşılaştırmadan doğrulanmış kabul etmeyin.

### 2. Kullanım yolunu belirleyin

API yolunda kaynak örneği, dosyanın API istemcisiyle yüklenmesini ve yüklenen dosyanın metin istemiyle birlikte modele gönderilmesini gösteriyor. Kendi uygulamasında bu yolu seçenler, örnekte yer alan model ve SDK kullanımlarının güncel olup olmadığını yeni belgelerden teyit etmeli.

Kütüphane örneğinde ise önce model, parametreler ve tokenizer yapılandırılıyor; görselli istem, görsel verisiyle birlikte örnekleyiciye aktarılıyor. Bu kurulum API örneğiyle aynı değildir. İki yolun kod ve erişim adımlarını birbirine karıştırmayın.

### 3. İstemi gözlemlenebilir unsurlarla sınırlayın

İyi bir test istemi, modelden görselde görünmeyen bilgileri çıkarsamasını istememeli. Hangi özelliklere bakılacağını ve belirsizliğin nasıl ifade edileceğini açıkça belirtin. Aşağıdaki örnekler bu rehber için yazılmıştır; mimari yorumlama yeteneğinin kaynaklarca doğrulandığı anlamına gelmez.

Render’daki görünür unsurları listelemek için:

```prompt
Bu görselde doğrudan seçilebilen unsurları tarif et. Görünür yüzeyleri, ışığın görseldeki dağılımını ve kadrajda öne çıkan öğeleri ayrı başlıklarla yaz. Malzeme türü, ölçü veya ışık kaynağı kesin olarak anlaşılamıyorsa bunu açıkça belirt; görselde bulunmayan bilgi ekleme.
```

Bu istem, gözlenebilir ayrıntıları varsayımlardan ayırmayı dener. Yanıtı malzeme tespiti veya aydınlatma hesabı olarak değerlendirmeyin; bu tür sonuçlar için proje belgelerini kontrol edin.

Plan görselinde neyin okunabildiğini sınamak için:

```prompt
Bu görselde okunabilen mekân adlarını ve çizimde açıkça görülen bağlantıları listele. Okunamayan yazıları ve emin olmadığın alanları ayrıca belirt. Görselde yer almayan ölçüleri, oda adlarını veya kullanım kararlarını tahmin etme.
```

Bu deneme, modelin planı doğru çözeceğini garanti etmez. Yanıtı çizimin yazıları, lejantı ve proje dosyasıyla karşılaştırın.

İç mekân fotoğrafı için görsel betimleme denemesi:

```prompt
Bu iç mekân görselinde kadrajda görülebilen mobilyaları, renk ilişkilerini ve dikkat çeken odak noktasını kısa maddelerle tarif et. İşlev, ölçü veya kullanıcı davranışı hakkında görselden doğrulanamayan çıkarımlar yapma. Belirsiz noktaları ayrı belirt.
```

Bu örnekte istenenler, fotoğrafta seçilebilen unsurlara odaklanır. Tek bir görüntü mekânın tüm kullanım koşullarını göstermediğinden, yanıtı kapsamlı bir tasarım değerlendirmesi saymayın.

Sunum öncesi görsel kontrol notu taslağı almak için:

```prompt
Bu mimari görselde ilk bakışta görülebilen üç özelliği ve ekip tarafından ayrıca kontrol edilmesi gereken üç noktayı listele. Görselde kesin olarak doğrulanmayan bir durumu teknik hata diye adlandırma; kontrol önerisi olarak ifade et.
```

Bu istem, model yanıtını bir kontrol notu taslağı olarak sınar. Önerileri hata tespiti gibi sunmayın; ilgili sahne veya çizim dosyasında doğrulayın.

### 4. Yanıtı kontrol edin ve denemeyi kaydedin

Modelin yanıtını verdiğiniz görselle yan yana inceleyin. Önemli bir tespit varsa görseli ve proje kaynağını karşılaştırın; modelin belirsizliği belirtip belirtmediğine de bakın. Benzer görsellerde aynı istemi kullanmak yanıtları karşılaştırmaya yardımcı olabilir, ancak bu yöntem tek başına nesnel bir ölçüm oluşturmaz.

Denemeyi ekip içinde paylaşacaksanız kullanılan görseli, istemi ve elde edilen yanıtı birlikte saklayın. Böylece bir sonucun hangi bağlamda üretildiği anlaşılabilir. Müşteri sunumu, uygulama kararı veya teknik dokümantasyon için model yanıtını tek doğrulama kaynağı olarak kullanmayın.

## Sık yapılan hatalar

- **Genel desteği özel yetenek sanmak:** Kaynaklar görsel girdi kullanımını gösteriyor; mimari plan ve render yorumlama başarısını doğrulamıyor.
- **Belirsiz görev vermek:** “Yorumla” gibi geniş bir istek yerine incelenecek görsel öğeleri ve yanıt biçimini belirtin.
- **Görselde olmayan bilgiyi varsaymak:** Ölçü, malzeme veya işlev gibi unsurlar görselden kesinleşmiyorsa bunları proje dosyasıyla kontrol edin.
- **Farklı model talimatlarını genellemek:** PaliGemma sayfasında görüntü ve metin sırası ile göreve özel sözdizimleri anlatılıyor. Bu biçimler tüm Gemma modellerine otomatik olarak uygulanmamalı; kullanılacak modelin kendi talimatları izlenmeli.
- **Eski belgeyi güncel kabul etmek:** Gemma API ve kütüphane sayfaları yeni dokümantasyona yönlendiriyor. Model adı, SDK ve kurulum koşullarını kontrol edin.

## Sonraki adımlar

Önce tek görselle, dar kapsamlı bir istem deneyin ve yanıtı doğrudan görsel üzerinden kontrol edin. Daha sonra benzer görsellerde aynı denemeyi tekrarlayarak tutarlı biçimde görülen ve hata veren noktaları not edin. Bu gözlemler yalnızca kendi test ortamınızın sonuçlarıdır; mimari görevlerde genel bir doğruluk iddiasına dönüştürülmemeli.

Bir ofis veya eğitim ortamında kullanım planlanıyorsa erişim koşullarını ve olası maliyeti ayrıca inceleyin. Yerel kütüphane seçeneğinde güncel kurulum belgelerini ve çalıştırma ortamının yeterliliğini doğrulayın. Her iki yolda da proje kararlarını model yanıtından bağımsız olarak çizim ve tasarım dosyaları üzerinden teyit edin.

## Kaynak ve lisans

Google’ın Gemini API Cookbook deposu (K1), Gemma’nın Gemini API belgesi (K2), Gemma library for JAX rehberi (K3) ve PaliGemma istem biçimi sayfası (K4) kullanıldı. K1 deposunun lisans bilgisi Apache-2.0 olarak belirtiliyor. K2, K3 ve K4 dokümantasyon sayfaları CC BY 4.0 lisanslı; K3 ve K4 ayrıca kod örnekleri için Apache 2.0 lisansını belirtiyor. İçerik Türkçeye uyarlanmıştır. Gemma belgelerinin eski dokümantasyon uyarısı taşıdığı göz önünde bulundurulmalı.

## Pro ipucu
İlk denemede tek görsel ve dar kapsamlı bir istem kullanın; önemli bulguları çizim veya sahne dosyasıyla doğrulayın.

## 3dsınıfı yorumu
Türkiye’deki ofis ve öğrenciler için görsel girdiyi mimari görsellerle denemek, tasarım tartışmasına başlangıç notu sağlayabilir. Ancak kaynaklar mimari plan veya render analizinde özel bir başarı göstermiyor; bu nedenle çıktıyı doğrulanmış teknik bilgi ya da tasarım kararı olarak görmek doğru olmaz.

API seçeneğinde kaynaklar fiyat belirtmiyor; erişim ve olası maliyet güncel belgelerden kontrol edilmeli. Yerel kütüphane örneği ise JAX kurulumu ve modeli çalıştırmaya yetecek bir ortam gerektiriyor. Belgelerin eski olması da uyumluluk kontrolünü iş akışına almadan önce özellikle önemli kılıyor.

## Kaynaklar
- [ai.google.dev (CC BY 4.0)](https://ai.google.dev/gemini-api/cookbook) (özet)
- [ai.google.dev (CC BY 4.0)](https://ai.google.dev/gemma/docs/core/gemma_on_gemini_api) (özet)
- [ai.google.dev (CC BY 4.0)](https://ai.google.dev/gemma/docs/core/gemma_library) (özet)

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