Genesis Docs

Models / Providers

Fal

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

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

Set a default image model

{
  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

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

HeyGen video-agent config example

{
  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.