Topaz Image Upscale API — Premium AI Image Upscaling

Premium AI image upscaling with Topaz through VicSee API. Upscale images up to 4x with automatic dimension detection and output validation. 20–80 credits per image, tiered by output size.

New: Topaz image upscale is available via a dedicated tool endpoint for the simplest integration, or via the unified /v1/generate endpoint.

Pricing

Credits are tiered by output size — your input image's megapixels multiplied by the upscale factor squared:

Output Size	Credits	Price (Pro Yearly)	Price (Pro Monthly)
≤ 24 MP	20	$0.12	$0.24
≤ 48 MP	40	$0.24	$0.48
≤ 96 MP	80	$0.48	$0.96

Outputs above 96 MP are rejected — use a smaller factor or source image.

Worked examples:

A 1024×1024 image (1 MP) at 2x → 4 MP output → 20 credits
A 2048×2048 image (4 MP) at 2x → 16 MP output → 20 credits
A 2048×2048 image (4 MP) at 4x → 67 MP output → 80 credits
A 1024×1024 image (1 MP) at 4x → 16 MP output → 20 credits

Most AI-generated images (1–4 MP) cost 20 credits at 2x. Use "1" to apply Topaz AI enhancement (denoising, sharpening, detail recovery) without changing resolution. The response includes detected_dimensions and output_tier so you can verify what was billed. Credits are deducted upfront and refunded automatically if the upscale fails.

Tool Endpoint (Recommended)

Dedicated endpoint with automatic dimension detection and output validation.

POST https://vicsee.com/api/v1/tools/upscale-image

See Authentication for API key setup.

Parameters

Parameter	Type	Required	Description
image_url	string	Yes	URL of the image to upscale (JPEG, PNG, or WebP)
upscale_factor	string	No	`"1"`, `"2"`, or `"4"` (default: `"2"`)

Use "1" for AI enhancement without changing resolution. The endpoint auto-detects image dimensions and validates that the output won't exceed 20,000 pixels on the longest side.

Example Request

curl -X POST https://vicsee.com/api/v1/tools/upscale-image \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/photo.jpg",
    "upscale_factor": "4"
  }'

Response

{
  "success": true,
  "data": {
    "id": "task_abc123",
    "model": "topaz-image-upscale",
    "status": "pending",
    "input": {
      "image_url": "https://example.com/photo.jpg",
      "upscale_factor": "4",
      "detected_dimensions": "1280×720",
      "output_tier": "24mp"
    },
    "creditsUsed": 20,
    "creditsRemaining": 960,
    "createdAt": "2026-02-14T12:00:00.000Z"
  }
}

The response includes detected_dimensions and output_tier so you can verify what was billed.

Poll for completion using Tasks API. Typical processing time: 30–60 seconds.

Unified Endpoint

You can also use the unified /v1/generate endpoint if you prefer a single endpoint for all models.

POST https://vicsee.com/api/v1/generate

Parameters

Parameter	Type	Required	Description
model	string	Yes	`topaz-image-upscale`
input.image_url	string	Yes	URL of the image to upscale
input.upscale_factor	string	No	`"1"`, `"2"`, or `"4"` (default: `"2"`)

Example Request

curl -X POST https://vicsee.com/api/v1/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "topaz-image-upscale",
    "input": {
      "image_url": "https://example.com/photo.jpg",
      "upscale_factor": "4"
    }
  }'

Response

{
  "success": true,
  "data": {
    "id": "task_abc123",
    "model": "topaz-image-upscale",
    "status": "pending",
    "creditsUsed": 40,
    "creditsRemaining": 960,
    "createdAt": "2026-02-14T12:00:00.000Z"
  }
}

Poll for completion using Tasks API.

Limits

Constraint	Value
Max output size	96 megapixels (input MP × factor²)
Max output pixels	20,000px on longest side
Supported formats	JPEG, PNG, WebP
Image URL	Must be publicly accessible

Errors

Code	HTTP	Description
`MISSING_IMAGE_URL`	400	`image_url` not provided
`INVALID_UPSCALE_FACTOR`	400	Factor not in allowed values (`1`, `2`, `4`). 8x is no longer supported
`PROBE_FAILED`	422	Could not read image dimensions from URL
`OUTPUT_TOO_LARGE`	422	Output would exceed 96 MP or the 20,000px longest-side limit
`INSUFFICIENT_CREDITS`	402	Not enough credits for this operation

Video Upscale — Premium video upscaling with per-second billing
Nano Banana — Budget image upscaling (3 credits, 2x/4x)
Tasks API — Poll task status and retrieve results

Image Upscale

On this page