GPT Image API ile mimari görsel üretimi: adım adım uygulama rehberi

Bu rehberde ne öğreneceksiniz?

GPT Image modelleri, metin girdilerinden yeni görseller oluşturmak ve mevcut görselleri düzenlemek için kullanılabiliyor. Bu rehberde API üzerinden mimari konsept veya iç mekân görseli üretmek için isteğin nasıl tarif edileceği, mevcut bir görselin nasıl girdi olarak verilebileceği ve görsel analizinin üretimden nasıl ayrıldığı ele alınıyor.

Örnekler, bir tasarım kararını anlatan görsel taslaklar hazırlamaya yöneliktir. Bunları, tamamlanmış bir mimari çizimin veya doğrulanmış teknik bilginin yerine geçen çıktılar olarak değil, fikir geliştirme ve görsel iletişim aşamasında kullanılabilecek denemeler olarak değerlendirmek gerekir.

Gerekenler: API ve model seçimi

İlk olarak hangi işlemin yapılacağı belirlenmeli. Sıfırdan görsel üretmek ya da var olan bir görseli düzenlemek için Images API kullanılabilir. Bu API’de kaynak belgede belirtilen GPT Image modeli gpt-image-2.5-sunburst ile metinden görsel üretimi ve görsel düzenleme yapılabiliyor.

Responses API tercih edildiğinde, görsel üretme aracını destekleyen bir ana model seçiliyor; görsel modeli seçimini araç üstleniyor. Belgedeki örneklerde gpt-6-astra ana modeli ve image_generation aracı kullanılmış. Buradaki model adları, örneklerde dokümante edilen seçeneklerdir; uygulama öncesinde güncel API dokümantasyonunda kullanılabilirliği kontrol etmek gerekir.

API çağrısı yapmak için uygun bir istemci ve API erişimi gerekir. Resmî örneklerde istemci oluşturuluyor, isteğe metin girdisi ekleniyor ve Images API veya Responses API çağrılıyor. Görsel üretme aracının sonucunda dönen görsel verisi örnekte Base64 olarak alınıp PNG dosyasına yazılıyor. Bu akış, API’den gelen görsel sonucunun uygulama içinde kaydedilebileceğini gösteriyor.

Görseli analiz etmek üretimden farklı bir iştir. Görme yeteneği olan bir model, görseli tarif etmek, görünen metni okumak veya nesne, biçim, renk ve doku hakkında yanıt vermek için kullanılabilir. Analiz girdisi, tam URL ya da Base64 kodlu veri URL’si olarak sağlanabilir. Birden fazla görsel tek istekte içerik dizisine eklenebilir; dokümana göre görseller token sayımına ve ücretlendirmeye dâhildir.

Adım adım: mimari görsel promptları

1. Görselin amacını belirleyin

Prompt yazmadan önce çıktının hangi tasarım sorusuna yanıt vereceğini netleştirin: kütle etkisi mi, iç mekân atmosferi mi, malzeme birlikteliği mi? Tek bir istekte çok sayıda farklı hedef vermek yerine, görselin konusunu ve istenen nitelikleri açıkça sıralayın. Aşağıdaki örnekler, mimari görselleştirme için hazırlanmış özgün promptlardır.

2. Kütle ve cephe fikri için üretim isteği hazırlayın

Create a photorealistic architectural concept image of a compact public library on a quiet urban corner. Show a clear street-level view, a restrained stone and timber facade, deep window reveals, soft overcast daylight, a few pedestrians for scale, and a calm civic atmosphere. Keep the building geometry legible and the surrounding context understated.

Bu prompt, yapının işlevini, bakışını, malzeme karakterini, ışığı ve çevre ilişkisini birlikte tarif ediyor. İlk sonuçta cephe fikri kaybolursa promptu yeniden düzenlerken yalnızca ilgili açıklamayı daha belirgin hâle getirin; görsel üretimi için belgede açıklanmayan özel bir parametre varsaymayın.

3. İç mekân atmosferi oluşturun

Create a photorealistic interior concept image of a small reading room with built-in timber shelves, a long communal table, pale mineral walls, and warm indirect lighting. Show the room from eye level, with a clear view of circulation and furniture proportions. Use a quiet, uncluttered composition and soft daylight from tall side windows.

Burada istenen ana unsurlar mekânın kullanımı, sabit donatı, malzeme ve ışık. Görselde ölçü veya uygulama detayı doğrulanmış gibi kabul edilmemeli; prompt, tasarım fikrini görsel olarak araştırmak üzere kurulmuştur.

4. Mevcut görseli düzenleme amacıyla gönderin

Edit the provided interior image by changing the wall finish to a light, matte mineral surface. Preserve the existing room layout, camera viewpoint, furniture positions, and window openings. Do not add new furniture or alter the architecture; keep the lighting and overall composition consistent with the reference.

