GET

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

Accept:

kind outputactivity videohash b328bf02…extracted Oct 23, 2026version currentsource upstream spec ↗

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

Response body

6 properties · 1 required · 3 $defs

property	type	description	constraints
rle*	string[] \| File	Per-frame RLE masks, or a JSON file containing them in URL mode.
scores	number[]	Per-mask confidence scores when requested.	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
objects	ObjectRLE[][] \| File	With return_object_rles, each frame's tracked objects with their masks and ids, or a JSON file containing them in URL mode.	nullable
boundingbox_frames_zip	File	Zip file containing per-frame bounding box overlays.	nullable

Types

3 $defs

Fileobject

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

MaskMetadataobject

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

ObjectRLEobject

object_id*	integer	The object's id, the same in every frame the object appears in.
rle*	string	Run Length Encoding of this object's mask.
box	number[]	Bounding box of this object's 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/video-rle","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}