Developer API — Live

Photo Enhancement API

Every photo that passes through your platform can leave brighter and truer to color than it arrived. The Roomagen Photo Enhancement API corrects exposure, white balance and contrast on property and product images, with one intensity option instead of a panel of sliders. Jobs are typically ready in 20–60 seconds.

Get your API key
Photo Enhancement API input
input.jpg
Photo Enhancement API result
✓ result.jpg · 25s

Who builds with this endpoint

Photographer workflow platforms

Run baseline exposure and color correction on entire shoots the moment they upload, so photographers deliver faster and spend editing time only on hero shots.

Property portals

Normalize the quality of user-submitted listing photos at ingest — dark interiors, mixed lighting and dull colors get corrected before a listing goes live.

Hotel and OTA listing pipelines

Keep large sets of room and amenity photos consistent across properties and seasons, without asking each hotel to reshoot or hand-edit.

Online marketplaces

Enhance seller photos automatically so items shot on a phone in poor light still present well, without adding a step to the listing flow.

One request, one webhook

Submit a job with the image-enhancement tool, get a job id, receive a webhook when the result is ready.

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

Every option of image-enhancement 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": "image-enhancement",
    "image_url": "https://example.com/photo.jpg",
    "options": { "intensity": "medium" } }'
    # → 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

Photo Enhancement API FAQ

Underexposed corners, color casts from mixed daylight and tungsten light, flat contrast and blown-out windows. It corrects an existing photo; it does not change the room or add furniture. Choose light, medium (the default) or heavy with the intensity option.

In pixel size, yes: the enhanced image is never smaller than your photo’s long edge, and a render that comes back smaller is resampled up to match. Resampling keeps the size but does not add detail.

No. A completed job returns only the enhanced image in result_urls, served from Roomagen storage under a retention limit, so download it. Keep your own copy of the original for comparisons, undo and any disclosure rule.

Both are supported. Submitting a job returns a job id immediately; a webhook fires when processing finishes, or you can poll the job status endpoint every 2–5 seconds. Webhooks suit high-volume pipelines, polling suits simple scripts.

Yes — creating your first API key adds 50 free images to the account, one time and with no card required. They render with a Roomagen watermark until you buy a pack and cover the full job lifecycle, webhooks included, so you can build and test end to end before purchasing.

Credits are prepaid and denominated in images: 500 at $0.25, 2,500 at $0.22, and 10,000 at $0.20 per image; a 4K render counts as two. Failed generations are refunded automatically, and packs never expire.