Pixly

Official31 tools

by pixly

Every visual AI tool for property listings — staging, enhancement, decluttering, cinematic video.

Model Context Protocol (MCP) Server: app.pixly/pixly

The MCP server “app.pixly/pixly” provides access to an “every visual AI tool for property listings” workflow. The description specifies capabilities across staging, enhancement, decluttering, and cinematic video generation. The server includes 13 tools (toolCount: 13), exposed for developer use via MCP.

🛠️ Key Features

Visual AI tools for property listings
Staging
Enhancement
Decluttering
Cinematic video
13 tools

🚀 Use Cases

Create and refine visuals for property listing content
Produce staged and enhanced property imagery
Generate decluttered visuals for listing presentation
Generate cinematic video content for properties

⚡ Developer Benefits

Single MCP server interface for 13 related property-visual AI tools

⚠️ Limitations

Only the listed property-listing visual tasks are described (no additional capabilities provided)

Captured live from the server via tools/list.

virtual_staging

AI virtual staging: furnish and style an empty (or badly furnished) room photo in a chosen interior design style — also the tool for "redesign this room" or "show this room in another style". HD, watermark-free results. Costs credits from the user's Pixly balance.

Parameters7

imageUrl	string	optional	Public https URL of the source photo, or a data: URI. Either imageUrl or r2Path is required.
r2Path	string	optional	Storage path of a photo already in the user's Pixly library (from list_library, or returned by an upload ticket) — the alternative to imageUrl.
style	string	required	Interior style id. One of: modern-minimal, scandinavian, industrial, mid-century-modern, japandi, contemporary, transitional, urban-chic, bauhaus, organic-modern, brutalist, italian-modern, traditional, art-deco, colonial, victorian, french-country, english-cottage, neoclassical, art-nouveau, grandmillennial, hollywood-regency, parisian-chic, modern-classic, craftsman, mediterranean, mediterranean-modern, rustic-farmhouse, bohemian, tropical, family-staging, hygge, wabi-sabi, modern-farmhouse, cottagecore, shabby-chic, cabin-lodge, eclectic, retro-70s, warm-luxury, investor-premium, contemporary-dark, glam, penthouse-modern, hotel-suite, maximalist, quiet-luxury, coastal, desert-modern, hacienda, pacific-northwest, caribbean-resort, hamptons, moroccan, tuscan, southwestern, asian-zen, coastal-grandmother, cape-cod, california-casual, mountain-modern. When the user has no preference, "modern-minimal" or "scandinavian" suit most listings.
roomType	string	optional	Room type hint; omit to let vision infer it from the photo
customInstructions	string	optional	Optional: ONLY a wish the user stated beyond the style and room, in their words (e.g. "add a reading chair", "no rug"). Leave it out otherwise — Pixly writes the staging prompt itself (keeps walls, windows and camera angle, furnishes to scale); never restate the request or list furniture here.
numImages	integer	optional	Ignored — staging always returns one image. Call again for another take.
stagingQuality	string	optional	Ignored — the Pro tier is retired. Every staging costs 1 credit.

Raw schema

