Guide

Seasons and holidays

Show a property in another season, or decorated for a holiday.

Two tools that change when a photo seems to have been taken: one moves it to another season, the other dresses it for a holiday. Each costs one image per render, and neither takes a custom prompt. To change the time of day instead, see day to dusk and day to dusk for exteriors.

Seasonal changes

seasonal-changes1 image per renderno custom prompt — customPrompt is ignored

Shows the scene in spring, summer, autumn or winter. In an exterior or landscape the whole outdoor scene changes — foliage, ground cover, sky and light. In an interior only the view through the windows changes, with the daylight in the room matched to it; furniture, walls and decor stay. A windowless interior only gets the season's light.

Option	Type	Values	Default	Required	Description
`season`	string	`springsummerautumnwinter`	`spring`	optional	The season to show. Outdoors the whole scene changes; indoors only the view through the windows and the colour of the daylight do.

json

{
  "tool": "seasonal-changes",
  "image_url": "https://example.com/house-in-summer.jpg",
  "options": { "season": "autumn" }
}

Be careful what you change

A season changes what the photo says about the property: autumn colours on a garden photographed in spring, or snow that was never there. Use it to show a property across the year, and label the photo as edited where it is published.

Festive flip

festive-flip1 image per renderno custom prompt — customPrompt is ignored

Adds tasteful decorations for a holiday or a seasonal theme, placed for the space the photo shows: mantels, tables, doorways and windowsills inside; porches, doors, railings, rooflines and walkways outside. Only the decorations of the chosen theme are added: the structure, the windows and every piece of furniture stay where they are.

Option	Type	Values	Default	Required	Description
`holiday`	string	`christmashalloweeneasterday-of-the-deadthanksgivingvalentinesst-patricksfourth-of-julyhanukkahdiwalichinese-new-yearmid-autumnramadaneidjapanese-new-yearobonchuseoknowruzholikwanzaamidsummerbrazilian-carnivaloktoberfestindian-harvestsongkranspringsummerfall-autumnwinter-cozyharvesttropical`	`christmas`	optional	The holiday or seasonal theme.
`holidayRegion`	string	—	—	optional	Regional style, for the three holidays that have one: christmas (american, nordic, german, british, mediterranean, latin-american, orthodox, japanese), halloween (american, european) and easter (western, orthodox-european). Left out, or a style the holiday does not have, the first one listed is used. Other themes have a single decoration list and ignore it.
`decorations`	string	—	—	optional	Comma-separated item ids from the theme's list, as the web app's picker sends them: only those items are asked for, and the model is told to leave out the rest. Ids the list does not have are ignored; left out, or with none the list has, every decoration of the theme is asked for.

json

{
  "tool": "festive-flip",
  "image_url": "https://example.com/living-room.jpg",
  "options": {
    "holiday": "christmas",
    "holidayRegion": "nordic"
  }
}

Christmas, Halloween and Easter come in regional styles, and their decorations are listed per region; holidayRegion picks one. Without it, or with a style the holiday does not have, the first style is used: american for Christmas and Halloween, western for Easter. Every other theme has a single list and ignores holidayRegion.

decorations carries the web app's picker selection: comma-separated item ids from the theme's list. Only those items are asked for, and the model is told to leave out the rest; ids the list does not have are ignored. Leave it out to use every decoration of the theme.

Next steps

Day to dusk — relight a room for the evening.
Tools — every tool and what it costs.