Skip to main content
POST
Typescript (SDK)

Authorizations

Authorization
string
header
required

API key in the format: Bearer {api_token}

Body

application/json
input
object
required

Model-specific input, forwarded to fal verbatim. prompt and a source image (image_url or image_urls) are required. Either image field is accepted regardless of model — it is normalized to whichever the chosen model expects.

model
enum<string>

fal.ai model id. Defaults to fal-ai/nano-banana/edit.

Available options:
fal-ai/nano-banana/edit,
fal-ai/nano-banana-pro/edit,
fal-ai/flux-pro/kontext,
fal-ai/flux/dev/image-to-image

Response

Edit job queued

id
string
required
object
string
required
type
string
required
status
enum<string>
required
Available options:
queued,
processing,
completed,
failed,
cancelled
model
string
required
progress
integer
required
input
object
required
result
object | null
required
error
string | null
required
error_code
string | null
required
credits_used
integer | null
required
provider_request_id
string | null
required
created_at
string<date-time>
required
started_at
string<date-time> | null
required
completed_at
string<date-time> | null
required