{
  "type": "object",
  "properties": {
    "imageUrl": {
      "type": "string",
      "minLength": 1,
      "description": "Public https URL of the source photo, or a data: URI. Either imageUrl or r2Path is required."
    },
    "r2Path": {
      "type": "string",
      "minLength": 1,
      "description": "Storage path of a photo already in the user's Pixly library (from list_library, or returned by an upload ticket) — the alternative to imageUrl."
    },
    "style": {
      "type": "string",
      "minLength": 1,
      "description": "Interior style id. One of: modern-minimal, scandinavian, industrial, mid-century-modern, japandi, contemporary, transitional, urban-chic, bauhaus, organic-modern, brutalist, italian-modern, traditional, art-deco, colonial, victorian, french-country, english-cottage, neoclassical, art-nouveau, grandmillennial, hollywood-regency, parisian-chic, modern-classic, craftsman, mediterranean, mediterranean-modern, rustic-farmhouse, bohemian, tropical, family-staging, hygge, wabi-sabi, modern-farmhouse, cottagecore, shabby-chic, cabin-lodge, eclectic, retro-70s, warm-luxury, investor-premium, contemporary-dark, glam, penthouse-modern, hotel-suite, maximalist, quiet-luxury, coastal, desert-modern, hacienda, pacific-northwest, caribbean-resort, hamptons, moroccan, tuscan, southwestern, asian-zen, coastal-grandmother, cape-cod, california-casual, mountain-modern. When the user has no preference, \"modern-minimal\" or \"scandinavian\" suit most listings.",
      "examples": [
        "modern-minimal",
        "scandinavian",
        "industrial",
        "mid-century-modern",
        "japandi"
      ]
    },
    "roomType": {
      "description": "Room type hint; omit to let vision infer it from the photo",
      "type": "string"
    },
    "customInstructions": {
      "description": "Optional: ONLY a wish the user stated beyond the style and room, in their words (e.g. \"add a reading chair\", \"no rug\"). Leave it out otherwise — Pixly writes the staging prompt itself (keeps walls, windows and camera angle, furnishes to scale); never restate the request or list furniture here.",
      "type": "string"
    },
    "numImages": {
      "default": 1,
      "description": "Ignored — staging always returns one image. Call again for another take.",
      "deprecated": true,
      "type": "integer",
      "minimum": 1,
      "maximum": 4
    },
    "stagingQuality": {
      "description": "Ignored — the Pro tier is retired. Every staging costs 1 credit.",
      "deprecated": true,
      "type": "string",
      "enum": [
        "standard",
        "pro"
      ]
    }
  },
  "required": [
    "style"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

edit_staged_photo

Change one thing in a photo and keep everything else exactly as it is — the parts the edit doesn't touch are copied from the photo, not redrawn. Works on any photo: a staged room, any Pixly result, or the user's own picture (swap the sofa, recolour a wall, remove a car, change the words on a sign). Optional `mask` limits the change to a marked area. Costs credits from the user's Pixly balance.

Parameters8

imageUrl	string	optional	The photo to edit: a Pixly result (a resultUrls entry), the user's own photo, or any public image URL / data:image URI. Either imageUrl or r2Path is required.
r2Path	string	optional	Storage path of the photo to edit (a resultPaths entry, or an upload) — the alternative to imageUrl.
style	string	optional	Optional. Style id of the staging being edited (the ids virtual_staging takes). Left out, it is read from the photo's history; a photo that was never staged needs none.
customInstructions	string	required	The change to make, in the user's words, e.g. "make the sofa dark green", "remove the car from the driveway", "change the sign to SOLD".
mask	string	optional	Optional area to change: a PNG as a data:image/png;base64 URI or an https URL, the photo's shape, WHITE where the photo may change and BLACK (or transparent) everywhere else. Leave it out to let the request alone decide — that already keeps the rest of the photo.
maskR2Path	string	optional	Storage path of a mask — the alternative to mask.
sourceJobId	string	optional	Job the photo came from, when it is a Pixly result (lineage)
sourceResultIndex	integer	optional	Which of that job's results was edited

Raw schema

{
  "type": "object",
  "properties": {
    "imageUrl": {
      "description": "The photo to edit: a Pixly result (a resultUrls entry), the user's own photo, or any public image URL / data:image URI. Either imageUrl or r2Path is required.",
      "type": "string",
      "minLength": 1
    },
    "r2Path": {
      "description": "Storage path of the photo to edit (a resultPaths entry, or an upload) — the alternative to imageUrl.",
      "type": "string",
      "minLength": 1
    },
    "style": {
      "description": "Optional. Style id of the staging being edited (the ids virtual_staging takes). Left out, it is read from the photo's history; a photo that was never staged needs none.",
      "type": "string"
    },
    "customInstructions": {
      "type": "string",
      "minLength": 1,
      "description": "The change to make, in the user's words, e.g. \"make the sofa dark green\", \"remove the car from the driveway\", \"change the sign to SOLD\"."
    },
    "mask": {
      "description": "Optional area to change: a PNG as a data:image/png;base64 URI or an https URL, the photo's shape, WHITE where the photo may change and BLACK (or transparent) everywhere else. Leave it out to let the request alone decide — that already keeps the rest of the photo.",
      "type": "string",
      "minLength": 1
    },
    "maskR2Path": {
      "description": "Storage path of a mask — the alternative to mask.",
      "type": "string",
      "minLength": 1
    },
    "sourceJobId": {
      "description": "Job the photo came from, when it is a Pixly result (lineage)",
      "type": "string"
    },
    "sourceResultIndex": {
      "description": "Which of that job's results was edited",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "customInstructions"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

cinematic_motion

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

Parameters6

imageUrl	string	optional	Public https URL of the source photo, or a data: URI. Either imageUrl or r2Path is required.
r2Path	string	optional	Storage path of a photo already in the user's Pixly library (from list_library, or returned by an upload ticket) — the alternative to imageUrl.
cameraMove	string	optional	Camera-move preset
direction	string	optional	The direction the camera travels, for the moves that have one (orbit, pan, drone-orbit). 'left-to-right' sends the camera rightward, 'right-to-left' leftward. Ignored by every other move; omit to use the move's own default.
durationSeconds	any	optional	Clip length in seconds. Leave out for the default 5 s; 10 s costs about twice as much — use it only when the user asks for a longer video.
format	string	optional	Video shape. original (default) keeps the photo's own shape; 9:16 or 16:9 crop the photo, centred, to that shape before it is animated.

Raw schema

{
  "type": "object",
  "properties": {
    "imageUrl": {
      "type": "string",
      "minLength": 1,
      "description": "Public https URL of the source photo, or a data: URI. Either imageUrl or r2Path is required."
    },
    "r2Path": {
      "type": "string",
      "minLength": 1,
      "description": "Storage path of a photo already in the user's Pixly library (from list_library, or returned by an upload ticket) — the alternative to imageUrl."
    },
    "cameraMove": {
      "default": "zoom",
      "description": "Camera-move preset",
      "type": "string",
      "enum": [
        "zoom",
        "fly-through",
        "orbit",
        "pan",
        "aerial",
        "pull-back",
        "crane-up",
        "tilt-up",
        "boom-down",
        "drone-orbit",
        "flyover",
        "pull-away",
        "handheld"
      ]
    },
    "direction": {
      "description": "The direction the camera travels, for the moves that have one (orbit, pan, drone-orbit). 'left-to-right' sends the camera rightward, 'right-to-left' leftward. Ignored by every other move; omit to use the move's own default.",
      "type": "string",
      "enum": [
        "left-to-right",
        "right-to-left"
      ]
    },
    "durationSeconds": {
      "default": 5,
      "description": "Clip length in seconds. Leave out for the default 5 s; 10 s costs about twice as much — use it only when the user asks for a longer video.",
      "anyOf": [
        {
          "type": "number",
          "const": 5
        },
        {
          "type": "number",
          "const": 10
        }
      ]
    },
    "format": {
      "default": "original",
      "description": "Video shape. original (default) keeps the photo's own shape; 9:16 or 16:9 crop the photo, centred, to that shape before it is animated.",
      "type": "string",
      "enum": [
        "original",
        "9:16",
        "16:9"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

photo_to_video

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.

Parameters10

imageUrl	string	optional	Start frame — where the video begins. Public https URL or data: URI; either imageUrl or r2Path is required.
r2Path	string	optional	Storage path of a photo already in the user's Pixly library (from list_library, or returned by an upload ticket) — the alternative to imageUrl.
endImageUrl	string	optional	Optional end frame — the camera travels from the start photo and lands exactly on this one. Best when both photos show the same space from different spots.
endR2Path	string	optional	R2 path of the end frame — the alternative to endImageUrl.
cameraMove	string	optional	Ready-made camera move used when no prompt is given.
prompt	string	optional	Your own description of the video, in any language. Replaces cameraMove when set.
model	string	optional	kling-v3: 3/5/8/10/15 s, optional sound, lands most precisely on the end frame. kling-2.6: 5/10 s, silent, cheaper.
durationSeconds	integer	optional	Clip length. kling-v3 takes 3, 5, 8, 10 or 15; kling-2.6 takes 5 or 10.
sound	boolean	optional	Add ambient sound (kling-v3 only; kling-2.6 is always silent).
format	string	optional	Video shape. original (default) keeps the start photo's own shape; 16:9, 9:16 or 1:1 crop the photos, centred, to that shape before they are animated.

Raw schema

{
  "type": "object",
  "properties": {
    "imageUrl": {
      "description": "Start frame — where the video begins. Public https URL or data: URI; either imageUrl or r2Path is required.",
      "type": "string",
      "minLength": 1
    },
    "r2Path": {
      "type": "string",
      "minLength": 1,
      "description": "Storage path of a photo already in the user's Pixly library (from list_library, or returned by an upload ticket) — the alternative to imageUrl."
    },
    "endImageUrl": {
      "description": "Optional end frame — the camera travels from the start photo and lands exactly on this one. Best when both photos show the same space from different spots.",
      "type": "string",
      "minLength": 1
    },
    "endR2Path": {
      "description": "R2 path of the end frame — the alternative to endImageUrl.",
      "type": "string",
      "minLength": 1
    },
    "cameraMove": {
      "default": "smooth",
      "description": "Ready-made camera move used when no prompt is given.",
      "type": "string",
      "enum": [
        "smooth",
        "walk",
        "orbitLeft",
        "orbitRight",
        "pushIn",
        "pullBack",
        "riseUp"
      ]
    },
    "prompt": {
      "description": "Your own description of the video, in any language. Replaces cameraMove when set.",
      "type": "string",
      "maxLength": 1000
    },
    "model": {
      "default": "kling-v3",
      "description": "kling-v3: 3/5/8/10/15 s, optional sound, lands most precisely on the end frame. kling-2.6: 5/10 s, silent, cheaper.",
      "type": "string",
      "enum": [
        "kling-v3",
        "kling-2.6"
      ]
    },
    "durationSeconds": {
      "default": 5,
      "description": "Clip length. kling-v3 takes 3, 5, 8, 10 or 15; kling-2.6 takes 5 or 10.",
      "type": "integer",
      "minimum": 3,
      "maximum": 15
    },
    "sound": {
      "default": false,
      "description": "Add ambient sound (kling-v3 only; kling-2.6 is always silent).",
      "type": "boolean"
    },
    "format": {
      "default": "original",
      "description": "Video shape. original (default) keeps the start photo's own shape; 16:9, 9:16 or 1:1 crop the photos, centred, to that shape before they are animated.",
      "type": "string",
      "enum": [
        "original",
        "16:9",
        "9:16",
        "1:1"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

before_after_reel

Before and after video: animate a before→after transformation (e.g. empty room → staged, or a renovation, or a daylight photo → its Day to Night version with videoIntent day_to_night) into a social-ready reveal reel from two photos. Both photos are required. Only have one? Make the other first with a photo tool — virtual_staging (empty room → furnished), remove_furniture (furnished → empty), day_to_night, restyle_room, makeover_exterior and the other edit tools — and pass its result as afterImageUrl (or beforeImageUrl). Costs credits from the user's Pixly balance.

Parameters8

beforeImageUrl	string	optional	Start frame (e.g. the empty room photo) — https URL or data: URI
afterImageUrl	string	optional	End frame (e.g. the staged result) — https URL or data: URI
beforeR2Path	string	optional	R2 path of the start frame — the alternative to beforeImageUrl.
afterR2Path	string	optional	R2 path of the end frame — the alternative to afterImageUrl.
videoIntent	string	optional	staging_reveal: an empty room becoming a furnished one (or a renovation). day_to_night: Before is a daylight photo and After its dusk version (a Pixly Day to Night result and its original) — the video turns day into the lit evening; revealStyle does not apply.
revealStyle	string	optional	How the transformation is revealed
durationSeconds	any	optional
format	string	optional	Video shape. original (default) keeps the photos' own shape; 9:16, 16:9 or 1:1 crop both photos, centred, to that shape first.

Raw schema

{
  "type": "object",
  "properties": {
    "beforeImageUrl": {
      "description": "Start frame (e.g. the empty room photo) — https URL or data: URI",
      "type": "string",
      "minLength": 1
    },
    "afterImageUrl": {
      "description": "End frame (e.g. the staged result) — https URL or data: URI",
      "type": "string",
      "minLength": 1
    },
    "beforeR2Path": {
      "description": "R2 path of the start frame — the alternative to beforeImageUrl.",
      "type": "string",
      "minLength": 1
    },
    "afterR2Path": {
      "description": "R2 path of the end frame — the alternative to afterImageUrl.",
      "type": "string",
      "minLength": 1
    },
    "videoIntent": {
      "default": "staging_reveal",
      "description": "staging_reveal: an empty room becoming a furnished one (or a renovation). day_to_night: Before is a daylight photo and After its dusk version (a Pixly Day to Night result and its original) — the video turns day into the lit evening; revealStyle does not apply.",
      "type": "string",
      "enum": [
        "staging_reveal",
        "staging_reveal_reverse",
        "construction_timelapse",
        "day_to_night"
      ]
    },
    "revealStyle": {
      "default": "smooth",
      "description": "How the transformation is revealed",
      "type": "string",
      "enum": [
        "smooth",
        "slideIn",
        "dropLand",
        "glowBuild",
        "movers"
      ]
    },
    "durationSeconds": {
      "default": 5,
      "anyOf": [
        {
          "type": "number",
          "const": 5
        },
        {
          "type": "number",
          "const": 10
        }
      ]
    },
    "format": {
      "default": "original",
      "description": "Video shape. original (default) keeps the photos' own shape; 9:16, 16:9 or 1:1 crop both photos, centred, to that shape first.",
      "type": "string",
      "enum": [
        "original",
        "9:16",
        "16:9",
        "1:1"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

flythrough_video

Flythrough video: one continuous camera move through a home from 2-4 room photos in walking order. Each pair of neighbouring photos becomes a 3-second move that flies from one room into the next, and the moves are stitched into one film with a cinematic speed ramp. Returns one job: poll get_job until the film is ready (a few minutes). Costs credits from the user's Pixly balance.

Parameters3

photos	array	required	The rooms in walking order, 2 to 4 photos (e.g. hallway → living room → kitchen). Each photo should show the doorway or opening into the next room — the camera flies through it. Each item takes imageUrl or r2Path.
format	string	optional	Film shape. Omit to follow the photos (landscape photos → 16:9).
title	string	optional	Optional name for the tour, e.g. the street address.

Raw schema

{
  "type": "object",
  "properties": {
    "photos": {
      "minItems": 2,
      "maxItems": 4,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "imageUrl": {
            "type": "string",
            "minLength": 1,
            "description": "Public https URL of the source photo, or a data: URI. Either imageUrl or r2Path is required."
          },
          "r2Path": {
            "type": "string",
            "minLength": 1,
            "description": "Storage path of a photo already in the user's Pixly library (from list_library, or returned by an upload ticket) — the alternative to imageUrl."
          }
        }
      },
      "description": "The rooms in walking order, 2 to 4 photos (e.g. hallway → living room → kitchen). Each photo should show the doorway or opening into the next room — the camera flies through it. Each item takes imageUrl or r2Path."
    },
    "format": {
      "description": "Film shape. Omit to follow the photos (landscape photos → 16:9).",
      "type": "string",
      "enum": [
        "16:9",
        "9:16",
        "1:1"
      ]
    },
    "title": {
      "description": "Optional name for the tour, e.g. the street address.",
      "type": "string",
      "maxLength": 80
    }
  },
  "required": [
    "photos"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

before_after_image

Free (no credits): one comparison image from a before and an after photo of the same place — e.g. an empty room and its virtual staging, a daylight shot and its dusk version, a room before and after a restyle. Side by side, stacked, or split by a line; original shape, square, 4:5 or 9:16. Write the labels in the user's language. Returns a finished image at once.

Parameters9

beforeImageUrl	string	optional	The BEFORE photo (e.g. the empty room, the daylight shot). Public https URL or data: URI; or beforeR2Path.
beforeR2Path	string	optional	Storage path of the before photo — the alternative to beforeImageUrl. For a Pixly result, its original photo is the job's source.
afterImageUrl	string	optional	The AFTER photo (e.g. the staged room, the dusk version). Public https URL or data: URI; or afterR2Path.
afterR2Path	string	optional	Storage path of the after photo — the alternative to afterImageUrl.
layout	string	optional	side = next to each other, stack = one above the other, vsplit = one frame split by a vertical line, diagonal = split by a slanted line.
aspect	string	optional	Shape of the image: original (follows the photos), 1:1 square, 4:5 Instagram post, 9:16 Stories/Reels.
labels	boolean	optional	Show the Before / After labels.
beforeLabel	string	optional	Label text for the before photo, in the user's language (default "Before").
afterLabel	string	optional	Label text for the after photo, in the user's language (default "After").

Raw schema

{
  "type": "object",
  "properties": {
    "beforeImageUrl": {
      "description": "The BEFORE photo (e.g. the empty room, the daylight shot). Public https URL or data: URI; or beforeR2Path.",
      "type": "string",
      "minLength": 1
    },
    "beforeR2Path": {
      "description": "Storage path of the before photo — the alternative to beforeImageUrl. For a Pixly result, its original photo is the job's source.",
      "type": "string",
      "minLength": 1
    },
    "afterImageUrl": {
      "description": "The AFTER photo (e.g. the staged room, the dusk version). Public https URL or data: URI; or afterR2Path.",
      "type": "string",
      "minLength": 1
    },
    "afterR2Path": {
      "description": "Storage path of the after photo — the alternative to afterImageUrl.",
      "type": "string",
      "minLength": 1
    },
    "layout": {
      "default": "side",
      "description": "side = next to each other, stack = one above the other, vsplit = one frame split by a vertical line, diagonal = split by a slanted line.",
      "type": "string",
      "enum": [
        "side",
        "stack",
        "vsplit",
        "diagonal"
      ]
    },
    "aspect": {
      "default": "original",
      "description": "Shape of the image: original (follows the photos), 1:1 square, 4:5 Instagram post, 9:16 Stories/Reels.",
      "type": "string",
      "enum": [
        "original",
        "1:1",
        "4:5",
        "9:16"
      ]
    },
    "labels": {
      "default": true,
      "description": "Show the Before / After labels.",
      "type": "boolean"
    },
    "beforeLabel": {
      "description": "Label text for the before photo, in the user's language (default \"Before\").",
      "type": "string",
      "maxLength": 24
    },
    "afterLabel": {
      "description": "Label text for the after photo, in the user's language (default \"After\").",
      "type": "string",
      "maxLength": 24
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

watermark_photos

Free (no credits): put the agent's or agency's mark on listing photos — text (name, phone) and/or the logo saved on their Pixly account — in a corner or the middle, up to 10 photos per call. Returns every marked photo at once.

Parameters5

photos	array	required	The photos to mark, 1–10. Each item takes imageUrl or r2Path.
text	string	optional	The text, e.g. "Smith Realty · 555-0100". Optional when the account has a saved logo.
position	string	optional
size	string	optional
useLogo	boolean	optional	Add the logo saved on the account (Pixly floor plan settings), when there is one.

Raw schema

{
  "type": "object",
  "properties": {
    "photos": {
      "minItems": 1,
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "imageUrl": {
            "type": "string",
            "minLength": 1,
            "description": "Public https URL of the source photo, or a data: URI. Either imageUrl or r2Path is required."
          },
          "r2Path": {
            "type": "string",
            "minLength": 1,
            "description": "Storage path of a photo already in the user's Pixly library (from list_library, or returned by an upload ticket) — the alternative to imageUrl."
          }
        }
      },
      "description": "The photos to mark, 1–10. Each item takes imageUrl or r2Path."
    },
    "text": {
      "description": "The text, e.g. \"Smith Realty · 555-0100\". Optional when the account has a saved logo.",
      "type": "string",
      "maxLength": 60
    },
    "position": {
      "default": "bottom-right",
      "type": "string",
      "enum": [
        "bottom-right",
        "bottom-left",
        "top-right",
        "top-left",
        "center"
      ]
    },
    "size": {
      "default": "medium",
      "type": "string",
      "enum": [
        "small",
        "medium",
        "large"
      ]
    },
    "useLogo": {
      "default": true,
      "description": "Add the logo saved on the account (Pixly floor plan settings), when there is one.",
      "type": "boolean"
    }
  },
  "required": [
    "photos"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

blur_faces_plates

Free (no credits): find and blur people's faces and car licence plates in property photos before they're posted — street and exterior shots, open houses. Automatic detection, 1–5 photos per call. Says so when nothing is found.

Parameters4

photos	array	required	The photos, 1–5. Each item takes imageUrl or r2Path.
faces	boolean	optional
plates	boolean	optional
style	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "photos": {
      "minItems": 1,
      "maxItems": 5,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "imageUrl": {
            "type": "string",
            "minLength": 1,
            "description": "Public https URL of the source photo, or a data: URI. Either imageUrl or r2Path is required."
          },
          "r2Path": {
            "type": "string",
            "minLength": 1,
            "description": "Storage path of a photo already in the user's Pixly library (from list_library, or returned by an upload ticket) — the alternative to imageUrl."
          }
        }
      },
      "description": "The photos, 1–5. Each item takes imageUrl or r2Path."
    },
    "faces": {
      "default": true,
      "type": "boolean"
    },
    "plates": {
      "default": true,
      "type": "boolean"
    },
    "style": {
      "default": "blur",
      "type": "string",
      "enum": [
        "blur",
        "pixelate"
      ]
    }
  },
  "required": [
    "photos"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

straighten_photo

Free (no credits): automatically straighten a property photo — leaning walls made vertical (converging verticals from a tilted camera) and a tilted horizon levelled, like a pro photographer's lens correction. Crops the edges slightly. Best before staging or any other edit. Says so when the photo is already straight or has no straight lines to go by.

Parameters2

imageUrl	string	optional	Public https URL of the source photo, or a data: URI. Either imageUrl or r2Path is required.
r2Path	string	optional	Storage path of a photo already in the user's Pixly library (from list_library, or returned by an upload ticket) — the alternative to imageUrl.

Raw schema

{
  "type": "object",
  "properties": {
    "imageUrl": {
      "type": "string",
      "minLength": 1,
      "description": "Public https URL of the source photo, or a data: URI. Either imageUrl or r2Path is required."
    },
    "r2Path": {
      "type": "string",
      "minLength": 1,
      "description": "Storage path of a photo already in the user's Pixly library (from list_library, or returned by an upload ticket) — the alternative to imageUrl."
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

draw_floor_plan

Free (no credits): draw a clean 2D floor plan from a layout YOU write — read the user's description, or look at their hand sketch or brochure plan, and send every room as a rectangle in metres (or feet) plus doors and windows. Returns the drawn plan (areas and dimensions on it) at once, saved so the user can fine-tune it in Pixly's floor plan editor. If the layout has problems (overlapping rooms, a door between rooms that don't touch) you get exactly what to fix — fix it and call again. To change a plan, call again with its planId and the whole updated layout; the new version is saved as its own plan and the earlier one is kept.

Parameters6

title	string	optional	Address or listing name for the plan's title block.
units	string	optional	Units of every number below, and of the labels on the plan.
rooms	array	required	Every room as an axis-aligned rectangle. Neighbouring rooms must share the wall exactly (one's right edge = the other's left edge) and must not overlap. An L-shaped space = two rectangles joined by a doorway. Lay out a typical sensible plan when the user gives only rough sizes.
doors	array	optional
windows	array	optional
planId	string	optional	To CHANGE a plan you drew before: its planId from that result, with the whole updated layout — saved as a new plan beside it (nothing is overwritten). Omit for a new plan.

Raw schema

{
  "type": "object",
  "properties": {
    "title": {
      "description": "Address or listing name for the plan's title block.",
      "type": "string",
      "maxLength": 80
    },
    "units": {
      "default": "m",
      "description": "Units of every number below, and of the labels on the plan.",
      "type": "string",
      "enum": [
        "m",
        "ft"
      ]
    },
    "rooms": {
      "minItems": 1,
      "maxItems": 40,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 30,
            "description": "Your own short handle for the room (\"kitchen\", \"bed1\"); doors and windows refer to it."
          },
          "type": {
            "type": "string",
            "enum": [
              "living",
              "kitchen",
              "dining",
              "bedroom",
              "bathroom",
              "wc",
              "hall",
              "office",
              "laundry",
              "storage",
              "garage",
              "balcony",
              "terrace",
              "utility",
              "other"
            ],
            "description": "What the room is; sets its colour and default label."
          },
          "name": {
            "description": "Label on the plan when the type isn't enough (\"Bedroom 2\", \"Master bedroom\").",
            "type": "string",
            "maxLength": 40
          },
          "x": {
            "type": "number",
            "description": "Left edge. The plan's x runs to the right."
          },
          "y": {
            "type": "number",
            "description": "Top edge. The plan's y runs DOWN (the top of the drawing is 0)."
          },
          "width": {
            "type": "number",
            "minimum": 0.1,
            "description": "Size along x."
          },
          "depth": {
            "type": "number",
            "minimum": 0.1,
            "description": "Size along y."
          }
        },
        "required": [
          "id",
          "type",
          "x",
          "y",
          "width",
          "depth"
        ]
      },
      "description": "Every room as an axis-aligned rectangle. Neighbouring rooms must share the wall exactly (one's right edge = the other's left edge) and must not overlap. An L-shaped space = two rectangles joined by a doorway. Lay out a typical sensible plan when the user gives only rough sizes."
    },
    "doors": {
      "default": [],
      "maxItems": 60,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "from": {
            "type": "string",
            "description": "A room id."
          },
          "to": {
            "type": "string",
            "description": "Another room id that shares a wall with it, or \"outside\"."
          },
          "side": {
            "description": "Only for to = \"outside\": which wall of the room the entrance is on.",
            "type": "string",
            "enum": [
              "top",
              "right",
              "bottom",
              "left"
            ]
          },
          "kind": {
            "default": "door",
            "description": "door = hinged door, doorway = open gap with no door, sliding = sliding/patio door.",
            "type": "string",
            "enum": [
              "door",
              "doorway",
              "sliding"
            ]
          },
          "width": {
            "type": "number",
            "minimum": 0.1
          }
        },
        "required": [
          "from",
          "to"
        ]
      }
    },
    "windows": {
      "default": [],
      "maxItems": 80,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "room": {
            "type": "string",
            "description": "A room id."
          },
          "side": {
            "type": "string",
            "enum": [
              "top",
              "right",
              "bottom",
              "left"
            ],
            "description": "Which wall; it must be an outside wall (not shared with another room)."
          },
          "count": {
            "default": 1,
            "type": "integer",
            "minimum": 1,
            "maximum": 4
          },
          "width": {
            "type": "number",
            "minimum": 0.1
          },
          "full": {
            "default": false,
            "description": "Floor-to-ceiling glass (French window, balcony door).",
            "type": "boolean"
          }
        },
        "required": [
          "room",
          "side"
        ]
      }
    },
    "planId": {
      "description": "To CHANGE a plan you drew before: its planId from that result, with the whole updated layout — saved as a new plan beside it (nothing is overwritten). Omit for a new plan.",
      "type": "string",
      "maxLength": 40
    }
  },
  "required": [
    "rooms"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

enhance_photo

Real estate photo editing in one step: turn an amateur listing photo into a finished, professional photo (exposure, color, clarity). Returns 3 variants to pick from. Costs credits from the user's Pixly balance.

Parameters2

imageUrl	string	optional	Public https URL of the source photo, or a data: URI. Either imageUrl or r2Path is required.
r2Path	string	optional	Storage path of a photo already in the user's Pixly library (from list_library, or returned by an upload ticket) — the alternative to imageUrl.

Raw schema

{
  "type": "object",
  "properties": {
    "imageUrl": {
      "type": "string",
      "minLength": 1,
      "description": "Public https URL of the source photo, or a data: URI. Either imageUrl or r2Path is required."
    },
    "r2Path": {
      "type": "string",
      "minLength": 1,
      "description": "Storage path of a photo already in the user's Pixly library (from list_library, or returned by an upload ticket) — the alternative to imageUrl."
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

declutter_photo

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.

Parameters2

imageUrl	string	optional	Public https URL of the source photo, or a data: URI. Either imageUrl or r2Path is required.
r2Path	string	optional	Storage path of a photo already in the user's Pixly library (from list_library, or returned by an upload ticket) — the alternative to imageUrl.

Raw schema

{
  "type": "object",
  "properties": {
    "imageUrl": {
      "type": "string",
      "minLength": 1,
      "description": "Public https URL of the source photo, or a data: URI. Either imageUrl or r2Path is required."
    },
    "r2Path": {
      "type": "string",
      "minLength": 1,
      "description": "Storage path of a photo already in the user's Pixly library (from list_library, or returned by an upload ticket) — the alternative to imageUrl."
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

remove_furniture

Remove furniture from a photo: 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.

Parameters4

imageUrl	string	optional	Public https URL of the source photo, or a data: URI. Either imageUrl or r2Path is required.
r2Path	string	optional	Storage path of a photo already in the user's Pixly library (from list_library, or returned by an upload ticket) — the alternative to imageUrl.
mode	string	optional	How far to strip the room. 'fitted' (the default) removes the movable contents AND the room's own joinery — the fitted kitchen and its appliances, built-in wardrobes and shelving, and bathroom sanitaryware. 'movable' removes only furniture, rugs, curtains, art, plants and lamps, leaving the kitchen, built-ins, sanitaryware, floor and doors exactly as they are.
extras	array	optional	Extra things to take out, for a full strip-back. Only applies with mode 'fitted' and is ignored otherwise: 'floor' takes the floor covering down to bare concrete screed. Omit to keep the floor. Doors always stay, as do walls, ceiling, windows, structural openings and the camera.

Raw schema

{
  "type": "object",
  "properties": {
    "imageUrl": {
      "type": "string",
      "minLength": 1,
      "description": "Public https URL of the source photo, or a data: URI. Either imageUrl or r2Path is required."
    },
    "r2Path": {
      "type": "string",
      "minLength": 1,
      "description": "Storage path of a photo already in the user's Pixly library (from list_library, or returned by an upload ticket) — the alternative to imageUrl."
    },
    "mode": {
      "description": "How far to strip the room. 'fitted' (the default) removes the movable contents AND the room's own joinery — the fitted kitchen and its appliances, built-in wardrobes and shelving, and bathroom sanitaryware. 'movable' removes only furniture, rugs, curtains, art, plants and lamps, leaving the kitchen, built-ins, sanitaryware, floor and doors exactly as they are.",
      "type": "string",
      "enum": [
        "movable",
        "fitted"
      ]
    },
    "extras": {
      "description": "Extra things to take out, for a full strip-back. Only applies with mode 'fitted' and is ignored otherwise: 'floor' takes the floor covering down to bare concrete screed. Omit to keep the floor. Doors always stay, as do walls, ceiling, windows, structural openings and the camera.",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "floor"
        ]
      }
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

day_to_night

Day to dusk (virtual twilight): turn a daytime listing photo into a magazine-style evening scene — lights on, warm glow, dusk sky — with the building and camera angle unchanged. Costs credits from the user's Pixly balance.

Parameters2

imageUrl	string	optional	Public https URL of the source photo, or a data: URI. Either imageUrl or r2Path is required.
r2Path	string	optional	Storage path of a photo already in the user's Pixly library (from list_library, or returned by an upload ticket) — the alternative to imageUrl.

Raw schema

{
  "type": "object",
  "properties": {
    "imageUrl": {
      "type": "string",
      "minLength": 1,
      "description": "Public https URL of the source photo, or a data: URI. Either imageUrl or r2Path is required."
    },
    "r2Path": {
      "type": "string",
      "minLength": 1,
      "description": "Storage path of a photo already in the user's Pixly library (from list_library, or returned by an upload ticket) — the alternative to imageUrl."
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

replace_sky

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.

Parameters6

imageUrl	string	optional	Public https URL of the source photo, or a data: URI. Either imageUrl or r2Path is required.
r2Path	string	optional	Storage path of a photo already in the user's Pixly library (from list_library, or returned by an upload ticket) — the alternative to imageUrl.
sky	string	optional	Sky style. 'auto' lets the tool pick what suits the photo's light.
sun	string	optional	Sun glow: auto (a glow for sunset/sunrise styles, none otherwise), on (place it with sunX/sunY), off.
sunX	number	optional	With sun=on: glow position from the left edge, 0..1.
sunY	number	optional	With sun=on: glow position from the top edge, 0..1 (kept in the top 60%).

Raw schema

{
  "type": "object",
  "properties": {
    "imageUrl": {
      "type": "string",
      "minLength": 1,
      "description": "Public https URL of the source photo, or a data: URI. Either imageUrl or r2Path is required."
    },
    "r2Path": {
      "type": "string",
      "minLength": 1,
      "description": "Storage path of a photo already in the user's Pixly library (from list_library, or returned by an upload ticket) — the alternative to imageUrl."
    },
    "sky": {
      "default": "auto",
      "description": "Sky style. 'auto' lets the tool pick what suits the photo's light.",
      "type": "string",
      "enum": [
        "auto",
        "clear",
        "light_clouds",
        "dramatic_clouds",
        "sunset",
        "pastel_sunrise",
        "winter_clear"
      ]
    },
    "sun": {
      "default": "auto",
      "description": "Sun glow: auto (a glow for sunset/sunrise styles, none otherwise), on (place it with sunX/sunY), off.",
      "type": "string",
      "enum": [
        "auto",
        "on",
        "off"
      ]
    },
    "sunX": {
      "description": "With sun=on: glow position from the left edge, 0..1.",
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "sunY": {
      "description": "With sun=on: glow position from the top edge, 0..1 (kept in the top 60%).",
      "type": "number",
      "minimum": 0,
      "maximum": 1
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

replace_lawn

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.

Parameters5

imageUrl	string	optional	Public https URL of the source photo, or a data: URI. Either imageUrl or r2Path is required.
r2Path	string	optional	Storage path of a photo already in the user's Pixly library (from list_library, or returned by an upload ticket) — the alternative to imageUrl.
lawn	string	optional	Lawn style. 'auto' lets the tool pick a healthy lawn that suits the photo.
shade	string	optional	How green; only used with a chosen lawn style.
stripes	string	optional	Mowing stripes: auto (stripes for fresh_mown and golf, none otherwise), on, off.

Raw schema

{
  "type": "object",
  "properties": {
    "imageUrl": {
      "type": "string",
      "minLength": 1,
      "description": "Public https URL of the source photo, or a data: URI. Either imageUrl or r2Path is required."
    },
    "r2Path": {
      "type": "string",
      "minLength": 1,
      "description": "Storage path of a photo already in the user's Pixly library (from list_library, or returned by an upload ticket) — the alternative to imageUrl."
    },
    "lawn": {
      "default": "auto",
      "description": "Lawn style. 'auto' lets the tool pick a healthy lawn that suits the photo.",
      "type": "string",
      "enum": [
        "auto",
        "fresh_mown",
        "lush",
        "natural",
        "golf",
        "warm_season"
      ]
    },
    "shade": {
      "default": "medium",
      "description": "How green; only used with a chosen lawn style.",
      "type": "string",
      "enum": [
        "light",
        "medium",
        "deep"
      ]
    },
    "stripes": {
      "default": "auto",
      "description": "Mowing stripes: auto (stripes for fresh_mown and golf, none otherwise), on, off.",
      "type": "string",
      "enum": [
        "auto",
        "on",
        "off"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

restyle_room

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.

Parameters7

imageUrl	string	optional	Public https URL of the source photo, or a data: URI. Either imageUrl or r2Path is required.
r2Path	string	optional	Storage path of a photo already in the user's Pixly library (from list_library, or returned by an upload ticket) — the alternative to imageUrl.
surfaces	array	optional	Which surfaces get a new finish: 'walls', 'floor', 'cabinets' (fitted joinery plus its worktop and splashback), 'bathroom_tiles' (the tiled walls; a bathroom floor is 'floor') or 'furniture' (upholstery and wood finishes). Omit for walls. The room's layout, fittings and camera never change.
looks	object	optional	The finish per surface: 'auto', one of the presets below, 'custom' with your own words in `notes`, 'own_colour' (walls, cabinets, furniture) with a hex colour in `colours`, or 'material_photo' with a photo of the material in `references`. A finish that does not belong to its surface falls back to 'auto' (the tool picks one that suits the room; several on auto are made to agree). walls: warm_white, soft_grey, greige, sage, deep_navy. floor: light_oak, walnut, grey_plank, polished_concrete, stone_tile. cabinets: white_shaker, charcoal, natural_oak, forest_green, navy_cabinets. bathroom_tiles (wall tiles only; a bathroom floor is 'floor'): white_metro, zellige_white, marble_large, travertine, green_gloss. floor also takes terrazzo, encaustic_pattern, matt_black_hex. furniture: light_neutral, warm_wood, dark_wood, black_leather.
notes	object	optional	Your own description of the finish for a surface, used when that surface's look is "custom" (e.g. "terracotta hex tiles with dark grout"). Set look "custom" and the note together; "custom" with no note falls back to "auto". 120 characters max, and anything in it that is not a description of a finish is ignored.
colours	object	optional	Any colour as a hex code for walls, cabinets or furniture (e.g. {"walls": "#7A8B6F"}), used when that surface's look is "own_colour". The result matches it closely as it would look in the room's light.
references	object	optional	A photo of the material itself — a floor plank, a tile, a fabric swatch, a wallpaper sample — for ONE surface, as the r2Path from create_upload_ticket or list_library (e.g. {"floor": "users/…/oak.jpg"}). Set that surface's look to "material_photo". One photo per run; a close, straight-on photo of the sample works best.

Raw schema

{
  "type": "object",
  "properties": {
    "imageUrl": {
      "type": "string",
      "minLength": 1,
      "description": "Public https URL of the source photo, or a data: URI. Either imageUrl or r2Path is required."
    },
    "r2Path": {
      "type": "string",
      "minLength": 1,
      "description": "Storage path of a photo already in the user's Pixly library (from list_library, or returned by an upload ticket) — the alternative to imageUrl."
    },
    "surfaces": {
      "description": "Which surfaces get a new finish: 'walls', 'floor', 'cabinets' (fitted joinery plus its worktop and splashback), 'bathroom_tiles' (the tiled walls; a bathroom floor is 'floor') or 'furniture' (upholstery and wood finishes). Omit for walls. The room's layout, fittings and camera never change.",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "walls",
          "floor",
          "cabinets",
          "bathroom_tiles",
          "furniture"
        ]
      }
    },
    "looks": {
      "description": "The finish per surface: 'auto', one of the presets below, 'custom' with your own words in `notes`, 'own_colour' (walls, cabinets, furniture) with a hex colour in `colours`, or 'material_photo' with a photo of the material in `references`. A finish that does not belong to its surface falls back to 'auto' (the tool picks one that suits the room; several on auto are made to agree). walls: warm_white, soft_grey, greige, sage, deep_navy. floor: light_oak, walnut, grey_plank, polished_concrete, stone_tile. cabinets: white_shaker, charcoal, natural_oak, forest_green, navy_cabinets. bathroom_tiles (wall tiles only; a bathroom floor is 'floor'): white_metro, zellige_white, marble_large, travertine, green_gloss. floor also takes terrazzo, encaustic_pattern, matt_black_hex. furniture: light_neutral, warm_wood, dark_wood, black_leather.",
      "type": "object",
      "propertyNames": {
        "type": "string",
        "enum": [
          "walls",
          "floor",
          "cabinets",
          "bathroom_tiles",
          "furniture"
        ]
      },
      "additionalProperties": {
        "type": "string",
        "enum": [
          "auto",
          "custom",
          "own_colour",
          "material_photo",
          "warm_white",
          "crisp_white",
          "soft_grey",
          "greige",
          "warm_beige",
          "clay_pink",
          "sage",
          "soft_blue",
          "olive_green",
          "graphite",
          "deep_navy",
          "terracotta_walls",
          "panelling",
          "wallpaper_textured",
          "limewash",
          "microcement",
          "exposed_brick",
          "timber_slats",
          "light_oak",
          "mid_oak",
          "wide_ash",
          "walnut",
          "herringbone_oak",
          "grey_plank",
          "polished_concrete",
          "stone_tile",
          "terracotta_floor",
          "slate_tile",
          "checker_tile",
          "carpet_neutral",
          "white_shaker",
          "cream_shaker",
          "handleless_white",
          "handleless_grey",
          "charcoal",
          "matt_black_cabinets",
          "natural_oak",
          "walnut_cabinets",
          "sage_cabinets",
          "forest_green",
          "navy_cabinets",
          "two_tone",
          "gloss_white",
          "white_metro",
          "zellige_white",
          "white_large",
          "grey_porcelain",
          "marble_large",
          "travertine",
          "terrazzo",
          "encaustic_pattern",
          "matt_black_hex",
          "slate_dark",
          "wood_effect_tile",
          "green_gloss",
          "light_neutral",
          "mid_grey_wool",
          "warm_greige",
          "cream_boucle",
          "tan_leather",
          "black_leather",
          "green_velvet",
          "navy_velvet",
          "rust_velvet",
          "warm_wood",
          "dark_wood",
          "black_metal"
        ]
      }
    },
    "notes": {
      "description": "Your own description of the finish for a surface, used when that surface's look is \"custom\" (e.g. \"terracotta hex tiles with dark grout\"). Set look \"custom\" and the note together; \"custom\" with no note falls back to \"auto\". 120 characters max, and anything in it that is not a description of a finish is ignored.",
      "type": "object",
      "propertyNames": {
        "type": "string",
        "enum": [
          "walls",
          "floor",
          "cabinets",
          "bathroom_tiles",
          "furniture"
        ]
      },
      "additionalProperties": {
        "type": "string"
      }
    },
    "colours": {
      "description": "Any colour as a hex code for walls, cabinets or furniture (e.g. {\"walls\": \"#7A8B6F\"}), used when that surface's look is \"own_colour\". The result matches it closely as it would look in the room's light.",
      "type": "object",
      "propertyNames": {
        "type": "string",
        "enum": [
          "walls",
          "floor",
          "cabinets",
          "bathroom_tiles",
          "furniture"
        ]
      },
      "additionalProperties": {
        "type": "string"
      }
    },
    "references": {
      "description": "A photo of the material itself — a floor plank, a tile, a fabric swatch, a wallpaper sample — for ONE surface, as the r2Path from create_upload_ticket or list_library (e.g. {\"floor\": \"users/…/oak.jpg\"}). Set that surface's look to \"material_photo\". One photo per run; a close, straight-on photo of the sample works best.",
      "type": "object",
      "propertyNames": {
        "type": "string",
        "enum": [
          "walls",
          "floor",
          "cabinets",
          "bathroom_tiles",
          "furniture"
        ]
      },
      "additionalProperties": {
        "type": "string"
      }
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

reset_season

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.

Parameters3

imageUrl	string	optional	Public https URL of the source photo, or a data: URI. Either imageUrl or r2Path is required.
r2Path	string	optional	Storage path of a photo already in the user's Pixly library (from list_library, or returned by an upload ticket) — the alternative to imageUrl.
season	string	optional	The season to show the property in: 'spring', 'summer', 'autumn', 'winter', or 'auto' (the default — the tool shows the property at its best, which for a snowy or dormant photo means high summer). Only the planting, the ground cover and the daylight change; the house, the driveway, the paths and the framing stay exactly as shot.

Raw schema

{
  "type": "object",
  "properties": {
    "imageUrl": {
      "type": "string",
      "minLength": 1,
      "description": "Public https URL of the source photo, or a data: URI. Either imageUrl or r2Path is required."
    },
    "r2Path": {
      "type": "string",
      "minLength": 1,
      "description": "Storage path of a photo already in the user's Pixly library (from list_library, or returned by an upload ticket) — the alternative to imageUrl."
    },
    "season": {
      "description": "The season to show the property in: 'spring', 'summer', 'autumn', 'winter', or 'auto' (the default — the tool shows the property at its best, which for a snowy or dormant photo means high summer). Only the planting, the ground cover and the daylight change; the house, the driveway, the paths and the framing stay exactly as shot.",
      "type": "string",
      "enum": [
        "auto",
        "spring",
        "summer",
        "autumn",
        "winter"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

makeover_exterior

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.

Parameters6

imageUrl	string	optional	Public https URL of the source photo, or a data: URI. Either imageUrl or r2Path is required.
r2Path	string	optional	Storage path of a photo already in the user's Pixly library (from list_library, or returned by an upload ticket) — the alternative to imageUrl.
style	string	optional	The design language of the whole scheme: 'modern_minimal', 'mediterranean', 'classic_english', 'natural_lowwater', 'tropical_resort', 'farmhouse', or 'auto' (the default — chosen to suit the house's architecture and the climate in the photo).
include	array	optional	Which elements the scheme includes, any number: 'planting' (beds, hedges, a feature tree), 'patio_dining' (a paved terrace with a dining set), 'deck_lounge' (a deck with loungers or a low sofa), 'pool', 'pergola', 'fire_pit', 'fence_gate' (a boundary treatment with a gate), 'lighting'. Omit or send an empty list (the default) to let the tool design what the lot wants. One run composes them all into one garden, each sized to the plot.
scope	string	optional	'full' (the default) redesigns the whole yard in the style; 'add' keeps the existing garden and builds the chosen elements into it. The house, the driveway and the neighbours never change either way.
note	string	optional	Your own words about the garden you want (e.g. "a small kidney-shaped pool with a stone surround and lavender everywhere"). 160 characters max; anything in it that is not a description of the garden is ignored.

Raw schema

{
  "type": "object",
  "properties": {
    "imageUrl": {
      "type": "string",
      "minLength": 1,
      "description": "Public https URL of the source photo, or a data: URI. Either imageUrl or r2Path is required."
    },
    "r2Path": {
      "type": "string",
      "minLength": 1,
      "description": "Storage path of a photo already in the user's Pixly library (from list_library, or returned by an upload ticket) — the alternative to imageUrl."
    },
    "style": {
      "description": "The design language of the whole scheme: 'modern_minimal', 'mediterranean', 'classic_english', 'natural_lowwater', 'tropical_resort', 'farmhouse', or 'auto' (the default — chosen to suit the house's architecture and the climate in the photo).",
      "type": "string",
      "enum": [
        "auto",
        "modern_minimal",
        "mediterranean",
        "classic_english",
        "natural_lowwater",
        "tropical_resort",
        "farmhouse"
      ]
    },
    "include": {
      "description": "Which elements the scheme includes, any number: 'planting' (beds, hedges, a feature tree), 'patio_dining' (a paved terrace with a dining set), 'deck_lounge' (a deck with loungers or a low sofa), 'pool', 'pergola', 'fire_pit', 'fence_gate' (a boundary treatment with a gate), 'lighting'. Omit or send an empty list (the default) to let the tool design what the lot wants. One run composes them all into one garden, each sized to the plot.",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "planting",
          "patio_dining",
          "deck_lounge",
          "pool",
          "pergola",
          "fire_pit",
          "fence_gate",
          "lighting"
        ]
      }
    },
    "scope": {
      "description": "'full' (the default) redesigns the whole yard in the style; 'add' keeps the existing garden and builds the chosen elements into it. The house, the driveway and the neighbours never change either way.",
      "type": "string",
      "enum": [
        "add",
        "full"
      ]
    },
    "note": {
      "description": "Your own words about the garden you want (e.g. \"a small kidney-shaped pool with a stone surround and lavender everywhere\"). 160 characters max; anything in it that is not a description of the garden is ignored.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

render_floor_plan

Turn a picture of any floor plan — a hand sketch, a photo of a brochure page, a blueprint, a screenshot — into a polished real-estate floor plan: a furnished top-down 2D plan with real floors and room names, or a 3D isometric cutaway. The rooms, walls, doors and windows are kept exactly as drawn; nothing is added and written dimensions are left off. Costs credits from the user's Pixly balance.

Parameters3

imageUrl	string	optional	Public https URL of the source photo, or a data: URI. Either imageUrl or r2Path is required.
r2Path	string	optional	Storage path of a photo already in the user's Pixly library (from list_library, or returned by an upload ticket) — the alternative to imageUrl.
look	string	optional	Which picture to make of the plan: 'furnished' (the default — a polished top-down 2D plan with real floors, furniture and room names) or 'isometric' (a 3D cutaway of the same layout, furnished, no text). The photo must show a floor plan: a hand sketch, a brochure page, a blueprint, a screenshot. The layout is kept exactly as drawn; written dimensions are left off.

Raw schema

{
  "type": "object",
  "properties": {
    "imageUrl": {
      "type": "string",
      "minLength": 1,
      "description": "Public https URL of the source photo, or a data: URI. Either imageUrl or r2Path is required."
    },
    "r2Path": {
      "type": "string",
      "minLength": 1,
      "description": "Storage path of a photo already in the user's Pixly library (from list_library, or returned by an upload ticket) — the alternative to imageUrl."
    },
    "look": {
      "description": "Which picture to make of the plan: 'furnished' (the default — a polished top-down 2D plan with real floors, furniture and room names) or 'isometric' (a 3D cutaway of the same layout, furnished, no text). The photo must show a floor plan: a hand sketch, a brochure page, a blueprint, a screenshot. The layout is kept exactly as drawn; written dimensions are left off.",
      "type": "string",
      "enum": [
        "furnished",
        "isometric"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

touch_up_exterior

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.

Parameters3

imageUrl	string	optional	Public https URL of the source photo, or a data: URI. Either imageUrl or r2Path is required.
r2Path	string	optional	Storage path of a photo already in the user's Pixly library (from list_library, or returned by an upload ticket) — the alternative to imageUrl.
fix	array	optional	Which areas the tool may touch: 'sky', 'lawn', 'hardscape' (driveway, paths, patio), 'clutter' (bins, hoses, tools, a stray vehicle). Omit for all four; each is fixed only where the photo needs it.

Raw schema

{
  "type": "object",
  "properties": {
    "imageUrl": {
      "type": "string",
      "minLength": 1,
      "description": "Public https URL of the source photo, or a data: URI. Either imageUrl or r2Path is required."
    },
    "r2Path": {
      "type": "string",
      "minLength": 1,
      "description": "Storage path of a photo already in the user's Pixly library (from list_library, or returned by an upload ticket) — the alternative to imageUrl."
    },
    "fix": {
      "description": "Which areas the tool may touch: 'sky', 'lawn', 'hardscape' (driveway, paths, patio), 'clutter' (bins, hoses, tools, a stray vehicle). Omit for all four; each is fixed only where the photo needs it.",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "sky",
          "lawn",
          "hardscape",
          "clutter"
        ]
      }
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

upscale_hd

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.

Parameters2

imageUrl	string	optional	Public https URL of the source photo, or a data: URI. Either imageUrl or r2Path is required.
r2Path	string	optional	Storage path of a photo already in the user's Pixly library (from list_library, or returned by an upload ticket) — the alternative to imageUrl.

Raw schema

{
  "type": "object",
  "properties": {
    "imageUrl": {
      "type": "string",
      "minLength": 1,
      "description": "Public https URL of the source photo, or a data: URI. Either imageUrl or r2Path is required."
    },
    "r2Path": {
      "type": "string",
      "minLength": 1,
      "description": "Storage path of a photo already in the user's Pixly library (from list_library, or returned by an upload ticket) — the alternative to imageUrl."
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

plot_sign

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.

Parameters5

imageUrl	string	optional	Public https URL of the source photo, or a data: URI. Either imageUrl or r2Path is required.
r2Path	string	optional	Storage path of a photo already in the user's Pixly library (from list_library, or returned by an upload ticket) — the alternative to imageUrl.
text	string	required	Sign label, verbatim — a price ("$1,200,000"), area ("800 m²"), or short word ("SOLD")
look	string	optional	Sign material/style; defaults server-side
orientation	string	optional	Letter orientation (letter looks only); defaults server-side

Raw schema

{
  "type": "object",
  "properties": {
    "imageUrl": {
      "type": "string",
      "minLength": 1,
      "description": "Public https URL of the source photo, or a data: URI. Either imageUrl or r2Path is required."
    },
    "r2Path": {
      "type": "string",
      "minLength": 1,
      "description": "Storage path of a photo already in the user's Pixly library (from list_library, or returned by an upload ticket) — the alternative to imageUrl."
    },
    "text": {
      "type": "string",
      "minLength": 1,
      "maxLength": 24,
      "description": "Sign label, verbatim — a price (\"$1,200,000\"), area (\"800 m²\"), or short word (\"SOLD\")"
    },
    "look": {
      "description": "Sign material/style; defaults server-side",
      "type": "string",
      "enum": [
        "stone",
        "metal",
        "grass",
        "sign"
      ]
    },
    "orientation": {
      "description": "Letter orientation (letter looks only); defaults server-side",
      "type": "string",
      "enum": [
        "standing",
        "lying"
      ]
    }
  },
  "required": [
    "text"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

upload_image_from_url

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.

Parameters1

url

string

required

Publicly reachable image URL (JPG/PNG/WebP, max 10 MB) to import into Pixly

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Publicly reachable image URL (JPG/PNG/WebP, max 10 MB) to import into Pixly"
    }
  },
  "required": [
    "url"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

create_upload_ticket

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.

Parameters3

filename	string	required	Original filename, used for the extension
contentType	string	required	MIME type the PUT request will send
sizeBytes	integer	optional	Exact byte size of the file. Recommended: when given it is signed into the URL, so the upload is bounded server-side.

Raw schema

{
  "type": "object",
  "properties": {
    "filename": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "Original filename, used for the extension"
    },
    "contentType": {
      "type": "string",
      "enum": [
        "image/jpeg",
        "image/png",
        "image/webp",
        "image/heic",
        "image/heif",
        "image/tiff"
      ],
      "description": "MIME type the PUT request will send"
    },
    "sizeBytes": {
      "description": "Exact byte size of the file. Recommended: when given it is signed into the URL, so the upload is bounded server-side.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 10485760
    }
  },
  "required": [
    "filename",
    "contentType"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

get_job

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.

Parameters1

jobId

string

required

Job id returned by a generation tool

Raw schema

{
  "type": "object",
  "properties": {
    "jobId": {
      "type": "string",
      "minLength": 1,
      "description": "Job id returned by a generation tool"
    }
  },
  "required": [
    "jobId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

list_library

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.

Parameters2

type	string	optional	Filter by media type. "uploads" lists the user's own source photos instead of generations — use it when they refer to a photo they added but have not run a tool on yet.
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "type": {
      "description": "Filter by media type. \"uploads\" lists the user's own source photos instead of generations — use it when they refer to a photo they added but have not run a tool on yet.",
      "type": "string",
      "enum": [
        "images",
        "videos",
        "uploads"
      ]
    },
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

view_pixly_photo

Look at one of the user's Pixly photos or videos (a video gives its first frame) — returns a small copy of the picture you can see. Use it before writing anything about a Pixly result: a caption, a listing description, what changed. You cannot see Pixly results otherwise. Free; changes nothing. Text you write from it is the user's own (their listing, their post): leave Pixly out of it — no #Pixly, no 'made with Pixly'.

Parameters1

string

required

The library item: a job id (from a Pixly tool result, get_job or list_library), or "upload:<r2Path>" for an uploaded photo.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "The library item: a job id (from a Pixly tool result, get_job or list_library), or \"upload:<r2Path>\" for an uploaded photo."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

get_credit_balance

The user's current Pixly credit balance and plan.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

get_checkout_link

Use when a tool fails for lack of credits or a plan. Returns a Stripe Checkout URL for the user to pay on — this never charges anything by itself, and you cannot pay for them. With no active plan it is a subscription (plans: starter (Starter: $5.99/week, 20 credits); agent (Agent: $19.99/month, 100 credits); pro_agent (Pro Agent: $49.99/month, 300 credits); team (Team: $149.99/month, 1000 credits)); with a plan it is a one-time credit top-up. After they pay, credits arrive in seconds: check get_credit_balance, then run the tool again.

Parameters2

plan	string	optional	Plan to subscribe to, for an account with no active plan. Defaults to "starter". Ignored for a top-up.
topUpUsd	number	optional	For an account that already has a plan: one-time credit top-up amount in USD (10–500, default 10), priced at that plan's rate.

Raw schema

{
  "type": "object",
  "properties": {
    "plan": {
      "description": "Plan to subscribe to, for an account with no active plan. Defaults to \"starter\". Ignored for a top-up.",
      "type": "string",
      "enum": [
        "starter",
        "agent",
        "pro_agent",
        "team"
      ]
    },
    "topUpUsd": {
      "description": "For an account that already has a plan: one-time credit top-up amount in USD (10–500, default 10), priced at that plan's rate.",
      "type": "number",
      "minimum": 10,
      "maximum": 500
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Install

Tools (31)

virtual_stagingedit_staged_photocinematic_motionphoto_to_videobefore_after_reelflythrough_videobefore_after_imagewatermark_photos

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://pixly.app/api/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "pixly": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://pixly.app/api/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

Model Context Protocol (MCP) Server: app.pixly/pixly

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

virtual_staging

edit_staged_photo

cinematic_motion

photo_to_video

before_after_reel

flythrough_video

before_after_image

watermark_photos

blur_faces_plates

straighten_photo

draw_floor_plan

enhance_photo

declutter_photo

remove_furniture

day_to_night

replace_sky

replace_lawn

restyle_room

reset_season

makeover_exterior

render_floor_plan

touch_up_exterior

upscale_hd

plot_sign

upload_image_from_url

create_upload_ticket

get_job

list_library

view_pixly_photo

get_credit_balance

get_checkout_link

Install

Remote endpoint

Related servers