Aller au contenu principal
Automatisation par API Jour en Crépuscule : Photos Twilight à Grande Échelle
Guides

Automatisation par API Jour en Crépuscule : Photos Twilight à Grande Échelle

La conversion jour en crépuscule fonctionne désormais via un appel API. Nous comparons cinq fournisseurs sur les tarifs, les options et la livraison, détaillons une intégration par tâche et webhook, puis abordons le contrôle qualité, la stratégie par lot et la divulgation.

Roomagen
Roomagen Team
3 août 2026Mis à jour: 24 octobre 202616 min de lecture4,591 mots
Sommaire(9)

Ce qui a changé dans cette mise à jour

  • Mise à jour de la section API : les images API gratuites portent désormais un filigrane Roomagen jusqu'à l'achat d'un pack, et chaque outil est documenté
  • Mise à jour du guide des slugs : day-to-dusk-exterior est désormais documenté aux côtés du slug day-to-dusk intérieur
Mises à jour précédentes(1)
    • Correction des détails de l'API de Roomagen : clés en libre-service depuis le 30 août 2026 (sans liste d'attente), 50 images gratuites sur la première clé, tâches de 20 à 60 secondes, et slug séparé day-to-dusk-exterior pour les façades
    • Ajout de Virtual Staging AI et de Collov, avec les tarifs de leurs forfaits Enterprise, au comparatif des fournisseurs, et mise à jour d'AI HomeDesign (inscription avec crédits offerts, 0,24 $ par photo en facturation annuelle) ainsi que des tarifs des forfaits InstantDeco
    • Remplacement des statistiques crépusculaires impossibles à relier à une source primaire (66 % de vues en plus, 3 fois plus de visites, 8 % des annonces) par les données de commandes de HomeJab, les tarifs de prises de vue 2026 de PhotoUp et les tarifs catalogue actuels de BoxBrownie pour le jour en crépuscule
    • Ajout d'un exemple de vérification de signature de webhook, de conseils sur l'idempotence et les limites de débit, d'une checklist d'intégration et du libellé exact d'AB 723 sur les images modifiées

Une API jour en crépuscule convertit une photo extérieure diurne en une version crépusculaire via HTTP : vous soumettez l'image et recevez le résultat, généralement par webhook ou polling. AI HomeDesign, InstantDeco, Virtual Staging AI, Collov et Roomagen en documentent une.

L'outil idéal

Retouche photo jour en crépuscule

Transformez une photo d'extérieur ou de pièce prise de jour en photo de coucher de soleil, de crépuscule ou de nuit avec des fenêtres chaleureusement éclairées. Choisissez l'heure sur un curseur de 24 heures ; 2 crédits par photo.

Essayer gratuitement

Ce que fait une API Jour en Crépuscule — et qui en a besoin

Une API de conversion jour en crépuscule prend une photo de jour d'un bâtiment et renvoie une version au crépuscule : un ciel de soirée plus sombre et dégradé, des lumières intérieures allumées et une lumière ambiante qui correspond à la nouvelle heure. Vous envoyez l'image dans une requête HTTP, le fournisseur exécute un modèle d'image génératif sur celle-ci, et vous récupérez le résultat par webhook ou par interrogation périodique (polling). Aucun retoucheur ne touche au fichier, et c'est tout l'intérêt : la conversion devient une étape d'un pipeline au lieu d'un bon de commande.

Les images crépusculaires ont toujours été délicates à produire. Une véritable séance photo au crépuscule nécessite une deuxième visite à la bonne heure ainsi qu'une météo coopérative, et la retouche manuelle dépend d'une file d'attente humaine. La demande progresse malgré tout. Chez l'entreprise de photographie immobilière HomeJab, le crépuscule virtuel a été « l'amélioration qui a connu la plus forte croissance en 2025 », et son « volume moyen de commandes est passé de seulement 1 % à la mi-2024 à plus de 7 % en septembre 2025 » (HomeJab). Il s'agit de la composition des commandes d'une seule entreprise, et non d'un recensement sectoriel, mais cela montre où vont les dépenses des acheteurs de prestations photographiques.

Vous verrez également circuler des chiffres largement partagés affirmant que les photos au crépuscule augmentent les vues d'annonces ou les visites d'un pourcentage fixe. Nous les avons laissés de côté : ceux dont nous avons retrouvé l'origine ne menaient à aucune étude primaire.

Pour un agent individuel avec une seule annonce, une application web suffit. La question de l'API se pose lorsque le crépuscule doit être appliqué des centaines de fois par mois sans que personne n'ait à cliquer : les entreprises de photographie immobilière qui vendent le crépuscule comme une option par annonce, les portails d'annonces qui mettent à niveau les photos de couverture sur l'ensemble d'un catalogue, les équipes marketing d'agences immobilières qui génèrent des ressources automatiquement, les plateformes hôtelières et de location courte durée qui souhaitent un cliché phare en soirée pour chaque bien, les architectes qui présentent un bâtiment achevé sous la lumière du soir, et les produits de proptech qui veulent intégrer le crépuscule comme une fonctionnalité plutôt que comme une relation prestataire.

