Genesis Docs

Genesis 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

Set the API key

```bash
genesis onboard --auth-choice fal-api-key
```

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.

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

Available video models

**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`

Seedance 2.0 config example

```json5
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "fal/bytedance/seedance-2.0/fast/text-to-video",
      },
    },
  },
}
```

HeyGen video-agent config example

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

Related