Geliştirici API’si — Yayında

Emlak Görsel API’si

Virtual staging, renovasyon, fotoğraf iyileştirme, day-to-dusk, obje silme, kat planları ve Roomagen’in diğer tüm araçları: her biri dokümante edilmiş, tek iş endpoint’i ve tek API anahtarının arkasında. Webhook’lu asenkron işler, sonuçlar genellikle 20–60 saniyede; hesabınız bir paket aldıktan sonra çıktıda Roomagen markası olmaz.

API anahtarınızı alın
terminal — roomagen api
$ curl -X POST https://api.roomagen.com/api/v1/jobs \
  -H "X-Api-Key: rmg_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "virtual-staging",
    "image_url": "https://example.com/empty-living-room.jpg",
    "options": { "style": "scandinavian", "roomType": "living-room" },
    "webhook_url": "https://yourapp.com/hooks/roomagen"
  }'
 
# → { "job_id": "3f1c9d4e-…", "status": "processing", "images_charged": 1, "warnings": [] }

API’nin arkasındaki araçlardan gerçek çıktı

Bu önce/sonra çifti, API’nin de çalıştırdığı obje silme aracından geliyor.

Object removal input
input.jpg
Object removal result
✓ result.jpg · 26s

Demo örneği: Girdi görseli bu site için yapay zekâ ile oluşturuldu; müşteri fotoğrafı değildir.

API’yi yeteneklerine göre keşfedin

API dokümanlarındaki tüm araçları görün →

Ekipler Roomagen’i neden seçiyor

Tüm araçlar, tek endpoint

Sahneleme, renovasyon, iyileştirme, day-to-dusk, silme, dış mekân ve kat planlarının hepsi POST /v1/jobs üzerinden çalışır; her aracın seçenekleri bir örnekle dokümante edilmiştir. Aracı tek parametreyle değiştirirsiniz.

Kat planları, 2D ve 3D

2D bir plan, bir tarama ya da elle çizimin telefon fotoğrafını gönderin; mobilyalı veya boş bir 3D render, temiz şekilde yeniden çizilmiş bir plan, renklendirilmiş bir plan ya da üstten bir pazarlama görseli geri alın.

Paket alınca markasız

50 ücretsiz görsel Roomagen filigranıyla üretilir: entegrasyonu kurmak ve test etmek içindir. Hesabınız bir paket aldığında, kalan ücretsiz görselleriniz dahil her yeni render Roomagen markası olmadan gelir.

Güvenli yeniden deneme

Idempotency-Key başlığı gönderin; tekrarlanan istek orijinal işi döndürür: ikinci ücret yok, ikinci render yok.

Başarısız işler iade edilir

Üretim sırasında başarısız olan iş otomatik olarak iade edilir. Webhook’lar HMAC ile imzalanır; yaklaşık 36 dakikaya yayılan en fazla beş teslim denemesi yapılır.

Self servis, gerçek dokümantasyon

Anahtarı geliştirici portalında oluşturun, satış görüşmesi gerekmez. cURL, Node.js ve Python örnekleriyle halka açık dokümantasyon; sonuçları webhook ile ya da polling ile alın.

Tanıdık hissettirecek şekilde tasarlandı

Bir iş gönderin, iş kimliği alın, tamamlandığında webhook alın. Her iş tek görsel: işleri paralel çalıştırın, anahtar başına dakikada en fazla 60 yeni iş.

POST /api/v1/jobs
$ curl -X POST https://api.roomagen.com/api/v1/jobs \
  -H "X-Api-Key: rmg_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "virtual-staging",
    "image_url": "https://example.com/empty-living-room.jpg",
    "options": { "style": "scandinavian", "roomType": "living-room" },
    "webhook_url": "https://yourapp.com/hooks/roomagen"
  }'
 
# → { "job_id": "3f1c9d4e-…", "status": "processing", "images_charged": 1, "warnings": [] }

Basit ön ödemeli fiyatlandırma

Krediler görsel cinsinden tanımlanır. Ön ödemelidir ve süresi hiç dolmaz. Başarısız üretimler asla ücretlendirilmez.

Kart gerekmez

Developer

$0

50 filigranlı görsel, tek seferlik

yalnızca ilk anahtar

API anahtarınızı alın

Pilot

$125

500 görsel

$0.25 / görsel

Portaldan satın alın

Ön ödemeli · süresi dolmaz

En popüler

Growth

$550

2.500 görsel

$0.22 / görsel

Portaldan satın alın

Ön ödemeli · süresi dolmaz

Scale

$2,000

10.000 görsel

$0.20 / görsel

Portaldan satın alın

Ön ödemeli · süresi dolmaz

Taahhütlü kullanım indirimleri

Volume

Özel

50.000+ görsel

Bizimle görüşün

Bizimle görüşün

