İçeriğe git
Gündüzden Alacakaranlığa API Otomasyonu: Büyük Ölçekte Alacakaranlık Fotoğrafları
Rehberler

Gündüzden Alacakaranlığa API Otomasyonu: Büyük Ölçekte Alacakaranlık Fotoğrafları

Gündüzden alacakaranlığa dönüştürme artık bir API çağrısıyla çalışıyor. Beş sağlayıcıyı fiyat, seçenekler ve teslimat açısından karşılaştırıyor; iş ve webhook entegrasyonunu adım adım inceliyor, kalite kontrol, toplu strateji ve bildirim konularını ele alıyoruz.

Roomagen
Roomagen Team
3 Ağustos 2026Güncellendi: 24 Ekim 202616 dk okuma3,355 kelime
İçindekiler(9)

Bu güncellemede neler değişti

  • API bölümü güncellendi: ücretsiz API görselleri artık bir paket satın alınana kadar Roomagen filigranı taşır ve her araç belgelenmiştir
  • Kısa ad (slug) kılavuzu güncellendi: day-to-dusk-exterior artık iç mekân gündüzden alacakaranlığa kısa adının yanında belgelenmiştir
Önceki güncellemeler(1)
    • Roomagen'in API ayrıntıları düzeltildi: 30 Ağustos 2026'dan bu yana self-servis anahtarlar (bekleme listesi yok), ilk anahtarda 50 ücretsiz görsel, 20–60 saniyelik işler ve cepheler için ayrı day-to-dusk-exterior kısa adı
    • Sağlayıcı karşılaştırmasına Virtual Staging AI ve Collov kurumsal plan fiyatlarıyla eklendi; AI HomeDesign (ücretsiz krediyle kayıt, yıllık faturalandırmada fotoğraf başına 0,24 $) ve InstantDeco plan fiyatları güncellendi
    • Birincil kaynağına ulaşamadığımız alacakaranlık istatistikleri (%66 daha fazla görüntüleme, 3 kat gösterim, ilanların %8'i) HomeJab sipariş verileri, PhotoUp 2026 çekim fiyatları ve BoxBrownie'nin güncel gündüzden alacakaranlığa liste fiyatlarıyla değiştirildi
    • Webhook imza doğrulama örneği, aynı etkiyi koruma (idempotency) ve hız sınırı rehberliği, entegrasyon kontrol listesi ve değiştirilmiş görseller üzerine tam AB 723 metni eklendi

Gündüzden alacakaranlığa API'si, gündüz çekilmiş bir dış mekân fotoğrafını HTTP üzerinden alacakaranlık versiyonuna dönüştürür: görseli gönderirsiniz ve sonucu genellikle webhook veya yoklama (polling) ile alırsınız. AI HomeDesign, InstantDeco, Virtual Staging AI, Collov ve Roomagen böyle bir API belgelemektedir.

Bu iş için araç

Gündüzden Alacakaranlığa Fotoğraf Düzenleme

Gündüz çekilmiş bir dış cephe veya oda fotoğrafını sıcak pencere ışıltısıyla gün batımı, alacakaranlık veya gece fotoğrafına dönüştürün. Saati 24 saatlik bir kaydırıcıda seçin; fotoğraf başına 2 kredi.

Ücretsiz Dene

Gündüzden Alacakaranlığa API'si Ne Yapar — ve Kimin İhtiyacı Vardır?

Gündüzden alacakaranlığa API'si, bir binanın gündüz çekilmiş bir fotoğrafını alır ve alacakaranlık versiyonunu döndürür: daha karanlık, ton geçişli bir akşam gökyüzü, açılmış iç mekan ışıkları ve yeni saate uyum sağlayan bir ortam ışığı. Görseli bir HTTP isteğiyle gönderirsiniz, sağlayıcı üzerinde üretken bir görsel modeli çalıştırır ve sonucu webhook veya yoklama (polling) yoluyla alırsınız. Dosyaya hiçbir editör dokunmaz, asıl mesele de budur: dönüştürme işlemi bir satın alma siparişi yerine bir işlem hattı (pipeline) adımı haline gelir.

Alacakaranlık çekimleri üretmek her zaman zahmetli olmuştur. Gerçek bir alacakaranlık çekimi, doğru saatte ikinci bir ziyaret ve elverişli hava koşulları gerektirir; manuel düzenleme ise insan gücüne dayalı bir iş kuyruğunda ilerler. Yine de talep artıyor. Gayrimenkul fotoğrafçılığı şirketi HomeJab'de sanal alacakaranlık, "2025'in en hızlı büyüyen geliştirmesi" oldu ve "ortalama sipariş hacmi 2024 ortasındaki sadece %1 seviyesinden Eylül 2025 itibarıyla %7'nin üzerine çıktı" (HomeJab). Bu durum tek bir şirketin sipariş dağılımıdır, tüm sektörün sayımı değildir; ancak fotoğraf satın alanların bütçelerini nereye harcadığını göstermektedir.

Ayrıca alacakaranlık fotoğraflarının ilan görüntülemelerini veya gösterimleri belirli bir oranda artırdığını iddia eden yaygın verilerle de karşılaşabilirsiniz. Bunları dahil etmedik: izini sürdüklerimiz birincil bir araştırmaya dayanmıyordu.

Tek bir ilanı olan tek bir emlak danışmanı için bir web uygulaması yeterlidir. API konusu, alacakaranlık işleminin kimse tıklamadan ayda yüzlerce kez gerçekleşmesi gerektiğinde ortaya çıkar: alacakaranlığı ilan başına ek hizmet olarak satan gayrimenkul fotoğrafçılığı şirketleri, tüm katalogdaki kapak görsellerini yükselten ilan portalları, materyalleri otomatik olarak üreten emlak ofisi pazarlama ekipleri, her mülk için bir akşam vitrin çekimi isteyen otel ve kısa dönem kiralama platformları, tamamlanmış bir binayı akşam ışığında gösteren mimarlar ve alacakaranlığı bir hizmet sağlayıcı ilişkisi yerine bir özellik olarak sunmak isteyen proptech ürünleri.

Bir Alacakaranlık Çekimi Elde Etmenin Üç Yolu: Genel Bir Bakış

Yöntem Görsel başına maliyet Teslim süresi Nasıl ölçeklenir Hava durumu riski
Gerçek alacakaranlık çekimi Bir alacakaranlık fotoğrafı için 200 $–750 $ (PhotoUp'ın 2026 tahmini) Alacakaranlıkta tekrar ziyaret Akşam başına bir adet kısa alacakaranlık aralığıyla sınırlıdır Yüksek
Manuel düzenleme hizmeti BoxBrownie'de gündüzden alacakaranlığa düzenleme başına 4–5 ABD Doları (Ekim 2026) 24 saat içinde (BoxBrownie'nin belirtilen taahhüdü) İnsan gücüne dayalı düzenleme kuyruğu Yok
Gündüzden alacakaranlığa API'si Aşağıda karşılaştırılan yayınlanmış tarifelerin çoğunda yaklaşık 0,05 $–0,25 $; bazı planlar ve aylık faturalandırma daha pahalıdır İş başına saniyeler veya dakikalar (Roomagen belgeleri: genellikle 20–60 saniye) Her sağlayıcının istek sınırlarına (rate limits) kadar paralel işler Yok

Gerçek bir alacakaranlık çekimi hâlâ referans noktasıdır. Alacakaranlıkta sahada olan bir fotoğrafçı gerçek ortam ışığını, gerçek yansımaları ve evin içindeki gerçek ışıkları kaydeder; hiçbir şeyin tahmin edilmesi gerekmez. Sabit bir saatte ayrı bir seyahat gerektirdiği için maliyeti daha yüksektir: PhotoUp'ın 2026 fiyatlandırma kılavuzu, "temel bir gündüz çekimi bir dizi sabit fotoğraf için 200 ila 400 dolara mal olabilirken, alacakaranlık fotoğrafı için bu tutarın 200 ila 750 dolar arasında olduğunu" belirtmektedir (PhotoUp). Bulutlu bir akşam, çekimin yeniden planlanması anlamına gelir.

Manuel düzenleme hizmetlerinde, gündüz fotoğrafını bir insan dönüştürür. BoxBrownie'nin fiyatlandırma sayfası, Ekim 2026'daki kontrollerimizin bazılarında gündüzden alacakaranlığa dönüştürmeyi görsel başına 4,00 ABD Doları, bazılarında ise 5 ABD Doları olarak göstermiştir; bu nedenle size gösterilen fiyatı teyit edin (BoxBrownie fiyatlandırması). Hizmet sayfası, gündüzden alacakaranlığa projeleri için "görsellerinizi 24 saat içinde tamamlama garantisi veriyoruz" demektedir (BoxBrownie). Bu durum tek bir ilan için uygundur; insan gücüne dayalı bir kuyruk, binlerce fotoğrafta aynı gün tamamlanması gereken bir adım olarak çalışamaz.

API dönüştürme, fotoğraf üzerinde programatik olarak üretken bir model çalıştırır. Üç yöntem arasında bir altyapı gibi davranan tek seçenektir: bir yükleme akışına entegre edebilir, gece boyunca toplu olarak çalıştırabilir ve ilan başına kâr marjınıza dahil edebilirsiniz. Buradaki ödünleşim, modelin hiç görmediği ışığı tahmin etmesidir; bu nedenle bir kalite kontrolüne ve bir bildirim planına ihtiyacınız vardır.

Başarılı Bir Gündüzden Alacakaranlığa Dönüştürme Neler Gerektirir?

Gündüzden alacakaranlığa dönüştürme, inandırıcı şekilde otomatikleştirilmesi en zor düzenlemelerden biridir; çünkü model, kaynak görselde karanlık olan ışık kaynaklarını yakmak ve etraflarındaki her şeyi yeniden aydınlatmak zorundadır. İster bir sağlayıcıyı değerlendiriyor ister kendi çıktılarınızı denetliyor olun, beş noktayı kontrol edin.

Pencere ışıltısı. Aydınlatılmış pencereler, bir alacakaranlık fotoğrafındaki "evde biri var" sinyalidir. İyi bir dönüştürme; sıcak ve tutarlı bir renk sıcaklığı kullanır, parlaklığı odalar arasında çeşitlendirir ve bazı pencereleri karanlık bırakır. Her pencerenin tamamen aynı parlaklıkta parlaması, zayıf bir dönüştürmenin tipik bir işaretidir.

Gökyüzü ton geçişi. Bir alacakaranlık gökyüzü, tepedeki koyu maviden, güneşin battığı taraftaki ufka yakın sıcak tonlara doğru geçiş yapar. Düz tek renkli gökyüzlerine ve gölgelerle çelişen ufuk ışıltılarına dikkat edin.

Ortam ve yansıma tutarlılığı. Gökyüzü değiştiğinde, dokunduğu her şey onunla birlikte değişmelidir: kaldırımlar koyulaşır, cam ve su yeni gökyüzünü yansıtır ve sert öğle gölgeleri yumuşar. Öğle ışığıyla aydınlatılmış bir çim üzerindeki alacakaranlık gökyüzü, bir gündüzden alacakaranlığa dönüştürme değil, bir gökyüzü değişimi işlemidir.

Yapısal koruma. Bina değişmemelidir: kaymış çatı hatları, yeniden boyanmış dış cephe kaplamaları veya yeni veranda ışıkları ve bahçe armatürleri olmamalıdır. İlan fotoğrafları için bu hem bir uyumluluk hem de bir kalite konusudur; çünkü fiziksel mülkü değiştiren bir düzenleme, iyileştirme sınırını aşıp yanıltıcı tanıtmaya girer.

Manzara ve çevre. Pencerelerden ve binanın etrafından görünen unsurlar olduğu gibi kalmalıdır. Bazı API'ler kasıtlı olarak farklı bir manzara veya mevsim oluşturabilir; gerçek bir taşınmazın pazarlanmasında bu seçenekleri kapalı tutun.

Hizmet sağlayıcı denemeleri ve devam eden denetimler için bir inceleme kontrol listesi:

Kontrol Başarılı durum Başarısız durum
Pencere ışıltısı Sıcak, değişken parlaklık; bazı pencereler karanlık Her pencere eşit derecede parlak
Gökyüzü ton geçişi Tepede koyu mavi, sıcak ufuk, tek bir güneş yönü Düz tek renkli gökyüzü; ışıltı gölgelerle çelişiyor
Ortam tutarlılığı Zemin, cam ve su yeni gökyüzünü yansıtıyor Gün batımı gökyüzü altında öğle ışığıyla aydınlatılmış çim
Yapı Bina ve sabit tesisat kaynaktaki gibi Yeni ışıklar, değişmiş dış cephe kaplaması veya geometri
Manzara ve çevre Kaynaktaki ile aynı manzara, ağaçlar ve komşular Yeni manzara, farklı mevsim, eksik direkler veya kablolar

Otomatik işlem hatları için, çıktıların sabit bir oranını her hafta bu tabloya göre örneklem denetiminden geçirin ve kötü bir görsel işlemenin destek talebi yerine programatik bir yola sahip olması için lansmandan önce yeniden oluşturma politikanızı belirleyin. Gökyüzü işin kolay kısmıdır; dönüştürmelerin asıl farklılaştığı yer pencere ışıltısı ve ortam tutarlılığıdır.

2026'da Gündüzden Alacakaranlığa API Pazarı

Birçok araç bir web arayüzünde gündüzden alacakaranlığa dönüştürme yapar. Ancak çok daha azı bunu üzerine geliştirme yapabileceğiniz bir API olarak belgeler. Ekim 2026'da yayınlanan fiyatlarıyla bu beş araç bunu sunmaktadır:

Sağlayıcı Gündüzden alacakaranlığa nasıl sunulur Sonuç teslimi Yayınlanan fiyat Notlar
AI HomeDesign REST API'sindeki beş hizmetten biri Webhook'lar Yıllık faturalandırmada fotoğraf başına 0,24 $ (ayda 200 fotoğraf için yılda 588 $); yıllık faturalandırma "aylığa kıyasla %51 tasarruf sağlar" Kayıtta ücretsiz krediler; çıktılar AI HomeDesign markalaması taşımaz
InstantDeco day_to_dusk dönüşüm türü: "Görseli karartır, iç mekan ışıklarını açar ve gökyüzünü alacakaranlığa dönüştürür" Görsele bir bağlantı içeren webhook_url geri çağırması (callback) 500 fotoğraf için yıllık faturalandırmada ayda 49 $ veya aylık 79 $; 2.000 fotoğraf için 99 $ veya 139 $; ek fotoğraflar 0,05 $–0,15 $ Planın tam kullanımında fotoğraf başına yaklaşık 0,05 $–0,16 $; istenildiği zaman iptal edilebilir
Virtual Staging AI v2 API'sinde Alacakaranlık, Altın Saat ve Mavi gökyüzü stillerine sahip gündüzden alacakaranlığa işleme türü Webhook'lar (üretim ortamı için önerilir) veya eşzamanlı bekleme API erişimi Enterprise planıyla gelir: 150 fotoğraf için yıllık faturalandırmada ayda 79 $; gündüzden alacakaranlığa tarifesi listelenmemiştir Aynı API üzerinde sahneleme ve geliştirme
Collov Enterprise API'sinde "Sanal alacakaranlık" ve "doğal alacakaranlık" uç noktaları Alacakaranlık çağrıları oluşturulan görselin URL'sini döndürür; asenkron görevleri yoklanır API erişimi Enterprise planıyla gelir: 526 fotoğraf kredisi için yıllık faturalandırmada ayda 127 $; ek fotoğraflar 0,24 $ Belgelenen limitler: saniyede 10 istek, 2 eşzamanlı görev
Roomagen gündüzden alacakaranlığa API'si Her ikisi de belgelenmiş day-to-dusk ve day-to-dusk-exterior, tek bir iş API'sinde İmzalı webhook'lar veya yoklama Ön ödemeli paketlerde görsel başına 0,20 $–0,25 $: 125 $'a 500, 550 $'a 2.500, 2.000 $'a 10.000 İlk anahtarda 50 ücretsiz görsel, siz bir paket satın alana kadar filigranlıdır; başarısız işler otomatik olarak iade edilir

Roomagen bizim kendi API'mizdir, bu nedenle mevcut durumu şöyledir: anahtarlar 30 Ağustos 2026'dan beri self-servis olarak sunulmaktadır, paketlerin süresi asla dolmaz ve birbirine eklenir, tek bir anahtar belgelenmiş her aracı kapsar ve görsel araçlarımız Google'ın Gemini görsel modelleri üzerinde çalışır. Aşağıdaki uygulamalı örnek, iki gündüzden alacakaranlığa slug'ından hangisinin kullanılacağını açıklamaktadır.

Liste nasıl daraltılır:

  • Push teslimata mı ihtiyacınız var? AI HomeDesign, InstantDeco, Virtual Staging AI ve Roomagen webhook'ları belgeler; Collov'un belgeleri yoklamayı (polling) açıklar ve iki eşzamanlı görev sınırı büyük toplu geçmiş yüklemeleri (backfill) için önem taşır.
  • En düşük yayınlanan tarife mi? InstantDeco bu tablodaki en düşük fotoğraf başı tarifelere sahiptir ve aylık faturalandırma sunar; hacim taahhüdünde bulunmadan önce kalite testi ve yeniden oluşturmalar için bütçe ayırın.
  • Abonelik istemiyor musunuz? Roomagen ön ödemeli paketler satar; diğer dördü plan satar ve yukarıdaki AI HomeDesign, Virtual Staging AI ve Collov fiyatları yıllık faturalandırmayı varsayar.
  • Görünüm üzerinde kontrol mü? Roomagen 0'dan 23'e kadar bir hedef saat alır, Virtual Staging AI üç gökyüzü stili sunar ve Collov iki alacakaranlık varyantı sunar.
  • Her zaman: Kendi dış mekan çekimlerinizden aynı 20–50 fotoğrafı kısa listeye aldığınız her API'de çalıştırın ve yukarıdaki kontrol listesiyle puanlayın.

Aynı aramalarda yakın bir kategoriye dikkat edin. Gökyüzü değişimi, bazen alacakaranlık renkli bir gökyüzüyle sadece gökyüzünü değiştirir; pencereleri, zemini ve yansımaları olduğu gibi bırakır. Bir hizmet sağlayıcının demosu değişmiş bir gökyüzü ancak değişmemiş pencereler ve gölgeler gösteriyorsa, alacakaranlık dönüştürmesi olarak fiyatlandırılmış bir gökyüzü değişimi işlemine bakıyorsunuz demektir.

Süreci Otomatikleştirmek: Uygulamalı Bir Örnek

İşte Roomagen'in API'sindeki otomasyon döngüsü. Bu yapı (bir iş gönderme, bir geri çağırma alma, sonucu saklama, hataları yönetme), farklı alan adlarıyla diğer sağlayıcılara da uyarlanabilir. Referansın tamamı Roomagen API hızlı başlangıç kılavuzundadır.

0. Adım: doğru slug'ı seçin. GET /v1/tools, anahtarınızın çağırabileceği her slug'ı döndürür; isimleri koda sabit olarak yazmak (hardcoding) yerine buradan okuyun. Burada iki tanesi önemlidir:

  • day-to-dusk iç mekan slug'ıdır. Web uygulamamızdaki Zaman Değiştirici ile aynı aracı çalıştırır: 0 ile 23 arasında bir hedef saat (timeShift, varsayılan 20), isteğe bağlı bir pencere manzarası (viewType, gerçek manzarayı koruyan varsayılan none), yalnızca oluşturulan bir manzara için geçerli olan bir season ve penceresiz odalar için hasWindows.
  • day-to-dusk-exterior, Zaman Değiştirici Dış aracının arkasındaki dış cephe aracıdır. Önce fotoğrafı analiz eder, ardından saati (timeShift, varsayılan 20) ve isteğe bağlı bir season parametresini uygular. 3 Ekim 2026'dan beri belgelenmiştir; iş akışınızda ona bağımlı hale gelmeden önce kendi dış mekanlarınızda test edin.

1. Adım: işi gönderin. Gündüz çekilmiş dış mekanı URL ile gönderin:

curl -X POST https://api.roomagen.com/api/v1/jobs \
  -H "X-Api-Key: $ROOMAGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: listing-1042-front-dusk" \
  -d '{
    "tool": "day-to-dusk-exterior",
    "image_url": "https://cdn.example.com/listing-1042/front.jpg",
    "options": { "timeShift": 20 },
    "webhook_url": "https://example.com/hooks/roomagen"
  }'

