Developer API — Live

Day to Dusk API

Twilight exteriors make strong hero images, but evening shoots are hard to schedule at scale. With the Roomagen day to dusk API, a daylight photo of a building is relit for the hour you pick (the sky turns, the light comes in at that hour’s angle and, after sunset, the lights already on the building glow) through one API call, and the model is told to keep the facade, planting and composition as photographed. Jobs are typically ready in 20–60 seconds.

Get your API key
Day to Dusk API input
input.jpg
Day to Dusk API result
✓ result.jpg · 44s

Who builds with this endpoint

Real-estate media companies

Offer twilight conversion as a line item on every shoot without scheduling evening sessions — daylight exteriors from the day shoot become dusk shots in post.

Listing portal automation

Generate a twilight hero image for featured listings automatically, giving premium placements a distinct look without any manual editing step.

Architecture visualization studios

Produce dusk variants of exterior renders and site photography for client presentations, showing how a facade reads under evening light.

Hospitality marketing

Turn daytime shots of hotels, resorts and restaurant exteriors into inviting evening imagery for booking pages and seasonal campaigns.

One request, one webhook

Submit a job with the day-to-dusk-exterior tool, get a job id, receive a webhook when the result is ready.

POST /api/v1/jobs — day-to-dusk-exterior
$ curl -X POST https://api.roomagen.com/api/v1/jobs \
-H "X-Api-Key: rmg_live_..." \
-H "Content-Type: application/json" \
-d '{
"tool": "day-to-dusk-exterior",
"image_url": "https://example.com/photo.jpg",
"options": {"timeShift":20,"season":"none"},
"webhook_url": "https://yourapp.com/hooks/roomagen"
}'
# → { "job_id": "3f1c9d4e-…", "status": "processing", "images_charged": 1, "warnings": [] }

Every option of day-to-dusk-exterior in the docs → · All documented tools

Prepaid, per image

Developer

$0

50 watermarked images, one time

first key only

Pilot

$125

500 images

$0.25 / image

Buy in the portal

Prepaid · never expires

Most popular

Growth

$550

2,500 images

$0.22 / image

Buy in the portal

Prepaid · never expires

Scale

$2,000

10,000 images

$0.20 / image

Buy in the portal

Prepaid · never expires

Full pricing on the API overview →

Up and running in minutes

Create a key, send one POST, get the finished image back. No sales call, no onboarding queue.

roomagen-api — quickstartv1
  1. 1

    Create your key

    Sign in to the developer portal and generate a key. It is shown once, so store it somewhere safe.

    developers.roomagen.com/portal ↗
  2. 2

    Run your first job

    One POST with a tool slug and your image. It returns immediately with a job id — generation runs in the background.

    $ curl -X POST https://api.roomagen.com/api/v1/jobs \
    -H "X-Api-Key: rmg_live_..." \
    -H "Content-Type: application/json" \
    -d '{ "tool": "day-to-dusk-exterior",
    "image_url": "https://example.com/photo.jpg",
    "options": { "timeShift": 20, "season": "none" } }'
    # → 201 { "job_id": "3f1c9d4e-…", "status": "processing", "images_charged": 1, "warnings": [] }
  3. 3

    Get the result

    Set a webhook_url and we call you when the image is ready, or poll the job endpoint. Typically 20–60 seconds.

    POST → your webhook_urlGET /api/v1/jobs/{id}

✓ 50 free images on your first key, watermarked until you buy a pack · no card required

Day to Dusk API FAQ

After sunset, the lights already on the building glow, which is what makes a twilight photo feel lived in. There is no separate switch for it: timeShift sets the hour, and at later hours those lights carry more of the image. It is an AI edit, so check each light against the original.

The sky and light are generated for the hour you set, so the result is an AI edit, not a photograph. Review each one against the original before publishing, and disclose the edit where your listing rules require it.

Yes, with timeShift: the target hour on a 24-hour clock, from 0 to 23. The default, 20, is the dusk look most listings want; 17 and 18 give golden hour, and 21 and later move toward night. The optional season key changes the foliage, so leave it at none unless the season should change.

Not by the API: a completed job’s result_urls holds only the converted image. Keep your own copy of the daylight original to show both versions or to meet a disclosure rule.

Yes, with the interior tool, day-to-dusk: it treats every photo as a room, turns on the lamps and fixtures already in it and keeps the real view through the windows unless you choose another. day-to-dusk-exterior is for facades, gardens and pool decks; both are documented and cost one image per render.

The same prepaid packs as every Roomagen tool: 500 images at $0.25, 2,500 at $0.22, and 10,000 at $0.20; a 4K render counts as two. Your first API key comes with 50 free images, one time, which carry a Roomagen watermark until you buy a pack.