infery
← All models

Flux 3 Action

flux-3-action-so101

Video generationby Black Forest Labs

FLUX 3 Action turns what the robot sees into what it does next. Give it the scene camera image, the wrist camera image, the current SO-101 joint state (shoulder pan, shoulder lift, elbow flex, wrist flex, wrist roll, gripper) and a plain-language instruction such as "Pick up the yellow cube and place it inside the black rectangle". It returns a chunk of 42 target joint positions at 30 Hz, that is 1.4 s of motion. In a control loop, execute the first 32 steps (about 1 s), then call again with fresh images and joint state.

Details

Accepts
text

Pricing

Price
0.375 cr / second

Prices in credits (1 credit = $0.01).

Data schema

Input

FieldTypeDescription
seed—Sampling seed. Omit for a random seed; the reference evaluation seed is 0 for DROID and 42 for SO-101.
staterequiredarrayMeasured state: shoulder pan, shoulder lift, elbow flex, wrist flex, wrist roll (degrees), gripper (percent).
promptrequiredstringNatural-language task instruction for the robot.
state_history—Measured states at the 7 control ticks (30 Hz) before `state`, oldest first. Requires `command_history`. Omit for a fresh episode.
guidance_scalenumberClassifier-free guidance on video and action; 1.0 disables CFG.
command_history—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`.
scene_image_urlrequiredstringCurrent frame from the fixed scene camera (tiled left). Resized to 256x256.
wrist_image_urlrequiredstringCurrent frame from the wrist camera (tiled right). Resized to 256x256.
num_inference_stepsintegerEuler denoising steps. The checkpoint was validated at 4.
history_scene_image_url—Scene frame from the oldest history tick (7 ticks before now). Requires `state_history`. Defaults to the current frame.
history_wrist_image_url—Wrist frame from the oldest history tick. Requires `state_history`.

Output

FieldTypeDescription
seedintegerSeed used for sampling.
actionsarrayPredicted action chunk, one row per control step in time order. DROID: 32x8 absolute joint targets (rad) plus gripper closed fraction at 15 Hz. SO-101: 42x6 absolute commands (deg, gripper %) at 30 Hz. Not clipped: enforce joint, velocity and workspace limits on the robot.
timingsobjectServer-side timings in seconds.
action_hznumberControl rate of the action rows.
action_labelsarrayName of each action column.
execute_stepsintegerExecute this many leading actions, then request a new chunk.