Skip to navigation

Upscale

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.

EndpointKindWhat it does
topaz-standard-2FaithfulSharpens the whole image and stays close to it. No prompt
topaz-text-refineFaithfulKeeps large and small lettering sharp. No prompt
topaz-wonder-3-5Adds detailRebuilds detail, with enhancement_strength of low, medium or high
topaz-wonder-4Adds detailRemoves noise, blur and compression artifacts and recovers faces in one pass. 2x or 4x
topaz-bloom-2CreativeAdds new fine detail, guided by an optional prompt
topaz-redefineCreativeRedraws the most, guided by an optional prompt or autoprompt
nano-banana-proRegeneratesRegenerates the image at a 1K, 2K or 4K resolution_tier, keeping its content, composition and style
autoAutomaticIdeogram 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.

The user guide’s Upscale page shows faithful and creative results side by side.