Skip to main content
FluffBuzz ships a bundled fal provider for hosted image and video generation.
PropertyValue
Providerfal
AuthFAL_KEY (canonical; FAL_API_KEY also works as a fallback)
APIfal model endpoints

​
Getting started

1

Set the API key

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

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.
CapabilityValue
Max images4 per request
Edit modeEnabled, 1 reference image
Size overridesSupported
Aspect ratioSupported
ResolutionSupported
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.
CapabilityValue
ModesText-to-video, single-image reference
RuntimeQueue-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
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "fal/bytedance/seedance-2.0/fast/text-to-video",
      },
    },
  },
}

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

Image generation

Shared image tool parameters and provider selection.

Video generation

Shared video tool parameters and provider selection.

Configuration reference

Agent defaults including image and video model selection.