Die Real Estate Image API
Virtual Staging, Renovierung, Fotoverbesserung, Day-to-Dusk, Objektentfernung, Grundrisse und alle anderen Roomagen-Tools: jedes dokumentiert, hinter einem Job-Endpoint und einem API-Key. Asynchrone Jobs mit Webhooks, Ergebnisse in der Regel in 20–60 Sekunden und kein Roomagen-Branding auf der Ausgabe, sobald Ihr Konto ein Paket gekauft hat.
$ 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": [] }
Echte Ergebnisse der Tools hinter der API
Dieses Vorher-Nachher-Paar stammt aus der Objektentfernung, demselben Tool, das die API ausführt.
Demo-Beispiel: Das Eingabebild wurde für diese Website mit KI erstellt; es ist kein Kundenfoto.
Die API nach Funktionen erkunden
Warum Teams Roomagen wählen
Alle Tools, ein Endpoint
Staging, Renovierung, Bildverbesserung, Day-to-Dusk, Entfernung, Außenbereiche und Grundrisse laufen alle über POST /v1/jobs, und die Optionen jedes Tools sind mit einem Beispiel dokumentiert. Sie wechseln das Tool mit einem Parameter.
Grundrisse, 2D und 3D
Senden Sie einen 2D-Grundriss, einen Scan oder ein Handyfoto einer Handzeichnung und erhalten Sie ein möbliertes oder leeres 3D-Rendering, einen sauber neu gezeichneten Grundriss, einen kolorierten Grundriss oder ein Marketingbild in Draufsicht zurück.
Ohne Branding ab dem ersten Paket
Die 50 kostenlosen Bilder werden mit einem Roomagen-Wasserzeichen gerendert: Sie dienen zum Entwickeln und Testen. Sobald Ihr Konto ein Paket kauft, kommt jedes neue Rendering ohne Roomagen-Branding zurück, auch aus den verbleibenden kostenlosen Bildern.
Sichere Retries
Senden Sie einen Idempotency-Key-Header, und eine wiederholte Anfrage liefert den ursprünglichen Job zurück: keine zweite Abbuchung, kein zweites Rendering.
Fehlgeschlagene Jobs werden erstattet
Ein Job, der bei der Generierung fehlschlägt, wird automatisch erstattet. Webhooks sind HMAC-signiert, mit bis zu fünf Zustellversuchen über etwa 36 Minuten.
Self-Serve, echte Doku
Erstellen Sie einen Key im Developer-Portal, ohne Vertriebsgespräch. Öffentliche Dokumentation mit cURL-, Node.js- und Python-Beispielen; Ergebnisse per Webhook oder Polling abholen.
Bewusst vertraut gestaltet
Job übermitteln, Job-ID erhalten, Webhook bei Fertigstellung empfangen. Ein Bild pro Job: Jobs laufen parallel, bis zu 60 neue Jobs pro Minute und Key.
$ 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": [] }
Einfache Prepaid-Preise
Credits werden in Bildern gerechnet. Prepaid, und sie verfallen nie. Fehlgeschlagene Generierungen werden nie berechnet.
Developer
$0
50 Bilder mit Wasserzeichen, einmalig
nur erster Key
Preise pro generiertem Bild; ein 4K-Rendering zählt doppelt. Sobald das Konto ein Paket gekauft hat, tragen Renderings kein Roomagen-Branding. 30 Tage Vorankündigung vor jeder Preisänderung.
In Minuten einsatzbereit
Schlüssel erstellen, einen POST senden, fertiges Bild erhalten. Kein Vertriebsgespräch, keine Warteschlange.
- 1
Schlüssel erstellen
Melden Sie sich im Entwicklerportal an und erzeugen Sie einen Schlüssel. Er wird nur einmal angezeigt — bewahren Sie ihn sicher auf.
developers.roomagen.com/portal ↗ - 2
Ersten Job starten
Ein POST mit Tool-Slug und Ihrem Bild. Die Antwort kommt sofort mit einer Job-ID — die Generierung läuft im Hintergrund.
$ 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
Ergebnis abholen
Setzen Sie eine webhook_url und wir benachrichtigen Sie, sobald das Bild fertig ist — oder fragen Sie den Job-Endpunkt ab. Typischerweise 20–60 Sekunden.
POST → your webhook_urlGET /api/v1/jobs/{id}
✓ 50 kostenlose Bilder mit dem ersten Schlüssel, mit Wasserzeichen bis zum Kauf eines Pakets · keine Kreditkarte
API-FAQ
Bauen Sie etwas mit Immobilienbildern?
Erstellen Sie im Entwicklerportal einen Schlüssel und schicken Sie noch heute Ihren ersten Job durch. 50 kostenlose Bilder zum Entwickeln und Testen (mit Wasserzeichen bis zum Kauf eines Pakets), keine Kreditkarte.
API-Schlüssel holen