API, bir job_id, "status": "processing" ve images_charged bilgisiyle hemen 201 yanıtı verir: varsayılan 2K'da bir görsel, options içine "resolution": "4K" eklerseniz iki görsel ücretlendirilir. Kaynak, 20 MB'a kadar JPEG, PNG veya WebP sunan genel bir https URL'si ya da image_base64 olarak satır içi iletilen dosya olmalıdır. Idempotency-Key yeniden denemeleri güvenli hale getirir: bir zaman aşımından sonra aynı anahtar ve gövde, ikinci bir ücretlendirme olmadan orijinal işi döndürür. Bunu saklamadığınız rastgele bir değerden değil, her zaman ilan ve fotoğraf kimlikleri (ID) gibi kendi kayıtlarınızdan türetin.

2. Adım: sonucu alın. Roomagen'in belgeleri, işlerin genellikle 20–60 saniyede hazır olduğunu belirtir. İşte bir webhook_url tanımlandığında (veya geliştirici portalında hesap genelinde bir uç nokta ayarlandığında), Roomagen tamamlanan işi size POST ile iletir: GET /v1/jobs/{id} nesnesinin döndürdüğü veriye ek olarak job.completed veya job.failed olarak ayarlanmış bir event alanı gelir. Önce imzayı doğrulayın. Bu, whsec_ gizli anahtarınızla imzalanmış, zaman damgası ve ham istek gövdesi üzerindeki bir HMAC-SHA256'dır:

