Topaz Image Upscale API — Premium AI Image Upscaling

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

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

Pricing

Upscale Factor	Credits	Price (Pro Yearly)	Price (Pro Monthly)
1x (enhance only)	20	$0.12	$0.24
2x	20	$0.12	$0.24
4x	40	$0.24	$0.48
8x	80	$0.48	$0.96

Use "1" to apply Topaz AI enhancement (denoising, sharpening, detail recovery) without changing resolution. Credit tier is determined by upscale_factor, not input image dimensions. 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"`, `"4"`, or `"8"` (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": "4k"
    },
    "creditsUsed": 40,
    "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"`, `"4"`, or `"8"` (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 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`, `8`)
`PROBE_FAILED`	422	Could not read image dimensions from URL
`OUTPUT_TOO_LARGE`	422	Output would exceed 20,000px 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