Trois façons d'obtenir un cliché au crépuscule : en un coup d'œil

Méthode Coût par image Délai d'exécution Capacité de montée en charge Risque météorologique
Véritable séance photo au crépuscule 200 $ à 750 $ pour une photo au crépuscule (estimation 2026 de PhotoUp) Une seconde visite à la tombée de la nuit Limitée par un seul créneau court de crépuscule par soirée Élevé
Service de retouche manuelle 4 à 5 $ US par retouche jour en crépuscule chez BoxBrownie (octobre 2026) En moins de 24 heures (engagement affiché de BoxBrownie) Une file d'attente humaine de retouche Aucun
API Jour en Crépuscule Environ 0,05 $ à 0,25 $ pour la plupart des tarifs publics comparés ci-dessous ; certains forfaits et la facturation mensuelle coûtent plus cher De quelques secondes à quelques minutes par tâche (documentation de Roomagen : généralement 20 à 60 secondes) Tâches en parallèle, jusqu'aux limites de débit de chaque fournisseur Aucun

Une véritable séance photo au crépuscule reste la référence. Un photographe sur place à la tombée du jour capture la véritable lumière ambiante, les reflets réels et les lumières effectivement présentes dans la maison ; rien n'a besoin d'être prédit. Cela coûte plus cher parce qu'il s'agit d'un déplacement distinct à une heure fixe : le guide tarifaire 2026 de PhotoUp indique qu'« une séance photo de jour basique peut coûter de 200 $ à 400 $ pour une série d'images fixes, contre 200 $ à 750 $ pour une photo au crépuscule » (PhotoUp). Une soirée couverte impose de reprogrammer la séance.

Les services de retouche manuelle font appel à une personne pour convertir la photo de jour. La page des tarifs de BoxBrownie affichait la conversion jour en crépuscule à 4,00 $ US par image lors de certaines de nos vérifications en octobre 2026 et à 5 $ US lors d'autres, confirmez donc le prix qui vous est proposé (tarifs BoxBrownie). Sa page de service indique : « nous garantissons de finaliser vos images sous 24 heures » pour les projets jour en crépuscule (BoxBrownie). Cela convient pour une annonce isolée ; une file d'attente humaine ne fonctionne pas comme une étape le jour même sur des milliers de photos.

La conversion par API exécute un modèle génératif sur la photo par programmation. C'est la seule des trois approches qui se comporte comme une infrastructure : vous pouvez l'intégrer dans un flux de téléversement, la traiter par lot pendant la nuit et l'incorporer dans une marge par annonce. La contrepartie est que le modèle prédit une lumière qu'il n'a jamais vue ; vous avez donc besoin d'un contrôle qualité et d'un plan de divulgation.

Ce qu'exige une bonne conversion jour en crépuscule

La conversion jour en crépuscule fait partie des retouches les plus difficiles à automatiser de manière convaincante, car le modèle doit allumer des sources qui étaient éteintes dans l'image source et rééclairer tout ce qui les entoure. Que vous évaluiez un prestataire ou que vous auditiez vos propres résultats, vérifiez cinq points.

Lueur des fenêtres. Les fenêtres éclairées sont le signal indiquant qu'« il y a quelqu'un à la maison » sur une photo au crépuscule. Une bonne conversion applique une température de couleur chaude et cohérente, fait varier la luminosité d'une pièce à l'autre et laisse certaines fenêtres sombres. Le fait que chaque fenêtre brille exactement avec la même intensité est le signe révélateur classique d'une conversion médiocre.

Dégradé du ciel. Un ciel de crépuscule passe d'un bleu profond au zénith à des tons chauds près de l'horizon, du côté où le soleil s'est couché. Méfiez-vous des ciels plats unicolores et des lueurs à l'horizon qui contredisent les ombres.

Cohérence ambiante et des reflets. Lorsque le ciel change, tout ce qu'il touche doit changer avec lui : le pavage s'assombrit, le verre et l'eau captent le nouveau ciel, et les ombres dures de midi s'adoucissent. Un ciel de crépuscule au-dessus d'une pelouse éclairée comme à midi relève d'un Remplacement de Ciel, pas d'une conversion jour en crépuscule.

Préservation de la structure. Le bâtiment ne doit pas changer : pas de lignes de toiture déplacées, de bardage repeint ou de nouveaux luminaires de porche et équipements de jardin. Pour les photos d'annonces, il s'agit d'une question de conformité autant que de qualité, car une retouche qui modifie le bien immobilier lui-même passe du statut d'amélioration à celui de présentation trompeuse.