import crypto from "node:crypto";
import express from "express";

const app = express();

app.post("/hooks/roomagen", express.raw({ type: "application/json" }), async (req, res) => {
  const ts = req.get("X-Roomagen-Timestamp") ?? "";
  const sig = req.get("X-Roomagen-Signature") ?? "";
  const expected = "v1=" + crypto
    .createHmac("sha256", process.env.ROOMAGEN_WEBHOOK_SECRET)
    .update(`${ts}.${req.body}`)
    .digest("hex");
  const got = Buffer.from(sig);
  const want = Buffer.from(expected);
  const fresh = Math.abs(Date.now() / 1000 - Number(ts)) < 300;
  // Bayt uzunluklarını önce karşılaştırın: timingSafeEqual farklı olduklarında hata fırlatır.
  if (!fresh || got.length !== want.length || !crypto.timingSafeEqual(got, want)) {
    return res.sendStatus(401);
  }
  const job = JSON.parse(req.body);
  await enqueueResult(job); // sizin kodunuz: job.job_id üzerinde tekilleştirin, ardından saklayın
  res.sendStatus(200);
});

Teslimat, sıralama garantisi olmaksızın en az bir kez (at-least-once) gerçekleşir ve başarısız bir teslimat, yaklaşık 36 dakika içinde beş denemeye kadar tekrar denenir. Webhook'ları kesin bir kayıt sistemi (system of record) olarak değil, bir optimizasyon olarak değerlendirin: elinize hiç ulaşmayan durumları GET /v1/jobs/{id} ile mutabakat yaparak çözümleyin. Düşük hacimli komut dosyaları için her 2–5 saniyede bir yoklama (polling) yapmak uygundur; completed veya failed durumunda işlemi durdurun.

