Pixly Developer Docs

Furnish and style an empty (or badly furnished) room photo in a chosen interior style. The flagship tool. HD, watermark-free results. Some stagings also render a free second version: get_job then lists both under `versions` (the second can take a minute or two longer) — show the user both and let them pick. Costs credits from the user's Pixly balance.

curl -X POST https://pixly.app/api/v1/tools/virtual_staging \
  -H "Authorization: Bearer $PIXLY_API_KEY" -H "Content-Type: application/json" \
  -d '{"imageUrl":"https://example.com/room.jpg","style":"..."}'

Apply a specific change to a previously staged photo (swap the sofa, add a rug) while preserving everything else. Costs credits from the user's Pixly balance.

curl -X POST https://pixly.app/api/v1/tools/edit_staged_photo \
  -H "Authorization: Bearer $PIXLY_API_KEY" -H "Content-Type: application/json" \
  -d '{"imageUrl":"https://example.com/room.jpg","style":"...","customInstructions":"..."}'

Turn a single listing photo into a short cinematic clip with a professional camera move (zoom, orbit, fly-through, crane up…). No second frame needed. Costs credits from the user's Pixly balance.

curl -X POST https://pixly.app/api/v1/tools/cinematic_motion \
  -H "Authorization: Bearer $PIXLY_API_KEY" -H "Content-Type: application/json" \
  -d '{"imageUrl":"https://example.com/room.jpg"}'

Turn a start photo — and optionally an end photo — into a video. With an end photo the camera travels from the first photo and lands exactly on the second (e.g. two views of the same kitchen → an orbit around the island). Pick a ready-made camera move or write your own prompt; choose the model, length and sound. Costs credits from the user's Pixly balance.

curl -X POST https://pixly.app/api/v1/tools/photo_to_video \
  -H "Authorization: Bearer $PIXLY_API_KEY" -H "Content-Type: application/json" \
  -d '{"imageUrl":"https://example.com/room.jpg","endImageUrl":"https://example.com/room.jpg"}'

Animate a before→after transformation (e.g. empty room → staged) into a social-ready reveal video from two frames. Costs credits from the user's Pixly balance.

curl -X POST https://pixly.app/api/v1/tools/before_after_reel \
  -H "Authorization: Bearer $PIXLY_API_KEY" -H "Content-Type: application/json" \
  -d '{"beforeImageUrl":"https://example.com/room.jpg","afterImageUrl":"https://example.com/room.jpg"}'

Turn an amateur listing photo into a finished, professional real-estate photo (exposure, color, clarity). Returns 3 variants to pick from. Costs credits from the user's Pixly balance.

curl -X POST https://pixly.app/api/v1/tools/enhance_photo \
  -H "Authorization: Bearer $PIXLY_API_KEY" -H "Content-Type: application/json" \
  -d '{"imageUrl":"https://example.com/room.jpg"}'

Remove clutter, mess, and personal items from a listing photo while keeping the room, furniture, and architecture intact. Costs credits from the user's Pixly balance.

curl -X POST https://pixly.app/api/v1/tools/declutter_photo \
  -H "Authorization: Bearer $PIXLY_API_KEY" -H "Content-Type: application/json" \
  -d '{"imageUrl":"https://example.com/room.jpg"}'

Empty a room and rebuild the surfaces behind what was taken out, keeping the architecture and camera angle identical — the blank canvas for restaging. By default it also removes the room's own joinery (fitted kitchen, built-in wardrobes, bathroom fixtures); mode 'movable' leaves those alone, and an optional extra takes the floor covering out too, for a full renovation strip-back. Doors always stay. (Declutter is the opposite: it keeps the furniture.) Costs credits from the user's Pixly balance.

curl -X POST https://pixly.app/api/v1/tools/remove_furniture \
  -H "Authorization: Bearer $PIXLY_API_KEY" -H "Content-Type: application/json" \
  -d '{"imageUrl":"https://example.com/room.jpg"}'

Turn a daytime listing photo into a magazine-style night scene — lights on, warm glow, dusk sky — with the building and camera angle unchanged. Costs credits from the user's Pixly balance.

curl -X POST https://pixly.app/api/v1/tools/day_to_night \
  -H "Authorization: Bearer $PIXLY_API_KEY" -H "Content-Type: application/json" \
  -d '{"imageUrl":"https://example.com/room.jpg"}'