Vue et environnement. Ce qui est visible à travers les fenêtres et autour du bâtiment doit rester tel quel. Certaines API peuvent afficher délibérément une vue différente ou une autre saison ; pour la commercialisation d'un bien immobilier réel, désactivez ces options.

Voici une liste de contrôle pour l'évaluation des prestataires et les audits continus :

Point de contrôle Résultat conforme Résultat non conforme
Lueur des fenêtres Luminosité chaude et variée ; certaines fenêtres sombres Toutes les fenêtres éclairées avec la même intensité
Dégradé du ciel Bleu profond au zénith, horizon chaud, direction unique du soleil Ciel plat unicolore ; la lueur contredit les ombres
Cohérence ambiante Le sol, le verre et l'eau reflètent le nouveau ciel Pelouse éclairée comme à midi sous un ciel de coucher de soleil
Structure Bâtiment et équipements fixes conformes à la source Nouveaux luminaires, modification du bardage ou de la géométrie
Vue et environnement Vue, arbres et voisins identiques à la source Nouvelle vue, saison différente, poteaux ou câbles disparus

Pour les pipelines automatisés, auditez un échantillon représentatif fixe des résultats chaque semaine en vous basant sur ce tableau, et définissez votre politique de régénération avant le lancement, afin qu'un rendu défectueux suive un cheminement programmatique plutôt qu'un ticket d'assistance. Le ciel est la partie facile ; la lueur des fenêtres et la cohérence ambiante sont les aspects sur lesquels les conversions se différencient.

Le panorama des API Jour en Crépuscule en 2026

De nombreux outils convertissent le jour en crépuscule au sein d'une interface web. Ils sont moins nombreux à documenter une API sur laquelle vous pouvez développer. En voici cinq qui le font, avec des tarifs tels que publiés en octobre 2026 :

Fournisseur Modalité d'accès au jour en crépuscule Réception du résultat Tarif public Remarques
AI HomeDesign L'un des cinq services sur son API REST Webhooks 0,24 $ par photo avec facturation annuelle (588 $ par an pour 200 photos par mois) ; la facturation annuelle « permet d'économiser 51 % par rapport au mensuel » Crédits gratuits à l'inscription ; les résultats ne portent aucun marquage AI HomeDesign
InstantDeco Type de transformation day_to_dusk : « Assombrit l'image, allume les lumières intérieures et transforme le ciel en crépuscule » Rappel par webhook_url avec un lien vers l'image 49 $ par mois avec facturation annuelle ou 79 $ par mois pour 500 photos ; 99 $ ou 139 $ pour 2 000 ; photos supplémentaires à 0,05 $–0,15 $ Environ 0,05 $ à 0,16 $ par photo en utilisant l'intégralité du forfait ; résiliation possible à tout moment
Virtual Staging AI Type de rendu jour en crépuscule dans son API v2, avec les styles de ciel Dusk, Golden et Blue Webhooks (recommandés pour la production) ou attente synchrone L'accès à l'API est inclus dans le forfait Enterprise : 79 $ par mois avec facturation annuelle pour 150 photos ; aucun tarif unitaire jour en crépuscule n'est répertorié Home staging et amélioration sur la même API
Collov Endpoints « Virtual twilight » et « natural twilight » sur son API Enterprise Les appels crépuscule renvoient l'URL de l'image générée ; ses tâches asynchrones fonctionnent par polling L'accès à l'API est inclus dans le forfait Enterprise : 127 $ par mois avec facturation annuelle pour 526 crédits photo ; photos supplémentaires à 0,24 $ Limites documentées : 10 requêtes par seconde, 2 tâches simultanées
API Jour en Crépuscule de Roomagen day-to-dusk et day-to-dusk-exterior, tous deux documentés, sur une API de tâches unique Webhooks signés ou interrogation périodique (polling) 0,20 $ à 0,25 $ par image via des packs prépayés : 500 pour 125 $, 2 500 pour 550 $, 10 000 pour 2 000 $ 50 images gratuites sur la première clé, avec filigrane jusqu'à l'achat d'un pack ; tâches échouées remboursées automatiquement

Roomagen est notre propre API, voici donc où elle se situe : les clés sont en libre-service depuis le 30 août 2026, les packs n'expirent jamais et sont cumulables, une seule clé couvre l'ensemble des outils documentés, et nos outils d'image fonctionnent sur les modèles d'image Gemini de Google. L'exemple pratique ci-dessous explique lequel des deux slugs jour en crépuscule utiliser.

