Generate

The generate method is a simplified entry point for quick image generation. It wraps POST /generate with sensible defaults.

Basic Usage

result = client.generate(
    prompt="a beautiful sunset over mountains",
    model="fal-ai/flux/schnell",  # optional, defaults to fal-ai/flux/schnell
    params=None,                  # optional, model-specific parameters
)
 
print(result.images)       # list of image URLs
print(result.image_url)    # first image URL (convenience)
print(result.mode)         # "managed" or "byok"
print(result.provider)     # e.g. "fal"
print(result.cost)         # estimated cost in USD
print(result.latency_ms)   # request latency in milliseconds

With Extra Parameters

result = client.generate(
    prompt="a beautiful sunset over mountains",
    model="fal-ai/flux/schnell",
    params={"num_images": 2, "image_size": "1024x1024"},
)

GenerateResult Properties

Property	Python	JavaScript	Type	Description
ID	`result.id`	`result.id`	`string`	Request ID
Images	`result.images`	`result.images`	`list[str]` / `string[]`	Generated image URLs
First image	`result.image_url`	`result.imageUrl`	`string \| null`	Convenience: first URL
Model	`result.model`	`result.model`	`string`	Model identifier used
Provider	`result.provider`	`result.provider`	`string`	e.g. "fal", "replicate"
Mode	`result.mode`	`result.mode`	`string`	"managed" or "byok"
Cost	`result.cost`	`result.cost`	`float` / `number`	Estimated cost in USD
Latency	`result.latency_ms`	`result.latencyMs`	`int` / `number`	Latency in milliseconds
Resolution	`result.resolution`	`result.resolution`	`dict` / `object`	`{ width, height }`
Created at	`result.created_at`	`result.createdAt`	`string`	ISO timestamp

Basic Usage

With Extra Parameters

GenerateResult Properties

On this page