Replace a grey, overcast or blown-out sky in an exterior listing photo with a natural clear blue sky, matching the light and keeping the building, trees and reflections unchanged. A run takes about 1–2 minutes; poll get_job until it completes. Costs credits from the user's Pixly balance.

curl -X POST https://pixly.app/api/v1/tools/replace_sky \
  -H "Authorization: Bearer $PIXLY_API_KEY" -H "Content-Type: application/json" \
  -d '{"imageUrl":"https://example.com/room.jpg"}'

Turn patchy, brown or bare grass in an exterior listing photo into a healthy green lawn, leaving driveways, paths, beds and the house untouched. Costs credits from the user's Pixly balance.

curl -X POST https://pixly.app/api/v1/tools/replace_lawn \
  -H "Authorization: Bearer $PIXLY_API_KEY" -H "Content-Type: application/json" \
  -d '{"imageUrl":"https://example.com/room.jpg"}'

Give one or more surfaces of a room a new finish — repaint the walls, change the floor, reface the kitchen cabinets and worktop, retile the bathroom or refinish the furniture — while the room's layout, fittings, windows and camera angle stay exactly as shot. Costs credits from the user's Pixly balance.

curl -X POST https://pixly.app/api/v1/tools/restyle_room \
  -H "Authorization: Bearer $PIXLY_API_KEY" -H "Content-Type: application/json" \
  -d '{"imageUrl":"https://example.com/room.jpg"}'

Photograph the same property in another season: take the snow off the ground, the roof and the branches and put the garden in leaf, or move a summer shot to autumn or winter. The house, the driveway, the paths and the camera angle stay exactly as shot. Costs credits from the user's Pixly balance.

curl -X POST https://pixly.app/api/v1/tools/reset_season \
  -H "Authorization: Bearer $PIXLY_API_KEY" -H "Content-Type: application/json" \
  -d '{"imageUrl":"https://example.com/room.jpg"}'

Design the garden of an exterior listing photo as one coherent scheme — planting, a terrace or deck, a pool, a pergola, a fire pit, a fence, lighting — in a chosen style, at the right scale and perspective, while the house, its roof, the driveway, the sun direction and the neighbours stay exactly as shot. One run builds the whole scheme. Costs credits from the user's Pixly balance.

curl -X POST https://pixly.app/api/v1/tools/makeover_exterior \
  -H "Authorization: Bearer $PIXLY_API_KEY" -H "Content-Type: application/json" \
  -d '{"imageUrl":"https://example.com/room.jpg"}'

One-click retouch of an exterior listing photo: a natural sky where it is dull, a healthy lawn where the grass is dead, a clean driveway, and bins, hoses and other clutter removed — each only where needed, with the house unchanged. Costs credits from the user's Pixly balance.

curl -X POST https://pixly.app/api/v1/tools/touch_up_exterior \
  -H "Authorization: Bearer $PIXLY_API_KEY" -H "Content-Type: application/json" \
  -d '{"imageUrl":"https://example.com/room.jpg"}'

Enlarge a photo by up to four times with real detail, to a maximum of 4096 px on the long edge — for print, MLS uploads and large screens. Nothing in the photo changes. Free on any result Pixly made (pass its r2Path from list_library); 1 credit on your own photo. Costs credits from the user's Pixly balance.

curl -X POST https://pixly.app/api/v1/tools/upscale_hd \
  -H "Authorization: Bearer $PIXLY_API_KEY" -H "Content-Type: application/json" \
  -d '{"imageUrl":"https://example.com/room.jpg"}'

Place a photorealistic 3D monument sign with your exact text (price, area, SOLD) onto a photo of an empty plot, matched to perspective and lighting. Costs credits from the user's Pixly balance.

curl -X POST https://pixly.app/api/v1/tools/plot_sign \
  -H "Authorization: Bearer $PIXLY_API_KEY" -H "Content-Type: application/json" \
  -d '{"imageUrl":"https://example.com/room.jpg","text":"..."}'

Rarely needed: generation tools take an imageUrl directly. Use this only to import a photo into Pixly ahead of time, e.g. to reuse one URL across several tools without refetching it each time.

Get a presigned upload URL for a LOCAL image file — the one case a URL can't cover. PUT the file to uploadUrl with the same Content-Type, then pass the returned r2Path to a generation tool instead of imageUrl. Ticket expires in 1 hour.

Check a generation job's status and fetch result URLs when it's done. Video jobs take 1-5 minutes — poll this with a few seconds between calls.

List the user's recent generations, or with type "uploads" their own uploaded source photos, newest first. Uploads are the way in when the photo is a local file: connectors cannot send bytes, so the user adds it at https://pixly.app/app and you pick up the r2Path here.

