Skip to content

fal.ai

Choose fal so that agents can make images, with the FLUX models on fal.ai. It uses your fal key and fal bills you for each image; you can set a monthly cap in US dollars on a key. Adding the module does nothing by itself: next, make an image tool under Tools and give it to an agent. Have a key from the fal dashboard ready, in the form key id:secret.

Images with FLUX and other models on fal.ai, for agents’ image tools. Uses your fal key.

  • Images: it can be made into a tool in the tool library and given to agents.
  • An API key, from fal → Keys. You type it on the machine or in the app; it is kept on the machine only.

Your machine sends the prompt to fal.ai with your key and downloads the images it makes. The key is kept on your machine only.

fal bills the account the key belongs to.

You can add the module from the machine’s page in the app. To do it by hand, run these on the machine.

The steps are the same on macOS, Linux and Windows.

  1. Add fal.ai

    Terminal window
    monoclaw modules add fal
  2. Add a key

    Terminal window
    monoclaw modules connect fal --name "fal.ai key"

    Paste the key when asked (it isn’t shown). It’s kept on this machine only. Add more keys the same way, one per budget or team.

    Get a key at fal → Keys.

  3. Set a monthly limit (optional)

    Terminal window
    monoclaw modules cap <connection id> --usd 20

    The connection id (pac_…) is in monoclaw modules list. The machine stops using the key when the limit is reached.

  4. Check it

    Terminal window
    monoclaw modules list

    It says Ready when it can be used; the machine’s page in the app shows the same.

You choose these when you make a tool from this module.

Model. Default: FLUX.1 [schnell].

  • FLUX.1 [schnell]: Fast and cheap (about $0.003 a megapixel).
  • FLUX.1 [dev]: Better detail (about $0.025 a megapixel).
  • FLUX 1.1 [pro] Ultra: Up to 4 MP, photographic (about $0.06 an image).
  • FLUX.2 [pro]: The newest FLUX, best quality (about $0.03 a megapixel).
  • FLUX.2 [flash]: The newest FLUX, fast (about $0.005 a megapixel).

Size: one of Square HD (1024×1024), Square (512×512), Portrait 3:4, Portrait 9:16, Landscape 4:3, Landscape 16:9. Default: Landscape 4:3. An agent may choose this each time it uses the tool.

Images per call: a number from 1 to 4. Default: 1.

Format: JPEG or PNG. Default: JPEG.

Safety checker: on or off. Default: on.

Each connection can have a monthly cap, in US dollars. The machine counts what the connection used in the calendar month (UTC) and refuses work that would go over the cap.

Terminal window
monoclaw modules cap <connection id> --usd <n>
monoclaw modules cap <connection id> --off

The connection id is shown by monoclaw modules list.

The most images one call can make depends on the model:

Model Images per call
FLUX.1 [schnell] up to 4
FLUX.1 [dev] up to 4
FLUX 1.1 [pro] Ultra up to 4
FLUX.2 [pro] 1
FLUX.2 [flash] up to 4

You can add more than one key, for example one for each team or budget. Each has its own cap.