Comment restreindre votre choix :

  • Besoin d'une distribution push ? AI HomeDesign, InstantDeco, Virtual Staging AI et Roomagen documentent des webhooks ; la documentation de Collov décrit un fonctionnement par polling, et sa limite de deux tâches simultanées est à prendre en compte pour les rattrapages massifs de données (backfills).
  • Le tarif public le plus bas ? InstantDeco propose les tarifs par photo les plus bas de ce tableau et offre une facturation mensuelle ; prévoyez un budget pour les tests de qualité et les régénérations avant d'engager de gros volumes.
  • Pas d'abonnement ? Roomagen vend des packs prépayés ; les quatre autres vendent des forfaits, et les prix d'AI HomeDesign, Virtual Staging AI et Collov ci-dessus supposent une facturation annuelle.
  • Contrôle sur l'aspect visuel ? Roomagen prend en compte une heure cible de 0 à 23, Virtual Staging AI propose trois styles de ciel, et Collov propose deux variantes de crépuscule.
  • Dans tous les cas : soumettez un même lot de 20 à 50 de vos propres photos d'extérieurs à chacune des API présélectionnées et évaluez-les à l'aide de la liste de contrôle ci-dessus.

Méfiez-vous d'une catégorie voisine qui apparaît dans les mêmes recherches. Un remplacement de ciel échange simplement le ciel, parfois contre un ciel aux couleurs crépusculaires, en laissant les fenêtres, le sol et les reflets tels quels. Si la démonstration d'un prestataire montre un ciel modifié mais des fenêtres et des ombres inchangées, vous êtes en présence d'un remplacement de ciel facturé au prix d'une conversion crépusculaire.

Automatiser le processus : un exemple pratique

Voici la boucle d'automatisation sur l'API de Roomagen. La structure globale (soumettre une tâche, recevoir un rappel, stocker le résultat, gérer les échecs) est transposable aux autres fournisseurs avec des noms de champs différents. La référence complète se trouve dans le guide de démarrage rapide de l'API Roomagen.

Étape 0 : choisir le bon slug. GET /v1/tools renvoie l'ensemble des slugs que votre clé peut appeler ; lisez cette liste plutôt que de coder les noms en dur. Deux nous intéressent ici :

  • day-to-dusk est le slug pour les intérieurs. Il exécute le même outil que Changement horaire dans notre application web : une heure cible de 0 à 23 (timeShift, valeur par défaut 20), une vue extérieure optionnelle depuis la fenêtre (viewType, valeur par défaut none, ce qui préserve la vue réelle), une saison (season) qui ne s'applique qu'à une vue générée, et hasWindows pour les pièces sans fenêtre.
  • day-to-dusk-exterior est l'outil pour les façades associé à Décalage Horaire Extérieur. Il analyse d'abord la photo, puis applique l'heure (timeShift, valeur par défaut 20) et une saison optionnelle (season). Il est documenté depuis le 3 octobre 2026 ; testez-le sur vos propres extérieurs avant d'en faire dépendre votre production.

Étape 1 : soumettre la tâche. Envoyez l'extérieur de jour par URL :

curl -X POST https://api.roomagen.com/api/v1/jobs \
  -H "X-Api-Key: $ROOMAGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: listing-1042-front-dusk" \
  -d '{
    "tool": "day-to-dusk-exterior",
    "image_url": "https://cdn.example.com/listing-1042/front.jpg",
    "options": { "timeShift": 20 },
    "webhook_url": "https://example.com/hooks/roomagen"
  }'

L'API répond immédiatement par un code 201 avec un job_id, "status": "processing" et images_charged : une image pour la résolution par défaut en 2K, deux si vous ajoutez "resolution": "4K" dans les options. La source doit être une URL publique en https servant du JPEG, PNG ou WebP jusqu'à 20 Mo, ou le fichier transmis directement en ligne sous forme de image_base64. L'en-tête Idempotency-Key sécurise les nouvelles tentatives : la répétition de la même clé et du même corps de requête après un délai d'attente dépassé renvoie la tâche d'origine, sans facturation supplémentaire. Dérivez-la de vos propres enregistrements, tels que les identifiants d'annonce et de photo, jamais d'une valeur aléatoire que vous ne stockez pas.

Étape 2 : recevoir le résultat. La documentation de Roomagen indique que les tâches sont généralement prêtes en 20 à 60 secondes. Avec une webhook_url sur la tâche (ou un endpoint global pour le compte configuré dans le portail développeur), Roomagen vous envoie la tâche terminée par une requête POST : l'objet renvoyé par GET /v1/jobs/{id}, augmenté d'un champ event défini sur job.completed ou job.failed. Vérifiez la signature en premier lieu. Il s'agit d'un HMAC-SHA256 calculé sur l'horodatage et le corps brut de la requête, signé avec votre secret whsec_ :

import crypto from "node:crypto";
import express from "express";

const app = express();

