Sur cette page
- Trois façons d’amener un shooting à la retouche
- Import automatique Dropbox : l’automatisation sans développeur
- L’API de retouche : la retouche intégrée à votre plateforme
- Comment choisir pour automatiser la retouche photo immobilière
- Pourquoi beaucoup d’équipes utilisent les deux
- Accès et sécurité
- Le déploiement
- Combien ça coûte
Une fois qu’une agence de médias immobiliers a décidé d’automatiser la retouche photo immobilière, la question suivante est de savoir comment les shootings doivent arriver à la retouche. La réponse dépend moins de la retouche que de votre équipe : où les photographes déposent déjà leurs fichiers, si vous avez un développeur et où les photos terminées doivent arriver.
Ce guide compare les deux voies automatisées proposées par Stager AI, un dossier Dropbox surveillé et l’API de retouche, avec l’application web comme point de référence.
Trois façons d’amener un shooting à la retouche
| Application web | Import automatique Dropbox | API de retouche | |
|---|---|---|---|
| Qui le met en place | Personne | Un responsable des opérations, une fois | Un développeur |
| Ce qui lance la retouche | Quelqu’un envoie les fichiers et clique | Un envoi terminé dans le dossier surveillé | Votre logiciel, lot par lot |
| Où se trouvent les réglages | Choisis dans la barre latérale, mémorisés pour chaque personne | Enregistrés sur la connexion Dropbox | Envoyés avec chaque requête |
| Où vont les résultats | Le projet Stager AI | Le projet Stager AI | Votre système, avec un webhook signé par photo |
| Idéal pour | Les shootings occasionnels ou ponctuels | Les équipes qui utilisent déjà Dropbox | Les plateformes qui gèrent leurs propres commandes et livraisons |
Import automatique Dropbox : l’automatisation sans développeur
Avec l’import automatique Dropbox, vous connectez un compte Dropbox une fois, choisissez le dossier à surveiller et enregistrez vos paramètres HDR. Ensuite, il suffit qu’un photographe envoie un shooting : 10 minutes après l’arrivée du dernier fichier, le shooting devient un projet et il est retouché.
- S’adapte à la façon dont les photographes travaillent déjà. Ils continuent d’envoyer leurs fichiers sur Dropbox, et personne ne déplace de fichiers.
- Les dossiers d’équipe sont pris en charge, avec un sous-dossier par shooting ou votre propre structure avec un marqueur sur les dossiers à retoucher.
- Des contrôles de volume : une limite quotidienne de fichiers avec approbation, la pause et l’annulation.
- Un accès en lecture seule. Les photos retouchées apparaissent dans votre projet Stager AI, prêtes à être vérifiées et livrées. Rien n’est écrit dans Dropbox.
La limite se situe en fin de workflow : quelqu’un vérifie et livre toujours depuis le projet Stager AI. Pour beaucoup d’équipes, c’est justement là qu’elles veulent garder une personne. La configuration complète pour une équipe se trouve dans notre workflow Dropbox pour les équipes de photographie immobilière.
L’API de retouche : la retouche intégrée à votre plateforme
Si votre agence utilise son propre système de réservation, de commande ou de livraison, l’API de retouche photo immobilière permet à ce système d’envoyer les shootings et de recevoir les résultats sans que personne n’ouvre Stager AI. Un shooting complet tient en quatre appels :
- 1Créer un lot pour le shooting, avec votre propre identifiant de commande.
- 2Envoyer chaque photo à l’aide d’URL d’envoi signées.
- 3Lancer le traitement. Les brackets sont regroupés par scène automatiquement.
- 4Recevoir un webhook pour chaque photo terminée ou en échec, signé en HMAC-SHA256 pour que vous puissiez vérifier qu’il vient bien de nous. Vous pouvez aussi consulter le statut du lot à tout moment.
- 1. Créer un projet pour le bienPOST /api/projects{ "title": "12 Harbour View" }
- 2. Créer le lot, avec votre identifiant de commandePOST /api/hdr-batch{ "projectId": "project_uuid", "perspectiveCorrection": true, "clientReferenceId": "JOB-2041" }
- 3. Obtenir une URL d’envoi signée par photoPOST /api/hdr-batch/:batchId/url
- 4. Lancer le traitementPOST /api/hdr-batch/:batchId/enhance
- 5. Webhook : une photo est terminéePOST https://your-app.com/webhooks/stagerX-Stager-Signature: sha256=… { "eventType": "hdr.image.completed", … }
L’API utilise les mêmes réglages que l’application : style de retouche, correction de l’objectif et de la perspective, suppression du photographe, feu dans la cheminée, écran TV noirci, confidentialité et blurLicensePlates, définis pour chaque lot. Votre identifiant de commande interne est renvoyé à chaque consultation du statut, ce qui simplifie le rapprochement entre les traitements et les commandes. Tous les abonnements incluent l’accès à l’API : générez une clé et ajoutez l’URL de votre webhook dans la section Accès API de votre page de compte, puis consultez la documentation de l’API.
Comment choisir pour automatiser la retouche photo immobilière
Quatre questions suffisent en général à trancher :
- Où vont les shootings aujourd’hui ? Si la réponse est Dropbox, commencez par l’import automatique. La connexion est gratuite et prend quelques minutes.
- Avez-vous un développeur, en interne ou en prestation ? L’API demande quelqu’un pour construire et maintenir l’intégration.
- Où les photos terminées doivent-elles arriver ? Si elles doivent apparaître automatiquement dans votre propre galerie client ou votre système, c’est le rôle de l’API.
- Qui valide une galerie ? Si une personne vérifie de toute façon chaque livraison, Dropbox associé à une étape de vérification dans Stager AI suffit souvent.
Quelle voie convient à votre équipe ?
0/4Répondez à quatre questions rapides et obtenez une recommandation.
1.Où vont vos shootings aujourd’hui ?
2.Avez-vous un développeur, interne ou externe ?
3.Les photos terminées doivent-elles arriver seules dans votre système ?
4.Qui valide une galerie ?
Pourquoi beaucoup d’équipes utilisent les deux
Les deux voies ne s’excluent pas. Une configuration courante associe Dropbox pour les photographes sur le terrain et l’API pour les commandes qui passent par la plateforme de l’agence, par exemple les nouvelles retouches ou les shootings livrés par des partenaires. Tant que les deux utilisent le même style de retouche, le résultat est identique : enregistrez-le sur la connexion Dropbox et envoyez editingStyle avec chaque requête API. Nous expliquons pourquoi c’est important dans garder un style de retouche cohérent entre tous vos photographes.
Quelle que soit la voie choisie, gardez un contrôle qualité avant la livraison. Notre checklist de contrôle qualité des photos immobilières liste les points à regarder, et AI QA note chaque photo terminée pour que vous sachiez où regarder en premier.
Accès et sécurité
Automatiser, c’est laisser un autre système accéder à vos fichiers et aux photos de vos clients : mieux vaut savoir ce que chaque voie peut voir et faire.
- Dropbox : Stager AI demande un accès en lecture seule et ne traite que les fichiers envoyés dans le dossier surveillé après que vous l’avez choisi. Il n’écrit, ne déplace et ne supprime jamais rien dans votre Dropbox.
- API : chaque requête utilise votre en-tête stager-api-key. Gardez la clé sur votre serveur, jamais dans une application ni dans une page web.
- Webhooks : chaque événement est signé en HMAC-SHA256. Vérifiez la signature avant d’agir sur un événement, pour que personne d’autre ne puisse marquer une commande comme terminée dans votre système.
Le déploiement
Quelle que soit la voie choisie, commencez petit et élargissez une fois que les premiers shootings sont réussis.
Import automatique Dropbox
- 1Connectez un compte Dropbox de l’entreprise et choisissez le dossier.
- 2Enregistrez le style de retouche et les paramètres HDR, et définissez une limite quotidienne de fichiers.
- 3Faites passer un shooting de test de bout en bout, de l’envoi à la livraison.
- 4Ajoutez un ou deux photographes pendant une semaine, puis le reste de l’équipe.
API de retouche
- 1Générez une clé API et renseignez l’URL de votre webhook sur votre page de compte.
- 2Développez les quatre appels et l’endpoint de webhook, avec vos propres identifiants de commande.
- 3Envoyez quelques vrais shootings et comparez-les avec les mêmes shootings retouchés dans l’application web.
- 4Basculez votre plateforme pour un client ou une région d’abord, puis partout.
Combien ça coûte
Connecter Dropbox est gratuit. Chaque photo retouchée utilise 1 crédit photo, quelle que soit la voie par laquelle elle arrive, et un bracket de 3, 5 ou 7 expositions compte pour une seule photo. Les abonnements commencent à 10 photos par mois et les photos non utilisées sont reportées. Tous les abonnements incluent l’accès à l’API. Pour des remises sur volume, parlez-nous de vos shootings.
Questions fréquentes
Pour la plupart des équipes, un dossier Dropbox surveillé. Vous connectez Dropbox une fois, choisissez un dossier et enregistrez vos réglages, et chaque shooting envoyé est retouché automatiquement 10 minutes après l’arrivée de son dernier fichier. Aucun développeur n’est nécessaire.
Quand les shootings passent par votre propre logiciel de réservation ou de livraison, ou quand les photos terminées doivent arriver automatiquement dans votre système. L’API envoie un webhook signé pour chaque photo terminée ou en échec.
Oui. Beaucoup d’équipes utilisent Dropbox pour les photographes et l’API pour les commandes issues de leur plateforme. Enregistrez le style de retouche sur la connexion Dropbox et envoyez le même editingStyle avec chaque requête API : les résultats seront identiques.
Tous les abonnements incluent l’accès à l’API. Générez une clé dans la section Accès API de votre page de compte et ajoutez une URL de webhook si vous voulez un événement pour chaque photo terminée. Pour des remises sur volume, écrivez-nous sur le chat.
Non. L’accès est en lecture seule : les photos retouchées apparaissent dans votre projet Stager AI, d’où vous pouvez les vérifier, les télécharger ou les livrer.



