Activité et organisation

Automatisation Dropbox ou API de retouche ? Comment les agences de médias automatisent la retouche photo immobilière

Un shooting peut arriver à la retouche de trois façons : à la main, par un dossier Dropbox surveillé ou depuis votre propre logiciel via une API. Voici comment choisir, et pourquoi beaucoup d’agences de médias finissent par en utiliser deux.

Publié le 6 min de lecture

Vue aérienne d’une grande maison avec terrasse, entourée d’arbres d’automne rouges, orange et verts
Sur cette page

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 webImport automatique DropboxAPI de retouche
Qui le met en placePersonneUn responsable des opérations, une foisUn développeur
Ce qui lance la retoucheQuelqu’un envoie les fichiers et cliqueUn envoi terminé dans le dossier surveilléVotre logiciel, lot par lot
Où se trouvent les réglagesChoisis dans la barre latérale, mémorisés pour chaque personneEnregistrés sur la connexion DropboxEnvoyés avec chaque requête
Où vont les résultatsLe projet Stager AILe projet Stager AIVotre système, avec un webhook signé par photo
Idéal pourLes shootings occasionnels ou ponctuelsLes équipes qui utilisent déjà DropboxLes plateformes qui gèrent leurs propres commandes et livraisons
Comparaison des trois voies.

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 :

  1. 1Créer un lot pour le shooting, avec votre propre identifiant de commande.
  2. 2Envoyer chaque photo à l’aide d’URL d’envoi signées.
  3. 3Lancer le traitement. Les brackets sont regroupés par scène automatiquement.
  4. 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.
Un shooting via l’API
  1. 1. Créer un projet pour le bien
    POST /api/projects{ "title": "12 Harbour View" }
  2. 2. Créer le lot, avec votre identifiant de commande
    POST /api/hdr-batch{ "projectId": "project_uuid", "perspectiveCorrection": true, "clientReferenceId": "JOB-2041" }
  3. 3. Obtenir une URL d’envoi signée par photo
    POST /api/hdr-batch/:batchId/url
  4. 4. Lancer le traitement
    POST /api/hdr-batch/:batchId/enhance
  5. 5. Webhook : une photo est terminée
    POST https://your-app.com/webhooks/stagerX-Stager-Signature: sha256=… { "eventType": "hdr.image.completed", … }
Appuyez sur Lancer pour envoyer les appels dans l’ordre. Le dernier est le webhook signé que reçoit votre système pour chaque photo terminée.

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/4

Répondez à quatre questions rapides et obtenez une recommandation.

  1. 1.Où vont vos shootings aujourd’hui ?

  2. 2.Avez-vous un développeur, interne ou externe ?

  3. 3.Les photos terminées doivent-elles arriver seules dans votre système ?

  4. 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

  1. 1Connectez un compte Dropbox de l’entreprise et choisissez le dossier.
  2. 2Enregistrez le style de retouche et les paramètres HDR, et définissez une limite quotidienne de fichiers.
  3. 3Faites passer un shooting de test de bout en bout, de l’envoi à la livraison.
  4. 4Ajoutez un ou deux photographes pendant une semaine, puis le reste de l’équipe.

API de retouche

  1. 1Générez une clé API et renseignez l’URL de votre webhook sur votre page de compte.
  2. 2Développez les quatre appels et l’endpoint de webhook, avec vos propres identifiants de commande.
  3. 3Envoyez quelques vrais shootings et comparez-les avec les mêmes shootings retouchés dans l’application web.
  4. 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.

Essayez Stager AI

Retouchez votre prochaine annonce avec Stager AI

Retouche HDR pour les photographes et les agences de médias en 1 à 5 minutes environ. Home staging et retouche pour les agents en quelques secondes. Vos premiers rendus sont offerts.