Mevcut görsel üzerinde düzenleme yapılacaksa, görseli API isteğine girdi olarak ekleyin ve yapılacak değişikliği metinle tarif edin. Bu örnek, yalnızca duvar yüzeyine müdahale edilmesini isterken yerleşim ve bakışın korunmasını da açıkça belirtiyor. Kaynaklar görsel düzenlemeyi destekliyor; ancak her ayrıntının değişmeden kalacağı garanti edilmiyor.

5. Referans görseli analiz ettirin

Describe the visible materials, colors, lighting, and spatial arrangement in the provided architectural image. Separate direct visual observations from uncertain interpretations. Do not infer dimensions, structural performance, or hidden construction details that cannot be seen.

Bu adımda amaç yeni bir görsel üretmek değil, gönderilen görsel hakkında metinsel yanıt almaktır. Görseli URL veya Base64 kodlu veri URL’siyle isteğe ekleyin. Analiz yanıtını gözlem olarak ele alın; dokümantasyon da model yanıtlarının sınırlamalarına dikkat edilmesini öneriyor.

Sık karşılaşılan hatalar

Üretim ile analizi karıştırmak: Yeni görsel elde etmek için görsel üretme uç noktasını veya aracını kullanın. Bir görselde nelerin bulunduğunu sormak için görsel girdisi kabul eden analiz akışını seçin.

Promptu belirsiz bırakmak: “Güzel bir iç mekân üret” gibi kısa bir istek; işlev, bakış, malzeme ve ışık hakkında az yönlendirme verir. Tasarım hedefini birkaç somut nitelikle tarif edin. Buna karşılık birbiriyle çelişen çok sayıda talebi aynı promptta toplamak da sonucu değerlendirmeyi güçleştirebilir.

Analiz sonucunu teknik doğrulama sanmak: Model, görüntüdeki biçim ve malzemeler hakkında yanıt verebilir; fakat görünmeyen ölçüleri veya yapım katmanlarını doğruladığı kabul edilmemeli. Belge, analiz yanıtları değerlendirilirken model sınırlamalarının hesaba katılmasını özellikle belirtiyor.

Çoklu görsel girdisinin maliyetini göz ardı etmek: Bir isteğe birden fazla görsel eklemek mümkün olsa da her görsel token olarak sayılır ve ücretlendirilir. Referans sayısını işin ihtiyacına göre belirleyin.

API model adlarını sabit varsaymak: Dokümantasyondaki örnek isimler ve kullanım biçimleri, uygulama öncesinde güncel resmî belgelerle karşılaştırılmalı. Fiyat, erişim koşulu veya belirli bir proje için uygun model seçimi bu rehberin kaynaklarında belirtilmiyor.

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

Bu yöntem, ofislerde ve öğrencilerin çalışmalarında erken konsept araştırması, atmosfer alternatifi üretimi ve sunum fikri geliştirme aşamalarına katkı sağlayabilir. Mevcut bir görseli düzenleme olanağı, sahneye ilişkin belirli bir görsel değişikliği denemek için kullanılabilir; analiz akışı ise referans görselde görünen nitelikleri tarif ettirmeye yarar. Bunlar, kaynaklarda anlatılan genel API yetenekleridir; belirli bir CAD, BIM veya 3D yazılımıyla doğrudan entegrasyon bilgisi verilmemiştir.

Gerçek iş akışına geçmeden önce API erişimini, kullanılacak modelin güncel durumunu ve ücretlendirmeyi kontrol edin. Referans görsellerin API’ye gönderilmesi ve birden fazla görselin token maliyetine dâhil olması da planlamaya katılmalı. Üretilen görseli proje ölçülerinin, malzeme performansının veya teknik çizimlerin doğrulaması olarak kullanmayın; kaynaklar bu tür bir doğrulama özelliği tanımlamıyor.

Sonraki adımlar

İlk denemede tek bir tasarım hedefi seçin ve sonuçları gözle değerlendirin. Üretim yapıyorsanız konu, malzeme, ışık ve bakış tariflerini açık tutun; düzenleme yapıyorsanız değişmesini istediğiniz unsuru ve korunmasını beklediğiniz özellikleri ayrı ayrı belirtin. Analiz kullanıyorsanız modelden görünen unsurları tarif etmesini isteyin ve çıkarımlarını proje verisiyle karıştırmayın.

İş akışı oturduğunda, aynı tasarım sorusu için farklı prompt taslaklarını karşılaştırmak ve hangi açıklamaların sonucu etkilediğini kaydetmek yararlı olabilir. Ancak bu rehberde belirli bir kalite ayarı, görsel boyutu sınırı veya özel parametre tarif edilmiyor; böyle seçenekler gerekiyorsa güncel API belgeleri incelenmeli.

Kaynak ve lisans

Bu rehber, GPT Image modellerinin API ile görsel üretme, düzenleme ve görsel girdi analizi hakkındaki resmî OpenAI geliştirici belgeleri ile yardım merkezi içeriğinden uyarlanmıştır. Kaynak kayıtlarında K1 ve K2 lisans=serbest olarak belirtilmiştir. Örnek mimari promptlar bu rehber için özgün olarak yazılmıştır.