GET

/v1/schemas/fal/video/fal-ai/flux-3-action/so101

Accept:

kind inputactivity videohash c167aab9…extracted Sep 25, 2026version currentsource upstream spec ↗

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

Request body

11 properties · 4 required · 0 $defs

property	type	description	constraints
wrist_image_url*	string	Current frame from the wrist camera (tiled right). Resized to 256x256.
scene_image_url*	string	Current frame from the fixed scene camera (tiled left). Resized to 256x256.
state*	number[]	Measured state: shoulder pan, shoulder lift, elbow flex, wrist flex, wrist roll (degrees), gripper (percent).	items ≥ 6 · items ≤ 6
prompt*	string	Natural-language task instruction for the robot.	length ≥ 1 · length ≤ 2000
seed	integer	Sampling seed. Omit for a random seed; the reference evaluation seed is 0 for DROID and 42 for SO-101.	nullable
guidance_scale	number	Classifier-free guidance on video and action; 1.0 disables CFG.	1 ≤ n ≤ 10 · default: 3
state_history	number[][]	Measured states at the 7 control ticks (30 Hz) before `state`, oldest first. Requires `command_history`. Omit for a fresh episode.	items ≥ 7 · items ≤ 7 · nullable
num_inference_steps	integer	Euler denoising steps. The checkpoint was validated at 4.	1 ≤ n ≤ 8 · default: 4
command_history	number[][]	Absolute commands in effect at each of the 8 observation ticks, oldest first; the last row is the most recent command sent. Requires `state_history`.	items ≥ 8 · items ≤ 8 · nullable
history_wrist_image_url	string	Wrist frame from the oldest history tick. Requires `state_history`.	nullable
history_scene_image_url	string	Scene frame from the oldest history tick (7 ticks before now). Requires `state_history`. Defaults to the current frame.	nullable

Validate a payload

before you spend tokens

shell

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