app.post("/hooks/roomagen", express.raw({ type: "application/json" }), async (req, res) => {
  const ts = req.get("X-Roomagen-Timestamp") ?? "";
  const sig = req.get("X-Roomagen-Signature") ?? "";
  const expected = "v1=" + crypto
    .createHmac("sha256", process.env.ROOMAGEN_WEBHOOK_SECRET)
    .update(`${ts}.${req.body}`)
    .digest("hex");
  const got = Buffer.from(sig);
  const want = Buffer.from(expected);
  const fresh = Math.abs(Date.now() / 1000 - Number(ts)) < 300;
  // Comparez d'abord les longueurs d'octets : timingSafeEqual lève une erreur si elles diffèrent.
  if (!fresh || got.length !== want.length || !crypto.timingSafeEqual(got, want)) {
    return res.sendStatus(401);
  }
  const job = JSON.parse(req.body);
  await enqueueResult(job); // votre code : dédupliquez sur job.job_id, puis stockez
  res.sendStatus(200);
});

La distribution s'effectue au moins une fois (at-least-once) sans garantie d'ordre, et une livraison échouée fait l'objet de nouvelles tentatives, jusqu'à cinq essais répartis sur environ 36 minutes. Considérez les webhooks comme une optimisation et non comme un système d'enregistrement de référence : réconciliez tout élément jamais reçu à l'aide de GET /v1/jobs/{id}. Pour des scripts à faible volume, un polling toutes les 2 à 5 secondes fonctionne très bien ; arrêtez-vous sur le statut completed ou failed.

Étape 3 : stocker la paire d'images. Téléchargez le rendu depuis result_urls et associez-le à l'annonce. Les résultats sont servis depuis le stockage de Roomagen selon des limites de rétention ; conservez donc votre propre copie plutôt que de faire des liens directs (hot-linking), et gardez la photo originale de jour, l'identifiant de la tâche ainsi qu'un indicateur de modification dans le même enregistrement. L'objet de la tâche renvoie les résultats, pas les originaux, et vous aurez besoin de l'original pour la divulgation et le contrôle qualité. Les rendus portent un filigrane Roomagen jusqu'à ce que le compte achète un pack ; par la suite, les données en sortie de l'API ne comportent aucun filigrane ni image de marque de Roomagen.

Étape 4 : gérer les échecs dans le code. Certaines tâches sont rejetées dès la soumission (invalid_image, image_fetch_failed), et un petit nombre échoue pendant la génération (generation_failed), se soldant par un statut status: "failed", un message d'erreur explicite lisible (error) et un remboursement automatique. Une politique raisonnable consiste à réessayer une fois, puis à publier la photo de jour et à marquer l'annonce pour examen humain. Quel que soit le prestataire, renseignez-vous sur le coût d'une génération échouée, car les échecs sans remboursement augmentent discrètement votre prix de revient réel par image.

Voilà pour l'intégralité de l'intégration : un POST, un gestionnaire de webhook, une étape de stockage et une branche de gestion des erreurs. La même structure de requête s'applique aux autres outils documentés de Roomagen, tels que le Home Staging Virtuel, la Rénovation et Remodelage Virtuels, l'Amélioration de photos, la Suppression d'objets et d'éléments par IA dans les photos et le Plan d'étage en 3D ; en ajouter un implique une nouvelle valeur pour tool et des options, et non une nouvelle intégration. Pour un tutoriel plus détaillé incluant un front-end, consultez notre tutoriel d'intégration de l'API de home staging virtuel.

Stratégie de traitement par lot pour les entreprises de photographie et les portails

La conversion d'une seule photo relève de la démonstration ; la conversion par lot constitue le modèle économique. Quatre approches permettent au traitement par lot de fonctionner efficacement pour les entreprises de médias et les plateformes d'annonces.

Convertissez la photo de couverture extérieure, pas toute la photothèque. Placez la version au crépuscule là où elle est vue en premier, à savoir la photo de couverture dans les résultats de recherche et les fiches d'annonces, et convertissez un seul extérieur de façade par annonce. Cela limite le coût à une image par annonce et représente le moyen le plus simple pour une entreprise de photographie de facturer le crépuscule comme une prestation additionnelle.

Exécutez les rattrapages massifs sous forme de traitement nocturne. Recherchez les annonces dépourvues de couverture au crépuscule, soumettez les tâches avec des clés d'idempotence construites à partir des identifiants d'annonce et de photo, collectez les webhooks et publiez le matin. Restez dans les limites de débit : Roomagen accepte 60 soumissions de tâches par minute et par clé, ce qui signifie qu'un rattrapage de 1 000 photos nécessite environ 17 minutes rien que pour la soumission. Appelez d'abord GET /v1/account, qui renvoie le nombre d'images que la clé peut encore générer, et prévoyez une alerte en cas de solde faible avant l'exécution plutôt qu'au beau milieu de celle-ci.

