Image Upscale — AI image upscaling up to 10x

Tools / Image Upscale

Upscale Image

Upscale a single image up to 10x resolution. Choose a model (SeedVR2 default, Topaz for pro, Seamless for tiles). Set a target resolution (720p-4K) or a scale factor.

Returns: Upscaled image URL, downloadable asset, model used, dimensions, and cost

Parameters

image_url *stringURL of the image to upscale. The tool server CAN fetch any public URL — always pass it.

modelstringUpscale model to use. Default: seedvr2.

upscale_factornumberScale factor (1-10 for SeedVR2, 1-4 for Topaz). Default 2x. Ignored if target_resolution is set.

target_resolutionstringTarget resolution instead of scale factor. SeedVR2 models only.

output_formatstringOutput image format. Defaults to png.

noise_scalenumberNoise control (0-1). SeedVR2 models only.

seednumberRandom seed for reproducible results.

topaz_variantstringTopaz model variant. Only applies when model=topaz. Default: Standard V2.

face_enhancementbooleanEnable face processing. Topaz only. Default: true.

face_enhancement_strengthnumberFace enhancement intensity (0-1). Topaz only. Default: 0.8.

sharpennumberSharpening intensity (0-1). Topaz only.

denoisenumberDenoising intensity (0-1). Topaz only.

fix_compressionnumberJPEG compression artifact removal (0-1). Topaz only.

face_enhancement_creativitynumberFace enhancement creativity (0-1). Topaz only.

detailnumberDetail recovery (0-1). Topaz Recovery V2 only.

strengthnumberEnhancement strength (0.01-1). Topaz Text Refine only.

creativityintegerGenerative detail level (1-6). Topaz Redefine only.

textureintegerTexture detail level (1-5). Topaz Redefine only.

promptstringGuidance text (max 1024 chars). Topaz Redefine only.

autopromptbooleanAuto-generate guidance prompt. Topaz Redefine only.

subject_detectionstringFocus area for enhancement. Topaz only.

Example

Upscale an image 2x

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "image-upscale",
  "skill": "upscale_image",
  "input": {
    "image_url": "https://placehold.co/400x300.png"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Batch Upscale

Upscale multiple images in parallel (up to 10). Apply the same settings to all or override per-image. Each image can use a different model and upscale factor.

Returns: Array of upscaled image URLs with assets, per-image status, and summary with total cost

Parameters

images *arrayArray of images to upscale (max 10). Each item must have image_url, optionally model, upscale_factor, target_resolution.

default_modelstringDefault model for all images unless overridden per-image. Default: seedvr2.

default_upscale_factornumberDefault scale factor for all images unless overridden. Default: 2.

output_formatstringOutput image format. Defaults to png.

Example

Batch upscale 3 images

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "image-upscale",
  "skill": "batch_upscale",
  "input": {
    "images": [
      {
        "image_url": "https://placehold.co/400x300.png"
      },
      {
        "image_url": "https://placehold.co/800x600.png"
      },
      {
        "image_url": "https://placehold.co/320x240.png"
      }
    ]
  }
}' \
  https://api.toolrouter.com/v1/tools/call

List Models

List all available image upscale models with key, pricing, max upscale factor, description, and variants.

Returns: All available upscale models with key, name, pricing, max factor, description, and variants

Example

List all upscale models

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "image-upscale",
  "skill": "list_models",
  "input": {}
}' \
  https://api.toolrouter.com/v1/tools/call

Quick Start

MCP (Claude Code)

claude mcp add --transport stdio \
  --env TOOLROUTER_API_KEY=YOUR_API_KEY \
  toolrouter -- npx -y toolrouter-mcp

REST API

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{"tool":"image-upscale","skill":"upscale_image","input":{}}' \
  https://api.toolrouter.com/v1/tools/call

Frequently Asked Questions

Can it upscale a single image to 4K or 10x?

Yes. `upscale_image` can upscale a single image up to 10x or target a resolution like 1080p, 2K, or 4K.

Can I process several images at once?

`batch_upscale` handles up to 10 images in parallel and lets each image use its own settings when needed.

How do I choose a model?

`list_models` shows the available upscalers so you can pick the best one for general images, seamless patterns, or pro-grade detail recovery.

Is it useful for faces, text, or noisy scans?

Yes. The tool is designed for clean enlargement and includes options suited to face enhancement, text refinement, and cleanup before export.