Generate an image
Submits an asynchronous image generation job to the fal.ai queue and returns the queued job immediately. Poll GET /v1/jobs/{id} for status and results. Credits are charged only when the job completes successfully.
Authorizations
API key in the format: Bearer {api_token}
Headers
Makes this write safe to retry: a repeat with the same key replays the first response instead of creating a second resource. Scoped to the account, remembered for 24 hours; reusing a key with a different payload is an error.
255Body
Model-specific input, forwarded to fal verbatim. prompt is required.
A quality tier (fast, balanced, quality) or any fal.ai image endpoint id. Prefer a tier — it tracks the best current model for that price point. Defaults to fal-ai/nano-banana-2; GET /v1/images/models maps tiers to ids with live pricing.
"fast"
"balanced"
"quality"
"fal-ai/z-image/turbo"
"fal-ai/nano-banana-2"
"openai/gpt-image-2.5/flare/text-to-image"
Response
Generation job queued
queued, processing, completed, failed, cancelled 