Calculez vos marges par image exploitable, pas par appel d'API. Avec les packs de Roomagen, une image coûte de 0,20 $ à 0,25 $. Une entreprise de photographie qui convertit 500 photos de couverture par mois dépense 125 $, contre 2 000 à 2 500 $ US pour les 500 mêmes retouches aux tarifs publics de 4 à 5 $ US de BoxBrownie. Intégrez ensuite votre taux de régénération : si une image sur cinq nécessite un second essai, une image à 0,25 $ revient à 0,30 $ par résultat exploitable. Même en y ajoutant le temps de contrôle qualité, l'écart avec la retouche manuelle, et avec les séances crépusculaires réelles facturées de 200 $ à 750 $, demeure considérable. La première clé est fournie avec 50 images gratuites pour vos tests.

Pas de code ? Utilisez le traitement par lot dans l'application web. Les équipes qui ne souhaitent pas réaliser d'intégration peuvent exécuter le Changement horaire sur plusieurs photos à la fois dans l'application web de Roomagen. Avec les forfaits payants, cochez les photos dans la Bibliothèque ou déposez-les ensemble : le forfait Starter prend en charge 3 photos par lot, Pro en traite 7 et Business 20, avec un outil par lot. Chaque lot dispose de son propre dossier dans la Bibliothèque avec une barre de progression en direct et un téléchargement au format ZIP, les photos échouées sont remboursées, et Time Shift Interior vous permet de définir les fenêtres, la vue et la saison pour chaque photo. L'API ne dispose pas d'endpoint de traitement par lot ; vous y envoyez une tâche par image.

Quand ne pas convertir une photo

Un pipeline automatisé a besoin de règles explicites d'exclusion et d'acheminement, car toutes les photos ne doivent pas être transformées en photos crépusculaires.

Excluez les photos qui sont déjà prises au crépuscule ou de nuit. Il n'y a rien à gagner à convertir à nouveau une véritable photo prise au crépuscule, et un second passage risque de l'assombrir excessivement. Si votre pipeline ne peut pas identifier avec certitude l'heure de prise de vue à partir des données EXIF ou de la luminosité, transférez les images ambiguës à un opérateur humain plutôt que de les convertir à l'aveugle.

Acheminez les intérieurs et les extérieurs vers le bon outil. La conversion d'un extérieur concerne la façade, le ciel et les fenêtres vues de dehors ; celle d'un intérieur concerne l'éclairage de la pièce et la vue à travers la vitre. Catégorisez d'abord les photos et envoyez chacune vers l'outil correspondant (sur Roomagen, day-to-dusk-exterior ou day-to-dusk). Ignorez les pièces sans fenêtre, ou transmettez hasWindows: false, ce qui indique au modèle qu'il n'y a pas de fenêtres à illuminer.

Écartez les fichiers sources de mauvaise qualité. Les façades avec un fort contre-jour, le flou de bougé et les photos en basse résolution tendent à produire des rendus crépusculaires décevants, car le modèle amplifie tout ce qui manque de netteté dans la source. Corrigez-les au préalable avec l'Amélioration de photos ou l'Éditeur HDR, ou refaites la prise de vue.

Ne modifiez pas la vue d'une annonce réelle. Certaines API, dont la nôtre, peuvent générer une vue différente à travers les fenêtres ou changer la saison. Notre propre documentation l'exprime clairement : « Modifiez la lumière en toute liberté ; ne modifiez les faits que de manière délibérée. » Pour les photos d'annonces, laissez viewType et season sur none.

Sachez où se situe la frontière réglementaire de la conformité. En Californie, le texte AB 723 a ajouté l'article § 10140.8 au Business and Professions Code, et le régulateur immobilier de l'État précise : « À compter du 1er janvier 2026, les titulaires de licence doivent également se conformer à l'article 10140.8 du Bus. & Prof. Code lorsqu'ils utilisent des images modifiées numériquement dans la publicité immobilière » (California DRE). La loi s'applique aux images modifiées « pour ajouter, supprimer ou changer des éléments », y compris les « éléments extérieurs au bien ou visibles depuis celui-ci », tels que les « vues à travers les fenêtres ». Elle exclut les images sur lesquelles « seuls des ajustements d'éclairage, d'accentuation de netteté, de balance des blancs, de correction colorimétrique… ou d'autres ajustements courants de retouche photo sont effectués, ne modifiant pas la représentation du bien immobilier lui-même » (AB 723). Une conversion crépusculaire par IA remplace le ciel et allume des sources qui étaient éteintes ; l'interprétation prudente consiste donc à la traiter comme une image modifiée : apposez une mention de divulgation sur l'image ou à côté de celle-ci et intégrez un lien vers l'original non modifié, comme l'exige l'article § 10140.8. Les règlements des MLS imposent leurs propres étiquettes et contraintes d'ordre d'affichage des photos ; notre guide de conformité AB 723 et des règles photo des MLS ainsi que notre guide des exigences photo des MLS et de divulgation du home staging virtuel détaillent ces aspects.

