fal Image Generation

Overview

FalImageGenService provides high-speed image generation capabilities using fal’s optimized Stable Diffusion XL models. It supports various image sizes, formats, and generation parameters with a focus on fast inference and low-latency image creation.

Fal Image Gen API Reference

Pipecat’s API methods for fal image generation integration

Example Implementation

Browse examples using fal image generation

fal Documentation

Official fal API documentation and model guides

fal Platform

Access fast SDXL models and manage API keys

Installation

To use fal image generation services, install the required dependencies:

uv add "pipecat-ai[fal]"

Prerequisites

fal Account Setup

Before using fal image generation services, you need:

fal Account: Sign up at fal Platform
API Key: Generate an API key from your account dashboard
Model Selection: Choose from available fast SDXL models
HTTP Session: Configure aiohttp session for image downloading

Required Environment Variables

FAL_KEY: Your fal API key for authentication

Configuration

InputParams

deprecated

Deprecated since 0.0.105, removed in 2.0.0. Use settings=FalImageGenService.Settings(...) instead.

aiohttp.ClientSession

required

HTTP client session for downloading generated images.

str

default:"None"

deprecated

Deprecated since 0.0.105, removed in 2.0.0. Use settings=FalImageGenService.Settings(model=...) instead.

str

default:"None"

Optional API key for fal. If provided, sets the FAL_KEY environment variable.

FalImageGenService.Settings

default:"None"

Runtime-configurable generation settings. See Settings below.

Settings

Runtime-configurable settings passed via the settings constructor argument using FalImageGenService.Settings(...). See Service Settings for details.

Parameter	Type	Default	Description
`model`	`str`	`"fal-ai/fast-sdxl"`	Fal model identifier. (Inherited from base settings.)
`seed`	`int \| None`	`None`	Random seed for reproducible generation. If `None`, uses a random seed.
`num_inference_steps`	`int`	`8`	Number of inference steps for generation.
`num_images`	`int`	`1`	Number of images to generate.
`image_size`	`str \| dict`	`"square_hd"`	Image dimensions as a string preset or dict with `width`/`height` keys.
`expand_prompt`	`bool`	`False`	Whether to automatically expand/enhance the prompt.
`enable_safety_checker`	`bool`	`True`	Whether to enable content safety filtering.
`format`	`str`	`"png"`	Output image format.
`negative_prompt`	`str \| None`	`None`	Details to keep out of the generated image. `None` omits it from the request.
`guidance_scale`	`float \| None`	`None`	CFG scale, how closely generation follows the prompt. `None` uses the model’s default.

Usage

Basic Setup

import os

import aiohttp
from pipecat.services.fal.image import FalImageGenService

async with aiohttp.ClientSession() as session:
    image_gen = FalImageGenService(
        aiohttp_session=session,
        key=os.getenv("FAL_KEY"),
        settings=FalImageGenService.Settings(
            image_size="landscape_16_9",
        ),
    )

With Custom Settings

image_gen = FalImageGenService(
    aiohttp_session=session,
    key=os.getenv("FAL_KEY"),
    settings=FalImageGenService.Settings(
        model="fal-ai/fast-sdxl",
        image_size={"width": 1024, "height": 768},
        num_inference_steps=12,
        seed=42,
        enable_safety_checker=True,
    ),
)

Notes

Environment variable: If the key constructor parameter is provided, it sets the FAL_KEY environment variable automatically.
HTTP session required: You must provide an aiohttp.ClientSession for downloading the generated images from fal’s URLs.
Image size presets: The image_size parameter accepts string presets (e.g., "square_hd", "landscape_16_9") or a dictionary with explicit width and height values.

Get Started

Pipecat Server

Client SDKs

Pipecat Flows

Pipecat Cloud

CLI

Pipecat Context Hub

fal Image Generation

Overview

Fal Image Gen API Reference

Example Implementation

fal Documentation

fal Platform

Installation

Prerequisites

fal Account Setup

Required Environment Variables

Configuration

Settings

Usage

Basic Setup

With Custom Settings

Notes

​Overview

Fal Image Gen API Reference

Example Implementation

fal Documentation

fal Platform

​Installation

​Prerequisites

​fal Account Setup

​Required Environment Variables

​Configuration

​Settings

​Usage

​Basic Setup

​With Custom Settings

​Notes

Overview

Installation

Prerequisites

fal Account Setup

Required Environment Variables

Configuration

Settings

Usage

Basic Setup

With Custom Settings

Notes