openclaw/docs/providers/fal.md

title, summary, read_when

title	summary	read_when
fal	fal image and video generation setup in OpenClaw	You want to use fal image generation in OpenClaw You need the FAL_KEY auth flow You want fal defaults for image_generate or video_generate

fal

OpenClaw ships a bundled fal provider for hosted image and video generation.

Property	Value
Provider	fal
Auth	FAL_KEY (canonical; FAL_API_KEY also works as a fallback)
API	fal model endpoints

Getting started

```bash openclaw onboard --auth-choice fal-api-key ``` ```json5 { agents: { defaults: { imageGenerationModel: { primary: "fal/fal-ai/flux/dev", }, }, }, } ```

Image generation

The bundled fal image-generation provider defaults to fal/fal-ai/flux/dev.

Capability	Value
Max images	4 per request
Edit mode	Enabled, 1 reference image
Size overrides	Supported
Aspect ratio	Supported
Resolution	Supported

The fal image edit endpoint does **not** support `aspectRatio` overrides.

To use fal as the default image provider:

{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "fal/fal-ai/flux/dev",
      },
    },
  },
}

Video generation

The bundled fal video-generation provider defaults to fal/fal-ai/minimax/video-01-live.

Capability	Value
Modes	Text-to-video, single-image reference
Runtime	Queue-backed submit/status/result flow for long-running jobs

**HeyGen video-agent:**

- `fal/fal-ai/heygen/v2/video-agent`

**Seedance 2.0:**

- `fal/bytedance/seedance-2.0/fast/text-to-video`
- `fal/bytedance/seedance-2.0/fast/image-to-video`
- `fal/bytedance/seedance-2.0/text-to-video`
- `fal/bytedance/seedance-2.0/image-to-video`

```json5 { agents: { defaults: { videoGenerationModel: { primary: "fal/bytedance/seedance-2.0/fast/text-to-video", }, }, }, } ``` ```json5 { agents: { defaults: { videoGenerationModel: { primary: "fal/fal-ai/heygen/v2/video-agent", }, }, }, } ``` Use `openclaw models list --provider fal` to see the full list of available fal models, including any recently added entries.

Related

Shared image tool parameters and provider selection. Shared video tool parameters and provider selection. Agent defaults including image and video model selection.