Skip to main content
POST
Generate Image
Generates an image from a text prompt. This endpoint is always async — it returns a job_id immediately and the actual generation happens on a background queue. Poll GET /jobs/:id until status is completed, then read result.url. The completed image is automatically uploaded to R2 storage and saved to the team’s asset library.

Authentication

string
Bearer token. Bearer <api-key-or-jwt>.

Body

string
required
Text description of the image to generate.
string
default:"fal:flux-schnell"
Model identifier in provider:model format. Use GET /models to list options.
string
Aspect ratio for the generated image, e.g. "9:16", "1:1", "16:9".
string
URL of a reference image for image-to-image generation.
number
How closely to follow the reference image (0-1). Only used when reference_image_url is provided.
string
If provided, the completed image is automatically appended to this influencer’s image array. Survives the user navigating away mid-generation.

Polling pattern