Images

The images.generate method gives you full control over image generation, including dimensions, negative prompts, seeds, caching, and webhooks.

Basic Usage

result = client.images.generate(
    model="fal-ai/flux/schnell",
    prompt="a futuristic city at night",
    negative_prompt=None,
    width=1024,
    height=1024,
    num_images=1,
    seed=None,
    params=None,
)

Full Options (JavaScript)

The JavaScript SDK supports additional options for caching and webhooks:

const result = await client.images.generate(
  "fal-ai/flux/schnell",
  "a cat in space",
  {
    width: 1024,
    height: 1024,
    numImages: 1,
    negativePrompt: null,
    seed: null,
    imageUrl: null,        // input image for img2img
    preferCache: true,     // use cache (exact or semantic match)
    maxLatencyMs: null,    // max acceptable latency
    webhookUrl: null,      // callback URL when done
    callbackId: null,      // id in callback payload
  }
);

ImageResult 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
Model	`result.model`	`result.model`	`string`	Model identifier
Provider	`result.provider`	`result.provider`	`string`	Provider name
Cost	`result.cost`	`result.cost`	`float` / `number`	Cost in USD
Cache hit	`result.cache_hit`	`result.cacheHit`	`bool` / `boolean`	Served from cache?
Latency	`result.latency_ms`	`result.latencyMs`	`int \| None` / `number`	Latency in ms
Created at	`result.created_at`	`result.createdAt`	`datetime` / `string`	Creation timestamp

Basic Usage

Full Options (JavaScript)

ImageResult Properties

On this page