GET

/v1/schemas/fal/image/meta/muse-image/edit

Accept:

kind inputactivity imagehash 4d1b9c4c…extracted Sep 16, 2026version currentsource upstream spec ↗

field	recorded source
schema	Source linked above. upstream-spec Source trace `32696577f172cf9749d9b7d3e7e87a4b8e26eb5f7dbed565ab54adca2b8c14a3` { "fetchedAt": 1789534838, "extractorVersion": "1", "verifiedAt": null }

Request body

6 properties · 2 required · 0 $defs

property	type	description	constraints
image_urls*	string[]	Reference images used for the edit. Provide between 1 and 10 HTTP(S) or data URLs.	items ≥ 1 · items ≤ 10
prompt*	string	The text prompt used to generate or edit the image.	length ≥ 1
aspect_ratio	string	Any custom output aspect ratio as "width:height", for example "16:9", "5:4", or "1920:1200". Common presets are "21:9", "16:9", "4:3", "3:2", "1:1", "2:3", "3:4", "9:16", "9:21". The ratio must be between 1:16 and 16:1, the range Muse supports. Only the ratio is used: Muse renders it at its own fixed resolution of roughly 2.5 megapixels, so "1920:1200" and "960:600" both return the same 1920x1200 image. If omitted, Muse chooses the output dimensions automatically.	nullable
sync_mode	boolean	If `True`, the image is returned as a data URI and is not persisted in the request history.	default: false
num_images	integer	The number of edited images to generate.	1 ≤ n ≤ 10 · default: 1
output_format	enum	The format of the generated image.	jpeg \| png \| webp · default: "webp"

Validate a payload

before you spend tokens

shell

$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"fal","endpointId":"meta/muse-image/edit","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}