---
title: ToolRouter — Tool Detail
description: Detailed documentation for a ToolRouter tool including skills, parameters, and examples.
url: https://toolrouter.com/tools/image-upscale
---
# Image Upscale

Upscale images up to 10x resolution with multiple AI models. Choose the best model for the job — fast general-purpose upscaling, seamless tiling for patterns, professional-grade with face enhancement and text refinement, or cleanup and enhance. Process a single image or batch up to 10 in parallel.

- **Version:** 0.02
- **Categories:** media
- **Workflow:** upscale_image → batch_upscale → list_models → upscale_image

## Skills (3)

### Upscale Image (`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.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `image_url` | string | Yes | URL of the image to upscale. The tool server CAN fetch any public URL — always pass it. |
| `model` | string | No | Upscale model to use. Default: seedvr2. (seedvr2, seedvr2-seamless, topaz, chrono-edit) |
| `upscale_factor` | number | No | Scale factor (1-10 for SeedVR2, 1-4 for Topaz). Default 2x. Ignored if target_resolution is set. |
| `target_resolution` | string | No | Target resolution instead of scale factor. SeedVR2 models only. (720p, 1080p, 1440p, 2160p) |
| `output_format` | string | No | Output image format. Defaults to png. (png, jpeg, webp) |
| `noise_scale` | number | No | Noise control (0-1). SeedVR2 models only. |
| `seed` | number | No | Random seed for reproducible results. |
| `topaz_variant` | string | No | Topaz model variant. Only applies when model=topaz. Default: Standard V2. (Standard V2, Low Resolution V2, CGI, High Fidelity V2, Text Refine, Recovery, Recovery V2, Redefine, Standard MAX, Wonder) |
| `face_enhancement` | boolean | No | Enable face processing. Topaz only. Default: true. |
| `face_enhancement_strength` | number | No | Face enhancement intensity (0-1). Topaz only. Default: 0.8. |
| `sharpen` | number | No | Sharpening intensity (0-1). Topaz only. |
| `denoise` | number | No | Denoising intensity (0-1). Topaz only. |
| `fix_compression` | number | No | JPEG compression artifact removal (0-1). Topaz only. |
| `face_enhancement_creativity` | number | No | Face enhancement creativity (0-1). Topaz only. |
| `detail` | number | No | Detail recovery (0-1). Topaz Recovery V2 only. |
| `strength` | number | No | Enhancement strength (0.01-1). Topaz Text Refine only. |
| `creativity` | integer | No | Generative detail level (1-6). Topaz Redefine only. |
| `texture` | integer | No | Texture detail level (1-5). Topaz Redefine only. |
| `prompt` | string | No | Guidance text (max 1024 chars). Topaz Redefine only. |
| `autoprompt` | boolean | No | Auto-generate guidance prompt. Topaz Redefine only. |
| `subject_detection` | string | No | Focus area for enhancement. Topaz only. (All, Foreground, Background) |

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

**Examples:**

*Upscale an image 2x:*

```json
{
  "image_url": "https://placehold.co/400x300.png"
}
```

*Upscale to 4K resolution:*

```json
{
  "image_url": "https://placehold.co/400x300.png",
  "target_resolution": "2160p"
}
```

*Pro upscale with Topaz:*

```json
{
  "image_url": "https://placehold.co/400x300.png",
  "model": "topaz",
  "topaz_variant": "High Fidelity V2"
}
```

*Upscale a tileable texture:*

```json
{
  "image_url": "https://placehold.co/400x300.png",
  "model": "seedvr2-seamless",
  "upscale_factor": 4
}
```

### Batch Upscale (`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.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `images` | array | Yes | Array of images to upscale (max 10). Each item must have image_url, optionally model, upscale_factor, target_resolution. |
| `default_model` | string | No | Default model for all images unless overridden per-image. Default: seedvr2. (seedvr2, seedvr2-seamless, topaz, chrono-edit) |
| `default_upscale_factor` | number | No | Default scale factor for all images unless overridden. Default: 2. |
| `output_format` | string | No | Output image format. Defaults to png. (png, jpeg, webp) |

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

**Examples:**

*Batch upscale 3 images:*

```json
{
  "images": [
    {
      "image_url": "https://placehold.co/400x300.png"
    },
    {
      "image_url": "https://placehold.co/800x600.png"
    },
    {
      "image_url": "https://placehold.co/320x240.png"
    }
  ]
}
```

*Batch with mixed models:*

```json
{
  "images": [
    {
      "image_url": "https://placehold.co/400x300.png",
      "model": "topaz"
    },
    {
      "image_url": "https://placehold.co/800x600.png"
    }
  ],
  "default_upscale_factor": 4
}
```

### List Models (`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

**Examples:**

*List all upscale models:*

```json
{}
```

## Quick Start

```bash
# Via CLI
TOOLROUTER_API_KEY=tr_live_xxx npx -y toolrouter-mcp call image-upscale upscale_image --image_url https://placehold.co/400x300.png

# Via REST API
curl -H "Authorization: Bearer tr_live_xxx" \
     -d '{"tool":"image-upscale","skill":"upscale_image","input":{"image_url":"https://placehold.co/400x300.png"}}' \
     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.

---

## Get Started with ToolRouter

**Already connected?** Call any tool with `use_tool({ tool, skill, input })`. Browse tools with `discover` or visit https://toolrouter.com/llms-full.txt

**New to ToolRouter?** Connect with one command (no API key needed — auto-provisions on first use):

```bash
# MCP (Claude Code, Codex CLI)
claude mcp add toolrouter -- npx -y toolrouter-mcp

# MCP (Cursor, Windsurf, Cline, VS Code, Gemini CLI, Claude Desktop)
{"mcpServers":{"toolrouter":{"command":"npx","args":["-y","toolrouter-mcp"]}}}

# Claude Chat / Claude Cowork / Claude Mobile — add as a connector:
# Settings → Connectors → Add custom connector → URL: https://api.toolrouter.com/mcp

# ChatGPT — add as an app:
# Settings → Apps → Advanced settings → enable Developer mode → Create app → MCP Server URL: https://api.toolrouter.com/mcp

# CLI (works instantly, no restart needed)
npx -y toolrouter-mcp tools                    # browse all tools
npx -y toolrouter-mcp search "seo"             # search by keyword
npx -y toolrouter-mcp call seo analyze_page --url https://example.com
```

Free tools work immediately. For paid tools, visit https://toolrouter.com/claim to add credits.

All platforms: https://toolrouter.com/connect | Full catalog: https://toolrouter.com/llms-full.txt | Docs: https://toolrouter.com/docs