---
title: "Upscale"
method: POST
path: "/upscale"
tags: ["generate"]
---

# Upscale

`POST /upscale`

Upscale provided images synchronously with an optional prompt.

Supported image formats include JPEG, PNG, and WebP.

Images links are available for a limited period of time; if you would like to keep the image, you must download it.

## Response `200`

Image(s) generated successfully.

- GenerateImageResponse — The response which contains information about the generated image, including the download link. Images links are available for a limited period of time; if you would like to keep the image, you must download it.
  - `request_id` string — URL-safe base64 ID of the sampling request. Present when the caller supplied `webhook_url` and the request was accepted for async delivery; in that case `data` is omitted and the generated images will be POSTed to the customer's `webhook_url` when ready.
  - `created` string, date-time, required — The time the request was created.
  - `data` ImageObject[] — A list of ImageObjects that contain the generated image(s).
    - `url` string, uri, nullable — The direct link to the image generated.
    - `prompt` string, required — The prompt used for the generation. This may be different from the original prompt.
    - `resolution` string, required — The resolution of the final image.
    - `upscaled_resolution` string — Output resolution, only used if operations alters image dimensions, such as upscale, crop etc.
    - `is_image_safe` boolean, required — Whether this request passes safety checks. If false, the url field will be empty.
    - `seed` integer, required — Random seed. Set for reproducible generation.
    - `style_type` 'AUTO' | 'GENERAL' | 'FICTION' | 'REALISTIC' | 'DESIGN' | 'RENDER_3D' | 'ANIME' | 'CUSTOM' | 'STYLIZED' — The style type to generate with; this is only applicable for models V_2 and above and should not be specified for model versions V_1.

## Other responses

- `400` — Invalid input provided.
- `403` — Not authorized to generate an image.
- `422` — Prompt or provided image failed safety check.
- `429` — Too many requests.

## Changes

> 16 revisions in range; 13 could not be searched.

- **2026-07-26** `7e5e0fb30776` — 1 info
  - added the new `V4_QWEN_3_5_27B_PRUNA_FP8` enum value to the request property `image_request/magic_prompt_version`

[Change history](https://skmtc.dev/ideogram/apis/ideogram-openapi-3-0/changes/upscale/post.md)

---

[API](https://skmtc.dev/ideogram/apis/ideogram-openapi-3-0.md) · [All operations](https://skmtc.dev/ideogram/apis/ideogram-openapi-3-0/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ideogram/ideogram-openapi-3-0/revisions/3eb3216eed39/schema)