Fal
Connects to the fal.ai image/video generation API. An agent can generate images using FLUX, SDXL, and other fal.ai models, and list popular model slugs.
Add to an agent node's tools array with _node_type: "tool-fal". See Connector Reference — How connectors are used.
Authentication
| Field | Required | Description |
|---|---|---|
api_key | Yes (or fal_api_key) | fal.ai API key, sent as Authorization: Key <api_key>. |
fal_api_key | Yes (if api_key not set) | Used if api_key is not set. |
{
"name": "fal",
"_node_type": "tool-fal",
"api_key": "{{ secret.FAL_API_KEY }}"
}
Tools
fal_generate_image
Generate images using fal.ai models (FLUX Schnell, FLUX Dev, SDXL, etc.). Returns image URLs.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
prompt | string | Yes | Image description |
model | string | No | Model slug, e.g. fal-ai/flux/schnell (default), fal-ai/flux/dev, fal-ai/stable-diffusion-xl |
negative_prompt | string | No | What to avoid |
width | number | No | Image width (default 1024) |
height | number | No | Image height (default 1024) |
steps | number | No | Inference steps (default 4 for schnell, 25 for others) |
num_images | number | No | Number of images to generate (default 1) |
seed | number | No | Seed for reproducibility |
Returns: JSON with image_url (first generated image URL), image_urls (array of all generated URLs), model, and provider ("fal").
fal_list_models
List popular fal.ai image generation model slugs.
No parameters.
Returns: JSON with models, an array of {slug, description} entries covering FLUX Schnell, FLUX Dev, FLUX Pro, Stable Diffusion XL, AuraFlow, and Kolors.