3. Adım: ikiliyi saklayın. Görsel işlemeyi result_urls üzerinden indirin ve ilana ekleyin. Sonuçlar Roomagen depolama alanından saklama süreleri sınırları dahilinde sunulur, bu nedenle doğrudan bağlantı vermek (hot-linking) yerine kendi kopyanızı saklayın ve orijinal gündüz fotoğrafını, iş kimliğini (job ID) ve bir "değiştirilmiş" işaretini aynı kayıtta tutun. İş nesnesi orijinalleri değil, sonuçları döndürür ve bildirim ile kalite kontrolü için orijinal fotoğrafa ihtiyacınız olacaktır. Çıktılar, hesap bir paket satın alana kadar bir Roomagen filigranı taşır; sonrasında API çıktısı hiçbir Roomagen markalaması veya filigranı taşımaz.

4. Adım: hataları kod içinde yönetin. Bazı işler gönderim sırasında reddedilir (invalid_image, image_fetch_failed), çok azı ise görsel oluşturma sırasında başarısız olur (generation_failed) ve status: "failed", insan tarafından okunabilir bir error ve otomatik bir para/kredi iadesi ile sonuçlanır. Mantıklı bir politika: bir kez yeniden deneyin, ardından gündüz fotoğrafını yayınlayın ve ilanı incelenmek üzere işaretleyin. Herhangi bir sağlayıcıda, başarısız bir oluşturma işleminin ne kadara mal olduğunu öğrenin; çünkü iadesi olmayan başarısızlıklar, görsel başına gerçek maliyetinizi sessizce artırır.