The user's current Pixly credit balance and plan.

pixly stage <photo> --style <id>

Virtually stage a room photo. Takes a URL or a local file (uploaded automatically).

• --style <id> (required) — style id, e.g. scandinavian, modern-luxury
• --room <type> — room-type hint; omitted = inferred from the photo
• --instructions <text> — extra instructions blended into the prompt
• --pro — Nano Banana Pro instead of Nano Banana 2 (2 credits instead of 1; same 2K output)
• --out <file.jpg> — output path (default: <name>-staged.jpg)

pixly enhance <photo>

Professional photo enhancement — returns 3 variants.

• --out <file.jpg>

pixly declutter <photo>

Remove clutter and personal items.

• --out <file.jpg>

pixly remove-furniture <photo>

Empty the room — all furniture, rugs, art and decor out, surfaces rebuilt. Walls, ceiling, windows and the camera never change.

• --movable — leave the fitted kitchen, built-ins and sanitaryware alone (default removes those too)
• --floor — take the floor covering down to bare screed as well (doors always stay)
• --out <file.jpg>

pixly day-to-night <photo>

Turn a daytime photo into a night scene.

• --out <file.jpg>

pixly sky <photo>

Replace a grey or overcast sky with a natural one; reflections updated, house unchanged. Auto by default.

• --sky clear|light-clouds|dramatic-clouds|sunset|pastel-sunrise|winter-clear (default auto)
• --sun auto|on|off · --sun-at <x,y> — place the sun, 0..1 from the top-left; implies --sun on
• --out <file.jpg>

pixly lawn <photo>

Turn patchy or brown grass into a healthy green lawn; only the grass changes. Auto by default.

• --lawn fresh-mown|lush|natural|golf|warm-season (default auto)
• --shade light|medium|deep · --stripes auto|on|off
• --out <file.jpg>

pixly season <photo> [--season winter]

Photograph the same property in another season — snow off the ground, roof and branches and the garden in leaf, or a summer shot moved to autumn or winter. The house, the driveway, the paths and the framing stay as shot. Auto by default.

• --season auto|spring|summer|autumn|winter (default auto — a snowy or bare photo comes back in high summer)
• --out <file.jpg> — output path

pixly restyle <photo> --walls sage --floor walnut

New finishes on the surfaces you name — walls, floor, kitchen cabinets, bathroom tiles, furniture — with the layout, fittings and camera unchanged. A surface with no flag is left alone; no flags at all repaints the walls on auto.

• --walls · --floor · --cabinets · --tiles · --furniture — a preset finish, `auto`, or the finish in your own words ("limewash in a warm clay", 120 chars max)
• --out <file.jpg> — output path

pixly upscale <photo>

HD Upscale — enlarge by up to four times with real detail, to a maximum of 4096 px on the long edge. Free on a Pixly result (pass its r2Path from `pixly jobs`), 1 credit on your own photo.

• --out <file.jpg>

pixly touch-up <photo>

Sky, lawn, driveway and clutter fixed in one pass, each only where the photo needs it; the house stays as shot.

• --only sky,lawn,driveway,clutter — allow only these fixes
• --skip clutter — everything except these (e.g. keep the car in the drive)
• --out <file.jpg>

pixly plot-sign <photo> --text "SOLD"

Photorealistic 3D monument sign on an empty-plot photo.

• --text <label> (required, max 24 chars)
• --look stone|metal|grass|sign
• --orientation standing|lying
• --out <file.jpg>

pixly motion <photo>

Cinematic camera-move clip from a single photo.

• --move zoom|fly-through|orbit|pan|aerial|pull-back|crane-up|tilt-up|boom-down|drone-orbit|flyover|pull-away|handheld
• --duration 5|10 (default 5)
• --format 9:16|16:9 (default 9:16)
• --out <file.mp4>

pixly reel --before <a.jpg> --after <b.jpg>

Before→after reveal video from two frames.

• --intent staging_reveal|staging_reveal_reverse|construction_timelapse
• --reveal smooth|slideIn|dropLand|glowBuild|movers (default smooth)
• --duration 5|10 · --format 9:16|16:9|1:1 · --out <file.mp4>

pixly job <jobId>

Job status + result URLs (JSON).

pixly jobs

Recent generations.

• --limit <n> (default 20)
• --type images|videos

pixly balance

Credits remaining and plan.

pixly tools

List every available tool.