Skip to main content
Endpoint: POST https://fal.run/fal-ai/ideogram/upscale Endpoint ID: fal-ai/ideogram/upscale

Try it in the Playground

Run this model interactively with your own prompts.

​
Quick Start

import fal_client

def on_queue_update(update):
    if isinstance(update, fal_client.InProgress):
        for log in update.logs:
           print(log["message"])

result = fal_client.subscribe(
    "fal-ai/ideogram/upscale",
    arguments={
        "image_url": "https://fal.media/files/monkey/e6RtJf_ue0vyWzeiEmTby.png"
    },
    with_logs=True,
    on_queue_update=on_queue_update,
)
print(result)

​
Capabilities

  • Image input
  • Text prompt input
  • Reproducible generation (seed)
  • Synchronous mode

​
API Reference

​
Input Schema

​
image_url
string
required
The image URL to upscale
​
prompt
string
default:""
The prompt to upscale the image with Default value: ""
​
resemblance
integer
default:"50"
The resemblance of the upscaled image to the original image Default value: 50Range: 1 to 100
​
detail
integer
default:"50"
The detail of the upscaled image Default value: 50Range: 1 to 100
​
expand_prompt
boolean
default:"false"
Whether to expand the prompt with MagicPrompt functionality.
​
seed
integer
Seed for the random number generator
​
sync_mode
boolean
default:"false"
If True, the media will be returned as a data URI and the output data won’t be available in the request history.

​
Output Schema

​
images
list<File>
required
​
seed
integer
required
Seed used for the random number generator

​
Input Example

{
  "image_url": "https://fal.media/files/monkey/e6RtJf_ue0vyWzeiEmTby.png",
  "prompt": "",
  "resemblance": 50,
  "detail": 50,
  "expand_prompt": false,
  "sync_mode": false
}

​
Output Example

{
  "images": [
    {
      "content_type": "image/png",
      "file_name": "image.png",
      "file_size": 6548418,
      "url": "https://fal.media/files/lion/DxTSV6683MLl4VPAVUHR3_image.png"
    }
  ],
  "seed": 123456
}

​
Limitations

  • resemblance range: 1 to 100
  • detail range: 1 to 100