GET

/v1/schemas/fal/image/fal-ai/sam-3-1/image-rle?kind=output

Accept:

kind outputactivity imagehash ab192a25…extracted Jul 6, 2026version currentsource upstream spec ↗

field	recorded source
schema	Source linked above. Source trace `64f07fae1020713d1e5f99108c392e37a2cea0a970570a4c4c99c004681c183a` { "fetchedAt": 1783331098, "extractorVersion": "1", "verifiedAt": null }

Response body

5 properties · 1 required · 2 $defs

property	type	description	constraints
rle*	string \| string[]	Run Length Encoding of the mask.
boundingbox_frames_zip	File	Zip file containing per-frame bounding box overlays.	nullable
metadata	MaskMetadata[]	Per-mask metadata when multiple RLEs are returned.	nullable
boxes	number[][]	Per-mask normalized bounding boxes [cx, cy, w, h] when requested.	nullable
scores	number[]	Per-mask confidence scores when requested.	nullable

Types

2 $defs

Fileobject

content_type	string	The mime type of the file.	nullable
url*	string	The URL where the file can be downloaded from.
file_name	string	The name of the file. It will be auto-generated if not provided.	nullable
file_size	integer	The size of the file in bytes.	nullable

MaskMetadataobject

score	number	Score for this mask.	nullable
index*	integer	Index of the mask inside the model output.
box	number[]	Bounding box for the mask in normalized cxcywh coordinates.	nullable

Validate a payload

before you spend tokens

shell

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