Tüm entegrasyon bundan ibarettir: bir POST, bir webhook işleyici, bir depolama adımı ve bir hata dalı. Aynı istek yapısı Roomagen'in sanal sahneleme, sanal tadilat ve yenileme, fotoğraf geliştirme, fotoğraflardan AI nesne ve öğe kaldırma ve kat planından 3D'ye gibi diğer belgelenmiş araçlarını da kapsar; bu nedenle yeni bir araç eklemek yeni bir entegrasyon değil, yalnızca yeni bir tool değeri ve options anlamına gelir. Ön yüze sahip daha kapsamlı bir anlatım için sanal sahneleme API'si eğitimimize göz atın.

Fotoğraf Şirketleri ve Portallar İçin Toplu İşlem Stratejisi

Tek fotoğraf dönüştürme işin demosudur; toplu dönüştürme ise asıl iş modelidir. Medya şirketleri ve ilan platformları için toplu dönüştürmeyi çalışır kılan dört model bulunmaktadır.

Kitaplığın tamamını değil, kapak dış mekan fotoğrafını dönüştürün. Alacakaranlık versiyonunu ilk görüldüğü yere, yani arama sonuçlarındaki ve ilan kartlarındaki kapak fotoğrafına koyun ve ilan başına bir ön dış cephe fotoğrafını dönüştürün. Bu, maliyeti ilan başına tek bir görselde tutar ve bir fotoğrafçılık şirketinin alacakaranlığı ek bir hizmet olarak fiyatlandırmasının en basit yoludur.

Toplu geçmiş yüklemeleri (backfills) bir gece işi olarak çalıştırın. Alacakaranlık kapağı olmayan ilanları sorgulayın, ilan ve fotoğraf kimliklerinden oluşturulmuş idempotency key'ler ile işleri gönderin, webhook'ları toplayın ve sabah yayınlayın. Hız sınırları dahilinde kalın: Roomagen anahtar başına dakikada 60 iş gönderimini kabul eder, bu nedenle 1.000 fotoğraflık bir geçmiş yüklemenin yalnızca gönderilmesi yaklaşık 17 dakika sürer. Önce anahtarın hâlâ kaç görsel işleyebileceğini döndüren GET /v1/account çağrısını yapın ve sürecin ortasında kalmak yerine düşük bakiye uyarısını işlem başlamadan önce alın.

Kâr marjı hesabını API çağrısı başına değil, kullanılabilir görsel başına yapın. Roomagen'in paketlerinde bir görsel 0,20 $–0,25 $ tutarındadır. Ayda 500 kapağı dönüştüren bir fotoğraf şirketi, BoxBrownie'nin 4–5 ABD Doları olan liste fiyatlarıyla aynı 500 düzenleme için gereken 2.000–2.500 ABD Dolarına kıyasla 125 $ harcar. Ardından yeniden oluşturma oranınızı ekleyin: her beş görselden biri ikinci bir denemeye ihtiyaç duyuyorsa, 0,25 $'lık bir görsel kullanılabilir sonuç başına 0,30 $'a mal olur. Üzerine eklenecek kalite kontrol süresiyle bile, manuel düzenlemeyle ve 200 $–750 $'lık alacakaranlık çekimleriyle olan fark oldukça açık kalır. İlk anahtar, test için 50 ücretsiz görselle birlikte gelir.

