---
title: "Image upscale"
method: POST
path: "/v1/image_upscale"
tags: ["Start generating"]
---

# Image upscale

`POST /v1/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).

## Headers

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

## Request body

- object
  - `imageUri` union, required — Image to upscale. See [image inputs](/assets/inputs#images) for URL, upload, and file size limits.
    - string — A HTTPS URL, Runway upload URI, or base64 data URI (e.g. `data:image/png;base64,...`, up to 5MB) containing an encoded image. See [our docs](/assets/inputs#images) on image inputs for more information.
    - string — A Runway upload URI. See https://docs.dev.runwayml.com/assets/uploads for more information.
    - string — A data URI containing encoded media.
  - `scaleFactor` 2 | 4 | 8 | 16 — Multiplies each input dimension to produce output width and height. Defaults to 2.
  - `sharpen` integer — Sharpness intensity from 0 (none) to 100.
  - `smartGrain` integer — Grain and texture enhancement from 0 to 100.
  - `ultraDetail` integer — 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

## Response `200`

The task that was created.

- object
  - `id` string, uuid, required — The ID of the task that was created. Use this to retrieve the task later.
  - `estimatedCost` object, required — The maximum credits this task may charge. The final amount may be lower after the task completes.
    - `credits` number, required — Estimated cost of the generation in credits.

## Other responses

- `400` — The request was rejected. Inspect `error` or `issues` (when present) and retry with a corrected request.
- `429` — You have exceeded the rate limit for this endpoint.

---

[API](https://skmtc.net/runwayml/apis/runwayml-api.md) · [All operations](https://skmtc.net/runwayml/apis/runwayml-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/runwayml/runwayml-api/revisions/cbbe796a13a0/schema)