La responsabilité incombe à l'annonceur, non à l'outil. Le même avis rappelle que si un outil d'IA produit une publicité trompeuse, « la responsabilité en vertu de la loi en vigueur incombe au titulaire de la licence et à son courtier responsable, et non au fournisseur de la technologie. » Si vous exploitez une plateforme qui convertit des photos pour des agents, facilitez la divulgation en conservant l'indicateur de modification et la photo originale tout au long de votre pipeline. L'API de Roomagen n'ajoute pas d'étiquettes de divulgation et ne conserve pas les originaux pour vous ; prévoyez donc cette gestion dans vos propres enregistrements.

Liste de contrôle d'intégration

  1. Soumettez un même lot de 20 à 50 de vos propres extérieurs à deux ou trois fournisseurs et évaluez-les selon les cinq points de contrôle présentés ci-dessus.
  2. Récupérez les slugs depuis l'API (GET /v1/tools sur Roomagen) au lieu de coder en dur les dénominations commerciales.
  3. Dérivez les clés d'idempotence des identifiants d'annonce et de photo pour qu'une nouvelle tentative ne soit jamais facturée deux fois.
  4. Utilisez des webhooks en production, vérifiez chaque signature, dédupliquez sur l'identifiant de la tâche et réconciliez les rappels manquants par polling.
  5. Stockez ensemble l'original, le résultat, l'identifiant de la tâche et un indicateur de modification ; téléchargez les résultats au lieu de faire des liens directs (hot-linking).
  6. Acheminez les extérieurs et les intérieurs vers l'outil approprié, et ignorez les photos déjà prises au crépuscule.
  7. Laissez les options de vue et de saison désactivées pour les annonces réelles.
  8. Vérifiez le solde restant avant chaque lot de traitement.
  9. Auditez un échantillon fixe des résultats chaque semaine, avec une politique de régénération convenue à l'avance.
  10. Affichez une mention de divulgation et un lien vers l'original partout où une image convertie est publiée.

En résumé

Les photos au crépuscule constituent un cas d'usage où la demande, la rentabilité économique et les outils convergent parfaitement. Le crépuscule virtuel a été l'amélioration connaissant la plus forte croissance chez HomeJab en 2025, une conversion par API coûte quelques centimes là où une retouche manuelle coûte plusieurs dollars et une séance photo crépusculaire plusieurs centaines, et au moins cinq fournisseurs documentent désormais une API jour en crépuscule. Pour les entreprises de photographie, les portails, les plateformes d'hébergement et les solutions de proptech, la conversion jour en crépuscule est devenue une décision d'infrastructure (une étape de pipeline avec un webhook, une politique de remboursement et une liste de contrôle qualité) plutôt qu'une décision photographique. Fixez vos prix par image exploitable, et intégrez les règles d'exclusion ainsi que les métadonnées de divulgation dès le premier jour.

Pour juger du résultat avant d'écrire la moindre ligne de code, essayez la Retouche & Conversion Photo Jour en Crépuscule dans l'application web de Roomagen ; pour les façades, utilisez le mode Extérieur Jour-Nuit. Les 6 crédits uniques du forfait Gratuit couvrent trois essais avec filigrane. Lorsque vous serez prêt à automatiser vos flux, la page de l'API Jour en Crépuscule détaille l'ensemble des tarifs, et votre première clé API est livrée avec 50 images gratuites.

Prêt à transformer vos annonces ?

Essayez gratuitement le home staging virtuel IA de Roomagen. Importez votre première photo et découvrez le résultat, généralement en moins d'une minute.

Commencer gratuitement

Questions fréquemment posées

Une API de retouche jour en crépuscule convertit une photo diurne d'un bâtiment en une version crépusculaire via HTTP. Vous soumettez l'image, un modèle génératif assombrit le ciel, allume les lumières intérieures et ajuste la lumière ambiante, puis vous récupérez le résultat par webhook ou interrogation périodique (polling).

Les tarifs d'API publiés varient d'environ 0,05 $ à 0,16 $ par photo sur les forfaits InstantDeco, 0,24 $ avec la facturation annuelle d'AI HomeDesign et de 0,20 $ à 0,25 $ dans les packs prépayés de Roomagen. En comparaison, BoxBrownie affiche des retouches manuelles jour en crépuscule entre 4 $ US et 5 $ US, et PhotoUp estime une séance photo au crépuscule entre 200 $ et 750 $.

La documentation de l'API de Roomagen indique que les tâches sont généralement prêtes en 20 à 60 secondes ; pour les autres fournisseurs, faites des tests avec vos propres images. Les tâches s'exécutent de manière asynchrone, vous interrogez donc la tâche toutes les quelques secondes ou recevez un webhook, et de nombreuses images peuvent être traitées en parallèle dans la limite des quotas de requêtes.

AI HomeDesign, InstantDeco, Virtual Staging AI, Collov et Roomagen documentent tous la conversion jour en crépuscule ou twilight dans leurs API. Ils diffèrent par le mode de livraison (webhooks ou polling), la facturation (abonnements ou packs prépayés) et les options de contrôle comme le style de ciel ou l'heure cible, testez-les donc sur vos propres photos.