Kod yazmıyor musunuz? Web uygulamasında toplu işlemi kullanın. Entegrasyon yapmak istemeyen ekipler, Roomagen'in web uygulamasında aynı anda birkaç fotoğrafta Zaman Değiştirici'yi çalıştırabilir. Ücretli planlarda, Kitaplık'taki fotoğrafları işaretleyin veya birlikte sürükleyip bırakın: Starter her toplu işlemde 3 fotoğraf, Pro 7 ve Business 20 fotoğraf alır ve her toplu işlemde tek bir araç kullanılır. Her toplu işlem, canlı ilerleme durumu ve bir ZIP indirmesi içeren kendi Kitaplık klasörünü alır; başarısız fotoğrafların kredisi iade edilir ve Zaman Değiştirici, pencereleri, manzarayı ve mevsimi fotoğraf başına ayarlamanıza olanak tanır. API'de toplu işlem uç noktası yoktur; orada görsel başına bir iş gönderirsiniz.

Bir Fotoğraf Ne Zaman Dönüştürülmemelidir?

Otomatik bir işlem hattının açık atlama ve yönlendirme kurallarına ihtiyacı vardır, çünkü her fotoğraf bir alacakaranlık fotoğrafı olmamalıdır.

Zaten alacakaranlık veya gece çekimi olan fotoğrafları atlayın. Gerçek bir alacakaranlık fotoğrafını tekrar dönüştürmekten elde edilecek hiçbir şey yoktur ve ikinci bir geçiş onu aşırı karartabilir. İşlem hattınız çekim zamanını EXIF verilerinden veya parlaklıktan güvenilir bir şekilde belirleyemiyorsa, belirsiz görselleri körü körüne dönüştürmek yerine insan incelemesine gönderin.

