Skip to main content
POST
Upscale an image
Runs a super-resolution model and returns the result on the same request. There is no prompt and no editing: the image is enlarged, and nothing about its content is directed. If you want the content changed, that is image edits.

Authorizations

Authorization
string
header
required

API key in format: Bearer inf_***

Body

application/json
model
string
required

Slug of the upscale model to run, as listed by GET /v1/models. Must be an upscale-modality model that accepts an image input and is served by FAL; anything else is rejected with 400.

image_url
string
required

Source image to upscale, as a URL or a data URI. Required.

Example:

"https://example.com/photo.png"

scale
number

Upscale factor. Forwarded onto whichever of the model's own input fields is named scale, upscale_factor or upscaling_factor; silently ignored by a model that declares none of them. Omit to use the model's own default.

Example:

4

Response

The upscaled image. data normally holds a single artifact.

created
integer
required

Unix timestamp, in seconds, of when the result was produced.

Example:

1713204900

data
object[]
required

One entry per produced artifact, in the order the provider returned them.

credits_used
number
required

Credits actually settled for this request (1 credit = $0.01). Settled against measured compute for per_second models, clamped to the amount reserved before the call, so it is never larger than the hold. May be fractional.

Example:

12.5