Auf dieser Seite
Hat eine Immobilien-Medienagentur entschieden, ihre Immobilienfotos automatisch bearbeiten zu lassen, stellt sich die nächste Frage: Wie kommen die Shootings in die Bearbeitung? Die Antwort hängt weniger von der Bearbeitung ab als von deinem Team: wo die Fotografen ihre Dateien heute ablegen, ob du einen Entwickler hast und wo die fertigen Fotos landen sollen.
Dieser Leitfaden vergleicht die zwei automatisierten Wege, die Stager AI anbietet, einen überwachten Dropbox-Ordner und die Bearbeitungs-API, mit der Web-App als Ausgangspunkt.
Drei Wege, wie ein Shooting in die Bearbeitung kommt
| Web-App | Dropbox-Autoimport | Bearbeitungs-API | |
|---|---|---|---|
| Wer richtet es ein | Niemand | Die Teamleitung, einmalig | Ein Entwickler |
| Was die Bearbeitung startet | Jemand lädt hoch und klickt | Ein abgeschlossener Upload in den überwachten Ordner | Deine Software, pro Stapel |
| Wo die Einstellungen liegen | In der Seitenleiste gewählt, pro Person gespeichert | In der Dropbox-Verbindung gespeichert | Mit jeder Anfrage mitgeschickt |
| Wo die Ergebnisse landen | Im Stager AI Projekt | Im Stager AI Projekt | In deinem System, mit einem signierten Webhook pro Foto |
| Ideal für | Gelegentliche oder einmalige Shootings | Teams, die schon mit Dropbox arbeiten | Plattformen mit eigener Auftragsannahme und Lieferung |
Dropbox-Autoimport: Immobilienfotos automatisch bearbeiten, ohne Entwickler
Mit dem Dropbox-Autoimport verbindest du einmal ein Dropbox-Konto, wählst den Ordner, der überwacht werden soll, und speicherst deine HDR-Einstellungen. Ab dann genügt es, dass ein Fotograf ein Shooting hochlädt: 10 Minuten nach der letzten Datei wird das Shooting zu einem Projekt und bearbeitet.
- Passt zur bisherigen Arbeitsweise der Fotografen. Sie laden weiter in Dropbox hoch, und niemand schiebt Dateien herum.
- Teamordner werden unterstützt, entweder mit einem Unterordner pro Shooting oder mit deiner eigenen Struktur und einer Markierung an den Ordnern, die bearbeitet werden sollen.
- Steuerungen für das Volumen: ein tägliches Dateilimit mit Freigabe, Pausieren und Abbrechen.
- Schreibgeschützter Zugriff. Die bearbeiteten Fotos erscheinen in deinem Stager AI Projekt, bereit zum Prüfen und Ausliefern. In Dropbox wird nichts zurückgeschrieben.
Die Grenze liegt am Ende des Workflows: Jemand prüft und liefert weiterhin aus dem Stager AI Projekt aus. Für viele Teams ist das genau die Stelle, an der sie ohnehin einen Menschen haben wollen. Die komplette Einrichtung fürs Team steht in unserem Dropbox-Workflow für die Immobilienfotografie im Team.
Die Bearbeitungs-API: Bearbeitung in deiner eigenen Plattform
Wenn deine Agentur ein eigenes System für Buchung, Aufträge oder Lieferung betreibt, kann dieses System über die API für die Bearbeitung von Immobilienfotos Shootings schicken und die Ergebnisse empfangen, ohne dass jemand Stager AI öffnet. Ein ganzes Shooting braucht vier Aufrufe:
- 1Einen Stapel anlegen für das Shooting, mit deiner eigenen Auftrags-ID.
- 2Jedes Foto hochladen, über signierte Upload-URLs.
- 3Die Verarbeitung starten. Die Belichtungsreihen werden automatisch zu Szenen gruppiert.
- 4Einen Webhook empfangen für jedes fertige oder fehlgeschlagene Foto, signiert mit HMAC-SHA256, damit du prüfen kannst, dass er wirklich von uns kommt. Den Status des Stapels kannst du außerdem jederzeit abfragen.
- 1. Projekt für das Objekt anlegenPOST /api/projects{ "title": "12 Harbour View" }
- 2. Stapel anlegen, mit deiner Auftrags-IDPOST /api/hdr-batch{ "projectId": "project_uuid", "perspectiveCorrection": true, "clientReferenceId": "JOB-2041" }
- 3. Signierte Upload-URL pro Foto holenPOST /api/hdr-batch/:batchId/url
- 4. Verarbeitung startenPOST /api/hdr-batch/:batchId/enhance
- 5. Webhook: ein Foto ist fertigPOST https://your-app.com/webhooks/stagerX-Stager-Signature: sha256=… { "eventType": "hdr.image.completed", … }
Die API nutzt dieselben Einstellungen wie die App: Bearbeitungsstil, Objektiv- und Perspektivkorrektur, Fotograf entfernen, Feuer, TV-Bildschirm schwärzen, Datenschutz und blurLicensePlates, festgelegt pro Stapel. Deine interne Auftrags-ID kommt bei jeder Statusabfrage zurück, so lassen sich Aufträge einfach zuordnen. API-Zugang ist in jedem Plan enthalten: Erstell einen Schlüssel und trag deine Webhook-URL im Bereich API-Zugriff deiner Kontoseite ein, dann lies die API-Dokumentation.
Wie du dich entscheidest
Vier Fragen klären es meistens:
- Wo landen Shootings heute? Wenn die Antwort Dropbox lautet, fang mit dem Autoimport an. Das Verbinden ist kostenlos und dauert nur Minuten.
- Hast du einen Entwickler, intern oder extern? Für die API braucht es jemanden, der die Integration baut und pflegt.
- Wo sollen die fertigen Fotos landen? Wenn sie automatisch in deiner eigenen Kundengalerie oder deinem System erscheinen sollen, ist das die Aufgabe der API.
- Wer gibt eine Galerie frei? Wenn ohnehin eine Person jede Lieferung prüft, reicht oft Dropbox plus ein Prüfschritt in Stager AI.
Welcher Weg passt zu deinem Team?
0/4Beantworte vier kurze Fragen und erhalte eine Empfehlung.
1.Wo landen deine Shootings heute?
2.Hast du einen Entwickler, intern oder extern?
3.Sollen fertige Fotos automatisch in deinem System ankommen?
4.Wer gibt eine Galerie frei?
Warum viele Teams beides nutzen
Die Wege schließen sich nicht aus. Eine häufige Aufteilung: Dropbox für die Fotografen vor Ort und die API für Aufträge, die über die Plattform der Agentur kommen, zum Beispiel Nachbearbeitungen oder Shootings von Partnern. Solange beide denselben Bearbeitungsstil nutzen, sieht das Ergebnis gleich aus: Speichere ihn in der Dropbox-Verbindung und schick editingStyle mit jeder API-Anfrage mit. Warum das wichtig ist, erklären wir in einheitlicher Bearbeitungsstil für alle Fotografen.
Egal welchen Weg du wählst, behalte vor der Lieferung eine Qualitätskontrolle bei. Unsere Checkliste zur Qualitätskontrolle von Immobilienfotos zeigt, worauf du achten solltest, und AI QA bewertet jedes fertige Foto, damit du weißt, wo du zuerst hinschauen solltest.
Zugriff und Sicherheit
Automatisierung bedeutet, dass ein weiteres System auf deine Dateien und die Fotos deiner Kunden zugreift. Es lohnt sich also zu wissen, was jeder Weg sehen und tun kann.
- Dropbox: Stager AI bittet um schreibgeschützten Zugriff und verarbeitet nur Dateien, die nach der Ordnerauswahl in den überwachten Ordner hochgeladen werden. In deiner Dropbox wird nie etwas geschrieben, verschoben oder gelöscht.
- API: Jede Anfrage nutzt deinen stager-api-key-Header. Bewahre den Schlüssel auf deinem Server auf, nie in einer App oder auf einer Webseite.
- Webhooks: Jedes Ereignis ist mit HMAC-SHA256 signiert. Prüf die Signatur, bevor du auf ein Ereignis reagierst, damit niemand sonst einen Auftrag in deinem System als erledigt markieren kann.
Die Einführung
Egal welchen Weg du wählst: Fang klein an und weite ihn aus, sobald die ersten Shootings gut aussehen.
Dropbox-Autoimport
- 1Ein Dropbox-Firmenkonto verbinden und den Ordner wählen.
- 2Bearbeitungsstil und HDR-Einstellungen speichern und ein tägliches Dateilimit festlegen.
- 3Ein Test-Shooting komplett durchspielen, vom Upload bis zur Lieferung.
- 4Eine Woche lang ein oder zwei Fotografen dazunehmen, dann den Rest des Teams.
Bearbeitungs-API
- 1Auf der Kontoseite einen API-Schlüssel erstellen und die Webhook-URL eintragen.
- 2Die vier Aufrufe und den Webhook-Endpunkt bauen, mit deinen eigenen Auftrags-IDs.
- 3Ein paar echte Shootings schicken und mit denselben Shootings vergleichen, die in der Web-App bearbeitet wurden.
- 4Die Plattform zuerst für einen Kunden oder eine Region umstellen, dann überall.
Was es kostet
Dropbox zu verbinden ist kostenlos. Jedes bearbeitete Foto kostet 1 Foto-Credit, egal über welchen Weg es kommt, und eine Belichtungsreihe aus 3, 5 oder 7 Belichtungen zählt als ein Foto. Pläne gibt es ab 10 Fotos pro Monat, ungenutzte Fotos werden auf den nächsten Monat übertragen. API-Zugang ist in jedem Plan enthalten. Für Mengenrabatte sprich mit uns über deine Shootings.
Häufige Fragen
Für die meisten Teams mit einem überwachten Dropbox-Ordner. Du verbindest Dropbox einmal, wählst einen Ordner und speicherst deine Einstellungen. Jedes hochgeladene Shooting wird dann 10 Minuten nach seiner letzten Datei automatisch bearbeitet. Ein Entwickler ist nicht nötig.
Wenn Shootings über deine eigene Buchungs- oder Liefersoftware kommen oder wenn fertige Fotos automatisch in deinem System ankommen sollen. Die API schickt für jedes fertige oder fehlgeschlagene Foto einen signierten Webhook.
Ja. Viele Teams nutzen Dropbox für die Fotografen und die API für Aufträge aus ihrer Plattform. Speichere den Bearbeitungsstil in der Dropbox-Verbindung und schick denselben editingStyle mit jeder API-Anfrage mit, dann sehen die Ergebnisse gleich aus.
API-Zugang ist in jedem Plan enthalten. Erstell einen Schlüssel im Bereich API-Zugriff deiner Kontoseite und trag eine Webhook-URL ein, wenn du für jedes fertige Foto ein Ereignis willst. Für Mengenrabatte schreib uns im Chat.
Nein. Der Zugriff ist schreibgeschützt. Die bearbeiteten Fotos erscheinen in deinem Stager AI Projekt, wo du sie prüfen, herunterladen oder ausliefern kannst.



