v50

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01600974.4 KB

Start generating

Image upscale

Upscale an image with Magnific precision upscaling. Each input dimension must be between 300px and 8000px. Output width and height are the input dimensions multiplied by scaleFactor (default 2). Output width times height cannot exceed 25,300,000 pixels (~25.3 million).

post/v1/image_upscale

Headers

X-Runway-Version'2024-11-06' required

The version of the RunwayML API being used. You can read more about versioning here.

Request body

scaleFactor2 | 4 | 8 | 16

Multiplies each input dimension to produce output width and height. Defaults to 2.

sharpeninteger

Sharpness intensity from 0 (none) to 100.

smartGraininteger

Grain and texture enhancement from 0 to 100.

ultraDetailinteger

Fine detail enhancement from 0 to 100.

flavor'sublime' | 'photo' | 'photo_denoiser'

Optimization preset: sublime (illustration), photo (photographic), or photo_denoiser (noisy photos).

model'magnific_precision_upscaler_v2' required

Example request

{
  "imageUri": "https://example.com/image.jpg"
}

Response

The task that was created.

idstring uuid required

The ID of the task that was created. Use this to retrieve the task later.