Run Model
Runs a model in Fal AI.
This node is also exposed as an AI Agent tool.
This node has 1 input port and 1 output port.
Common Properties
Every node shares these.
- Name — the node's display name on the canvas.
- Color — the node's colour on the canvas.
- Delay Before (sec) — wait this long before the node runs.
- Delay After (sec) — wait this long after the node runs.
- Continue On Error — carry on instead of failing the flow. Defaults to false.
info
When Continue On Error is true the error is not raised at all, so a Catch node will not see it either.
Inputs
| Property | Field | Description |
|---|---|---|
| Client ID | inClientID | Client ID from Connect node (optional if credentials provided) |
| Input | inInput | Model input parameters as JSON (e.g. {"prompt": "a cat"，"image_size": "landscape_4_3"}) |
| Model ID | inModelID | Fal.ai model ID (e.g. fal-ai/flux/dev，fal-ai/fast-sdxl，fal-ai/wan/v2.2) |
Outputs
| Property | Field | Description |
|---|---|---|
| Request ID | outRequestID | Fal.ai request ID |
| Result | outResult | Model output (images，videos，audio，etc.) |
Options
| Property | Field | Description |
|---|---|---|
| Credentials | optCredentials | Fal.ai API key (optional if using Connect node) |
| Mode | optMode | Queue mode polls for result; Sync mode blocks until done One of: queue, sync. |
| Timeout (seconds) | optTimeout | Maximum time to wait for result (default 300s) |
Requirements
- A Client ID from this package's Connect node, unless you set credentials directly on this node.
- Fal AI API Key — API key for Fal.ai authentication
value— API Key (password, required). Your Fal.ai API key
Store these in a Vault and reference the vault item from the node, rather than typing the secret into the property.
Related nodes
Connect · Disconnect · Submit Request · Get Request Status · Get Request Result · Cancel Request · Toolkit
See also
- Fal AI — every node in this package
- Message object — how properties read values from
msg - Handling failure — Continue On Error, Catch and retries