Fal

FluffBuzz 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

fluffbuzz onboard --auth-choice fal-api-key

Set a default image model

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

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

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",
      },
    },
  },
}

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:

Seedance 2.0:

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 fluffbuzz models list --provider fal to see the full list of available fal models, including any recently added entries.

Shared image tool parameters and provider selection.

Shared video tool parameters and provider selection.

Agent defaults including image and video model selection.