Fiyatlar üretilen görsel başınadır; 4K render iki görsel sayılır. Hesap bir paket satın aldıktan sonra render’larda Roomagen markası olmaz. Herhangi bir fiyat değişikliğinden 30 gün önce bildirim yapılır.

Dakikalar içinde çalışır durumda

Anahtar oluşturun, tek bir POST gönderin, biten görseli alın. Satış görüşmesi yok, sıra beklemek yok.

roomagen-api — quickstartv1
  1. 1

    Anahtarınızı oluşturun

    Geliştirici portalına giriş yapın ve bir anahtar üretin. Anahtar yalnızca bir kez gösterilir, güvenli bir yerde saklayın.

    developers.roomagen.com/portal ↗
  2. 2

    İlk işinizi çalıştırın

    Araç slug’ı ve görselinizle tek bir POST. Yanıt anında bir iş kimliğiyle döner — üretim arka planda sürer.

    $ curl -X POST https://api.roomagen.com/api/v1/jobs \
      -H "X-Api-Key: rmg_live_..." \
      -H "Content-Type: application/json" \
      -d '{ "tool": "virtual-staging",
            "image_url": "https://example.com/photo.jpg",
            "options": { "style": "scandinavian", "roomType": "living-room" } }'
     
    # → 201 { "job_id": "3f1c9d4e-…", "status": "processing", "images_charged": 1, "warnings": [] }
  3. 3

    Sonucu alın

    Bir webhook_url tanımlayın, görsel hazır olduğunda sizi çağıralım; ya da iş uç noktasını sorgulayın. Tipik olarak 20–60 saniye.

    POST → your webhook_urlGET /api/v1/jobs/{id}
API anahtarınızı alınDokümanları okuyun

✓ İlk anahtarınızda 50 ücretsiz görsel, paket alana kadar filigranlı · kart gerekmez

API SSS

Roomagen web uygulamasındaki her araç: virtual staging, oda boşaltma ve toparlama, iç ve dış mekân renovasyonu, mutfak ve banyo, fotoğraf düzenleme, day-to-dusk ve kat planı araçları. Araç seçimini iş başına tek parametreyle yaparsınız. Her araç, seçenekleri ve bir örnekle developers.roomagen.com/docs/tools adresinde dokümante edilmiştir; GET /v1/tools anahtarınızın çağırabileceği tüm slug’ları listeler.

İşler genellikle 20–60 saniyede hazır olur; virtual staging ve sanal renovasyon bu aralığın üst ucuna yakındır. Bir iş bittiğinde webhook alırsınız veya işi 2–5 saniyede bir sorgulayabilirsiniz.

Hesabınız bir paket aldıktan sonra evet: render’lar Roomagen markası veya filigranı taşımaz; bundan önce 50 ücretsiz görselden yapılan render’lar ise kurulum ve test için filigranlıdır. API logonuzu ya da bir bilgilendirme etiketini eklemez; ilan kurallarınızın istediği etiketi kendi akışınızda ekleyin.

Üretim sırasında başarısız olan iş otomatik olarak iade edilir ve error alanı nedenini söyler. Tamamlanan iş bir kez ücretlendirilir; aynı işi yeniden çalıştırmak yeni bir iştir.

Görsel cinsinden ön ödemeli paketler: 500 görsel $0.25’ten, 2.500 görsel $0.22’den, 10.000 görsel $0.20’den ve 50.000 üzeri için pazarlıklı taahhütlü fiyatlandırma. 4K render iki görsel sayılır. Paketlerin süresi dolmaz ve bakiyeye eklenir.

Hayır. Bir iş yalnızca düzenlenmiş görseli döndürür: bilgilendirme etiketi, değişiklik kaydı veya orijinalin bir kopyası yoktur. Kaynak fotoğrafınızı saklayın ve MLS’iniz ya da yerel mevzuat gerektiriyorsa düzenlenmiş görselleri etiketleyin; örneğin Kaliforniya’nın AB 723 yasası bir bilgilendirme ifadesi ve değiştirilmemiş orijinale bir bağlantı ister.

Roomagen çıktısını kendi ürününüze veya platformunuza gömmek API’nin tam olarak var olma amacı. Ham API’yi kendi API’niz gibi sunmak (proxy) ise bayilik anlaşması gerektirir — bizimle iletişime geçin.

Evet — ilk API anahtarınızı oluşturduğunuzda hesabınıza tek seferlik 50 ücretsiz görsel eklenir, kart gerekmez. Bu görseller hesap bir paket alana kadar Roomagen filigranıyla üretilir ve webhook’lar dahil işin tamamını kapsar; satın almadan önce entegrasyonu kurup test edebilirsiniz.

Mülk görselleriyle bir şey mi inşa ediyorsunuz?

Geliştirici portalında bir anahtar oluşturun ve ilk işinizi bugün çalıştırın. Kurup test etmeniz için 50 ücretsiz görsel (paket alana kadar filigranlı), kart gerekmez.

API anahtarınızı alın