> This page is for version v2 (default).
> For other versions, use one of these documentation indexes:
> - v2 (default): https://developer.ideogram.ai/v2/llms.txt
> - v1: https://developer.ideogram.ai/v1/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developer.ideogram.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer.ideogram.ai/_mcp/server.

> Ideogram API upscale endpoints: faithful and creative upscalers, 2x, 4x and 8x factors, output size limits and per-megapixel billing.

Upscale enlarges an image: `POST /v2/image/upscale/{model}`. Send the image as `image` in a `multipart/form-data` request.

## Faithful or creative

Faithful upscalers enlarge the image and sharpen what is already there. Creative upscalers add or reinterpret detail, which can change small lettering, faces and textures.

| Endpoint            | Kind        | What it does                                                                                          |
| ------------------- | ----------- | ----------------------------------------------------------------------------------------------------- |
| `topaz-standard-2`  | Faithful    | Sharpens the whole image and stays close to it. No prompt                                             |
| `topaz-text-refine` | Faithful    | Keeps large and small lettering sharp. No prompt                                                      |
| `topaz-wonder-3-5`  | Adds detail | Rebuilds detail, with `enhancement_strength` of `low`, `medium` or `high`                             |
| `topaz-wonder-4`    | Adds detail | Removes noise, blur and compression artifacts and recovers faces in one pass. 2x or 4x                |
| `topaz-bloom-2`     | Creative    | Adds new fine detail, guided by an optional `prompt`                                                  |
| `topaz-redefine`    | Creative    | Redraws the most, guided by an optional `prompt` or `autoprompt`                                      |
| `nano-banana-pro`   | Regenerates | Regenerates the image at a 1K, 2K or 4K `resolution_tier`, keeping its content, composition and style |
| `auto`              | Automatic   | Ideogram picks the model per request, and the choice may change over time                             |

For faces, labels and product shots that must stay true to the source, start with a faithful upscaler.

## Size and cost

* `upscale_factor` is `x2`, `x4` or `x8`; Wonder 4 offers `x2` and `x4`. Nano Banana Pro takes a `resolution_tier` instead.
* The `auto`, Standard V2, Text Refine, Wonder 3.5, Bloom 2 and Redefine endpoints reject a request whose output would be wider or taller than 8,192 pixels.
* Topaz upscalers bill per output megapixel: width × height ÷ 1,000,000. A 2048 × 2048 image upscaled 2x is 4096 × 4096 pixels, or 16.78 megapixels. Get the exact price with a [price quote](/v2/ideogram-api/price-quotes).

The user guide's [Upscale](https://docs.ideogram.ai/edit/upscale) page shows faithful and creative results side by side.