Une véritable séance photo au crépuscule capture la lumière réelle, les reflets et les luminaires allumés, tandis qu'une conversion par IA les prédit ; une séance photo reste donc la référence en matière de qualité. Une bonne conversion peut très bien convenir comme photo de couverture d'une annonce, mais examinez chaque résultat pour vérifier l'absence d'éclat uniforme aux fenêtres, d'ombres incohérentes ou de structures modifiées.

Par précaution, traitez-la comme une image modifiée numériquement. Le projet de loi AB 723 de Californie, en vigueur depuis le 1er janvier 2026, exige une divulgation ainsi qu'un lien vers l'original non modifié, et son exception pour l'éclairage ne concerne que les retouches qui ne changent pas la représentation du bien. Vérifiez auprès de votre MLS ses propres règles d'étiquette.

Oui : envoyez une tâche par image, en parallèle, dans la limite des quotas du fournisseur ; l'API de Roomagen accepte 60 soumissions de tâches par minute et par clé. Sans code, l'application web de Roomagen prend en charge des lots de 3, 7 ou 20 photos avec les forfaits Starter, Pro ou Business.

Les politiques varient, confirmez-les donc avant d'engager du volume. Sur l'API de Roomagen, une tâche qui échoue pendant la génération se termine avec le statut "failed" et fait l'objet d'un remboursement automatique ; une approche judicieuse consiste donc à réessayer une fois, puis à publier la photo de jour en cas de nouvel échec. Sans remboursement, les échecs augmentent discrètement votre coût réel par image.

Les indices révélateurs les plus courants sont des fenêtres brillant toutes avec la même intensité, un ciel uni sans nuances, et un sol ou des reflets encore éclairés par le soleil de midi sous un ciel couchant. Des luminaires inventés, un bardage modifié ou une vue altérée à travers les fenêtres constituent des défauts de qualité et de potentiels problèmes de conformité.

Non : le Remplacement de Ciel substitue le ciel, parfois par une teinte crépusculaire, mais conserve le bâtiment, les fenêtres et l'éclairage au sol tels quels. La Retouche & Conversion Photo Jour en Crépuscule rééclaire l'ensemble de la scène, y compris le dégradé du ciel, l'éclat des fenêtres, la lumière ambiante et les reflets. Une démonstration avec un nouveau ciel mais des ombres diurnes relève du Remplacement de Ciel.
Roomagen

Rédigé par

Roomagen Team

L'équipe Roomagen crée des guides approfondis sur le home staging virtuel IA, la photographie immobilière et les stratégies de marketing immobilier.

Articles Associés

AB 723 et règles MLS : photo d'annonce IA conforme ?

AB 723 et règles MLS : photo d'annonce IA conforme ?

L'AB 723 en Californie impose une divulgation bien visible et l'accès à l'original pour chaque photo d'annonce modifiée par IA, et des MLS comme CRMLS refusent certaines retouches même avec une étiquette. Découvrez ce qui est considéré comme modifié, qui est responsable, les changements pour les locations en 2027 et un test photo en 8 questions.

Lire la suite
Top 10 API de Home Staging Virtuel 2026 : prix et offre

Top 10 API de Home Staging Virtuel 2026 : prix et offre

Nous avons comparé dix API de Home Staging Virtuel sur le prix par image affiché, les essais gratuits, les webhooks, les rendus en marque blanche et les politiques d'échec, à partir des pages des fournisseurs vérifiées en octobre 2026. Comprend des scénarios de coûts mensuels de 500 à 10 000 images.

Lire la suite
API de Home Staging Virtuel : guide et code (2026)

API de Home Staging Virtuel : guide et code (2026)

Un tutoriel pas à pas pour développeurs afin d'ajouter le home staging virtuel par IA à toute application via une API REST. Le code suit l'API documentée de Roomagen : soumettre une tâche, vérifier les webhooks signés, utiliser le sondage en secours, stocker les résultats et intégrer la divulgation.

Lire la suite
Photo jour en crépuscule : crépuscule réel vs virtuel (2026)

Photo jour en crépuscule : crépuscule réel vs virtuel (2026)

Comment les photos immobilières au crépuscule sont réalisées en 2026 : une vraie séance à l'heure bleue ou un crépuscule virtuel créé à partir d'une photo de jour. Timing, réglages d'appareil, coûts, critères de choix et divulgation des retouches.

Lire la suite
Photo jour en crépuscule : retouche, conversion et IA (2026)

Photo jour en crépuscule : retouche, conversion et IA (2026)

Vrai shooting au crépuscule, retouche manuelle ou conversion par IA ? Nous comparons les tarifs 2026 pour les photos jour en crépuscule, analysons les faits et expliquons comment les divulguer.

Lire la suite