İç ve dış mekanları doğru araca yönlendirin. Bir dış mekan dönüştürmesi dış cephe, gökyüzü ve dışarıdan görünen pencerelerle ilgilidir; bir iç mekan dönüştürmesi ise oda ışığı ve camdan görünen manzara ile ilgilidir. Fotoğrafları önce sınıflandırın ve her birini eşleşen araca gönderin (Roomagen'de day-to-dusk-exterior veya day-to-dusk). Penceresiz odaları atlayın veya modele doldurulacak pencere olmadığını belirten hasWindows: false değerini gönderin.

Yetersiz kaynak materyalleri atlayın. Güçlü ters ışığa sahip dış cepheler, hareket bulanıklığı ve düşük çözünürlüklü fotoğraflar zayıf alacakaranlık çıktıları verme eğilimindedir; çünkü model, kaynakta belirsiz olan her şeyi büyütür. Bunları önce fotoğraf geliştirme veya HDR fotoğraf editörü ile düzeltin ya da yeniden çekim yapın.

Gerçek bir ilanın manzarasını değiştirmeyin. Bizimki de dahil olmak üzere bazı API'ler, pencerelerden farklı bir manzara veya farklı bir mevsim oluşturabilir. Belgelerimiz bunu açıkça ortaya koymaktadır: "Işığı özgürce değiştirin; gerçekleri bilinçli olarak değiştirin." İlan fotoğrafları için viewType ve season seçeneklerini none olarak bırakın.

Mevzuata uyum sınırının nerede olduğunu bilin. California'nın AB 723 sayılı yasası Business and Professions Code §10140.8 maddesini eklemiştir ve eyaletin gayrimenkul düzenleyicisi şunları söylemektedir: "1 Ocak 2026 itibarıyla, lisans sahipleri gayrimenkul reklamlarında dijital olarak değiştirilmiş görseller kullanırken Bus. & Prof. Code bölüm 10140.8'e de uymak zorundadır" (California DRE). Yasa, "pencerelerden görünen manzaralar" gibi "taşınmazın dışındaki veya taşınmazdan görülebilen unsurlar" da dahil olmak üzere "unsurları eklemek, kaldırmak veya değiştirmek" amacıyla değiştirilen görselleri kapsar. "Yalnızca taşınmazın temsilini değiştirmeyen aydınlatma, keskinleştirme, beyaz dengesi, renk düzeltme... veya diğer yaygın fotoğraf düzenleme ayarlamalarının yapıldığı" görselleri kapsam dışında tutar (AB 723). AI ile yapılan bir alacakaranlık dönüştürmesi gökyüzünü değiştirir ve karanlık olan kaynakları aydınlatır; bu nedenle temkinli yaklaşım, bunu değiştirilmiş olarak kabul etmektir: §10140.8'in gerektirdiği gibi, görselin üzerine veya hemen yanına bir bildirim ifadesi koyun ve değiştirilmemiş orijinaline bağlantı verin. MLS kuralları kendi etiketlerini ve fotoğraf sırası gereksinimlerini ekler; AB 723 kılavuzumuz ve MLS fotoğraf gereksinimleri kılavuzumuz ayrıntıları ele almaktadır.

Sorumluluk araçta değil, reklamı verendedir. Aynı duyuru, bir AI aracının yanıltıcı reklam üretmesi durumunda, "mevcut yasalar kapsamındaki sorumluluğun teknoloji sağlayıcısına değil, lisans sahibine ve onun sorumlu broker'ına ait olduğunu" belirtmektedir. Danışmanlar için fotoğrafları dönüştüren bir platform işletiyorsanız, işlem hattınız boyunca değiştirilmiş işaretini ve orijinal görseli taşıyarak bildirimi kolaylaştırın. Roomagen'in API'si bildirim etiketleri eklemez veya orijinalleri sizin adınıza saklamaz; bu nedenle bunu kendi kayıt sisteminize entegre edin.

Entegrasyon Kontrol Listesi

  1. Kendi dış mekan çekimlerinizden aynı 20–50 fotoğrafı iki veya üç sağlayıcıda çalıştırın ve bunları yukarıdaki beş kontrolle puanlayın.
  2. Pazarlama isimlerini koda sabit yazmak yerine slug'ları API'den okuyun (Roomagen'de GET /v1/tools).
  3. Yeniden denemenin asla iki kez ücretlendirilmemesi için idempotency key'leri ilan ve fotoğraf kimliklerinden türetin.
  4. Üretim ortamında webhook'ları kullanın, her imzayı doğrulayın, iş kimliği (job ID) üzerinden tekilleştirme yapın ve eksik geri çağırmaları yoklama (polling) ile çözümleyin.
  5. Orijinali, sonucu, iş kimliğini ve bir "değiştirilmiş" işaretini birlikte saklayın; doğrudan bağlantı vermek yerine sonuçları indirin.
  6. Dış ve iç mekanları doğru araca yönlendirin ve zaten alacakaranlık olan fotoğrafları atlayın.
  7. Gerçek ilanlar için manzara ve mevsim seçeneklerini kapalı bırakın.
  8. Her toplu işlemden önce kalan bakiyeyi kontrol edin.
  9. Önceden kararlaştırılmış bir yeniden oluşturma politikasıyla, çıktıların sabit bir oranını her hafta örneklem denetiminden geçirin.
  10. Dönüştürülen bir görselin yayınlandığı her yerde bir bildirim ve orijinaline bir bağlantı gösterin.

Sonuç

Alacakaranlık fotoğrafları; talebin, ekonominin ve araçların aynı doğrultuyu işaret ettiği bir alandır. Sanal alacakaranlık, 2025'te HomeJab'in en hızlı büyüyen geliştirmesiydi; manuel bir düzenlemenin dolar, alacakaranlık çekiminin yüzlerce dolar tuttuğu bir yerde API dönüştürmesi sentler mertebesindedir ve artık en az beş sağlayıcı bir gündüzden alacakaranlığa API'sini belgelemektedir. Fotoğraf şirketleri, portallar, konaklama platformları ve proptech ürünleri için gündüzden alacakaranlığa işlemi, bir fotoğrafçılık kararından ziyade bir altyapı kararı (webhook içeren bir işlem hattı adımı, bir iade politikası ve bir kalite kontrol listesi) haline gelmiştir. Fiyatlandırmayı kullanılabilir görsel başına yapın, atlama kurallarını ve bildirim meta verilerini ilk günden itibaren sisteme dahil edin.

Kod yazmadan önce çıktıyı değerlendirmek için Roomagen'in web uygulamasındaki gündüzden alacakaranlığa fotoğraf düzenleme & dönüştürme aracını deneyin; dış cepheler için kullanılan mod gündüzden alacakaranlığa dış mekan aracıdır. Ücretsiz planın tek seferlik 6 kredisi, üç filigranlı işlemi kapsar. Otomatikleştirmeye hazır olduğunuzda, gündüzden alacakaranlığa API sayfasında fiyatlandırma yer almaktadır ve ilk API anahtarınız 50 ücretsiz görselle birlikte gelir.

İlanlarınızı dönüştürmeye hazır mısınız?

Roomagen'in yapay zeka sanal ev düzenleme aracını ücretsiz deneyin. İlk fotoğrafınızı yükleyin; sonuç genellikle bir dakikadan kısa sürede hazır olur.

Ücretsiz Başla

Sıkça Sorulan Sorular

Gündüzden alacakaranlığa API'si, bir binanın gündüz çekilmiş fotoğrafını HTTP üzerinden alacakaranlık versiyonuna dönüştürür. Görüntüyü gönderirsiniz, üretici bir model gökyüzünü karartır, iç ışıkları açar ve ortam ışığını ayarlar; sonucu ise webhook veya yoklama (polling) ile alırsınız.

Yayınlanan API ücretleri InstantDeco planlarında fotoğraf başına yaklaşık 0,05 $ ila 0,16 $, AI HomeDesign'ın yıllık faturalandırmasında 0,24 $ ve Roomagen'in ön ödemeli paketlerinde 0,20 $ ila 0,25 $ arasında değişmektedir. Karşılaştırma yapmak gerekirse BoxBrownie, manuel gündüzden alacakaranlığa düzenlemelerini 4 US$ ila 5 US$ olarak listelerken PhotoUp, bir alacakaranlık çekimi için 200 $ ila 750 $ maliyet öngörmektedir.

Roomagen'in API dokümantasyonu, işlerin genellikle 20 ila 60 saniyede hazır olduğunu belirtmektedir; diğer sağlayıcılar için kendi görsellerinizle test yapın. İşler asenkron çalışır; bu nedenle işi birkaç saniyede bir yoklarsınız veya bir webhook alırsınız ve hız sınırları dahilinde birçok görsel paralel olarak işlenebilir.

AI HomeDesign, InstantDeco, Virtual Staging AI, Collov ve Roomagen API'lerinde gündüzden alacakaranlığa veya alacakaranlık dönüştürme özelliklerini belgelemektedir. Teslimat yöntemleri (webhook veya yoklama), faturalandırma (abonelikler veya ön ödemeli paketler) ve gökyüzü stili ya da hedef saat gibi kontroller açısından farklılık gösterirler; bu yüzden bunları kendi fotoğraflarınızda test edin.

Gerçek bir alacakaranlık çekimi gerçek ışığı, yansımaları ve yanan armatürleri kaydederken AI dönüştürme bunları tahmin eder; bu nedenle gerçek bir çekim kalite referansı olmaya devam eder. İyi bir dönüştürme, ilan kapak görseli olarak harika bir iş çıkarabilir; ancak tekdüze pencere parlaması, tutarsız gölgeler ve değişmiş yapılar açısından her çıktıyı mutlaka kontrol edin.

Güvenli tarafta kalmak için bunu dijital olarak değiştirilmiş bir görsel olarak ele alın. California'da 1 Ocak 2026'dan beri yürürlükte olan AB 723, bir bildirim ile birlikte değiştirilmemiş orijinaline bir bağlantı verilmesini zorunlu kılar; aydınlatma istisnası ise yalnızca mülkün temsilini değiştirmeyen düzenlemeleri kapsar. Kendi etiketleme kuralları için MLS'inizi kontrol edin.

Evet: Sağlayıcının hız sınırları dahilinde görsel başına paralel olarak bir iş gönderin; Roomagen'in API'si anahtar başına dakikada 60 iş gönderimini kabul eder. Kod kullanmadan ise Roomagen'in web uygulaması Starter, Pro veya Business planlarında 3, 7 veya 20 fotoğraflık toplu işlemler yürütür.

Politikalar farklılık gösterir, bu nedenle yüksek hacimlere geçmeden önce bunları teyit edin. Roomagen'in API'sinde üretim sırasında başarısız olan bir iş "failed" durumuyla sonlanır ve ücreti otomatik olarak iade edilir; bu nedenle mantıklı bir yöntem bir kez yeniden denemek ve ardından gündüz fotoğrafını yayınlamaktır. Para iadesi olmadan yaşanan başarısızlıklar, görsel başına gerçek maliyetinizi sessizce artırır.

Yaygın kusurlar; her pencerenin aynı parlaklıkta parlaması, düz tek renkli bir gökyüzü ve gün batımı gökyüzü altında zeminin veya yansımaların hâlâ öğle güneşiyle aydınlatılmasıdır. Uydurulmuş aydınlatma armatürleri, değiştirilmiş dış cephe kaplaması veya pencerelerden görünen yeni bir manzara, kalite kusurları ve potansiyel uyumluluk sorunlarıdır.

Hayır: Gökyüzü değişimi yalnızca gökyüzünü değiştirir (bazen alacakaranlık renklerinde biriyle) ve binayı, pencereleri ile zemin aydınlatmasını olduğu gibi bırakır. Gündüzden alacakaranlığa dönüştürme ise gökyüzü degrade geçişi, pencere parlaması, ortam ışığı ve yansımalar dahil tüm sahneyi yeniden aydınlatır. Yeni bir gökyüzü olan ancak gündüz gölgelerini koruyan bir demo, gökyüzü değişimidir.
Roomagen

Yazan

Roomagen Team

Roomagen ekibi, yapay zeka sanal düzenleme, emlak fotoğrafçılığı ve gayrimenkul pazarlama stratejileri hakkında derinlemesine rehberler hazırlar.

İlgili Makaleler

AB 723 ve MLS: AI ile Düzenlenen İlan Fotoğrafı Uyumlu mu?

AB 723 ve MLS: AI ile Düzenlenen İlan Fotoğrafı Uyumlu mu?

California'nın AB 723 yasası, AI ile değiştirilen her ilan fotoğrafı için göze çarpan bir bildirim ve orijinaline giden bir yol gerektiriyor; CRMLS gibi MLS'ler ise bir etiket olsa dahi bazı düzenlemeleri reddediyor. Nelerin değiştirilmiş sayıldığı, kimin sorumlu olduğu, 2027'de kiralıklar için nelerin değiştiği ve 8 soruluk bir fotoğraf kontrol listesi burada.

Devamını oku
En İyi Sanal Sahneleme API'leri 2026: 10 Seçenek

En İyi Sanal Sahneleme API'leri 2026: 10 Seçenek

Ekim 2026'da kontrol edilen sağlayıcı sayfalarını kullanarak on sanal sahneleme API'sini görsel başına yayımlanan fiyat, ücretsiz denemeler, webhook'lar, white-label çıktı ve hata politikaları açısından karşılaştırdık. 500 ila 10.000 görsel arası aylık maliyet senaryolarını içerir.

Devamını oku
Sanal Sahneleme API Rehberi: İş, Webhook ve Kod (2026)

Sanal Sahneleme API Rehberi: İş, Webhook ve Kod (2026)

Bir REST API aracılığıyla herhangi bir uygulamaya AI sanal sahneleme eklemeye yönelik adım adım geliştirici rehberi. Kod, Roomagen'in belgelenmiş API'sini izler: bir iş gönderin, imzalı webhook'ları doğrulayın, alternatif olarak yoklama yapın, sonuçları depolayın ve bildirimi yerleşik olarak sunun.

Devamını oku
Gündüzden Alacakaranlığa Fotoğraf Düzenleme, Dönüştürme 2026

Gündüzden Alacakaranlığa Fotoğraf Düzenleme, Dönüştürme 2026

2026'da alacakaranlık gayrimenkul fotoğrafları nasıl çekilir ve hazırlanır: Gerçek bir mavi saat çekimi mi, yoksa gündüz fotoğrafından düzenlenen sanal bir alacakaranlık mı? Zamanlama, kamera ayarları, maliyetler, hangisinin ne zaman mantıklı olduğu ve alacakaranlık düzenlemelerinin nasıl bildirileceği.

Devamını oku
Gündüzden Alacakaranlığa: Çekim, Düzenleme veya AI (2026)

Gündüzden Alacakaranlığa: Çekim, Düzenleme veya AI (2026)

Gerçek bir alacakaranlık çekimi mi, manuel düzenleme mi yoksa AI dönüşümü mü? Gündüzden alacakaranlığa fotoğraflar için 2026 fiyatlarını karşılaştırıyor, alacakaranlık ile ilan performansı hakkındaki verileri inceliyor ve bunların nasıl dönüştürülüp bildirileceğini açıklıyoruz.

Devamını oku