GET

/v1/schemas/fal/image/fal-ai/sam2/auto-segment

Accept:

kind inputactivity imagehash 35c7062e…extracted Jul 6, 2026version currentsource upstream spec ↗

field	recorded source
schema	Source linked above. Source trace `608a33f03e2ad1f73d9d318accc122d4476d362db663fed7b0afad3ca8a70451` { "fetchedAt": 1783329487, "extractorVersion": "1", "verifiedAt": null }

Request body

7 properties · 1 required · 0 $defs

property	type	description	constraints
image_url*	string	URL of the image to be automatically segmented
min_mask_region_area	integer	Minimum area of a mask region.	default: 100
output_format	enum	The format of the generated image.	jpeg \| png · default: "png"
points_per_side	integer	Number of points to sample along each side of the image.	default: 32
pred_iou_thresh	number	Threshold for predicted IOU score.	default: 0.88
sync_mode	boolean	If `True`, the media will be returned as a data URI and the output data won't be available in the request history.	default: false
stability_score_thresh	number	Threshold for stability score.	default: 0.95

Validate a payload

before you spend tokens

shell

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