mirror of
https://github.com/openclaw/openclaw.git
synced 2026-04-14 10:41:23 +00:00
92 lines
1.8 KiB
Markdown
92 lines
1.8 KiB
Markdown
---
|
|
title: "fal"
|
|
summary: "fal image and video generation setup in OpenClaw"
|
|
read_when:
|
|
- 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.
|
|
|
|
- Provider: `fal`
|
|
- Auth: `FAL_KEY` (canonical; `FAL_API_KEY` also works as a fallback)
|
|
- API: fal model endpoints
|
|
|
|
## Quick start
|
|
|
|
1. Set the API key:
|
|
|
|
```bash
|
|
openclaw onboard --auth-choice fal-api-key
|
|
```
|
|
|
|
2. Set a default image model:
|
|
|
|
```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`.
|
|
|
|
- Generate: up to 4 images per request
|
|
- Edit mode: enabled, 1 reference image
|
|
- Supports `size`, `aspectRatio`, and `resolution`
|
|
- Current edit caveat: the fal image edit endpoint does **not** support
|
|
`aspectRatio` overrides
|
|
|
|
To use fal as the default image provider:
|
|
|
|
```json5
|
|
{
|
|
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`.
|
|
|
|
- Modes: text-to-video and single-image reference flows
|
|
- Runtime: queue-backed submit/status/result flow for long-running jobs
|
|
|
|
To use fal as the default video provider:
|
|
|
|
```json5
|
|
{
|
|
agents: {
|
|
defaults: {
|
|
videoGenerationModel: {
|
|
primary: "fal/fal-ai/minimax/video-01-live",
|
|
},
|
|
},
|
|
},
|
|
}
|
|
```
|
|
|
|
## Related
|
|
|
|
- [Image Generation](/tools/image-generation)
|
|
- [Video Generation](/tools/video-generation)
|
|
- [Configuration Reference](/gateway/configuration-reference#agent-defaults)
|