API Documentation

REST API v1 · Master plan required

Authentication

All API requests require a Bearer token in the Authorization header. Get your API key from your dashboard under Billing settings.

Authorization: Bearer YOUR_API_KEY

Base URL

https://api.imageupg.com/v1

Endpoints

Enhance image

Upload an image for AI enhancement. The API processes the image and returns a URL to the enhanced result.

Request body

Parameter	Type	Description
image	string	Base64-encoded image or URL to image
scale	integer	Upscale factor: 2, 4, or 8 (default: 2)
tier	string	Quality tier: fast, pro, ultra, super (default: auto by scale)
preset	string	AI model preset: auto, photo, art, anime, text, lowres (default: auto)
face_enhance	boolean	Enable face restoration with CodeFormer (default: false)

Example request

curl -X POST https://api.imageupg.com/v1/enhance \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://example.com/photo.jpg",
    "scale": 4,
    "tier": "pro",
    "preset": "photo",
    "face_enhance": true
  }'

Response

{
  "status": "succeeded",
  "output": "https://cdn.imageupg.com/result/abc123.png",
  "tier": "pro",
  "model_used": "topazlabs/image-upscale",
  "metrics": {
    "predict_time": 4.2
  }
}

Poll for result

For longer-running enhancements (Ultra, Super), poll for the result using the prediction ID.

{
  "action": "poll",
  "prediction_id": "abc123def456"
}

Vectorize (SVG)

{
  "action": "vectorize",
  "image_url": "https://example.com/logo.png"
}

Tiers & models

Tier	AI Engine	Speed	Best for
fast	PrunaAI	<1 sec	Thumbnails, quick previews
pro	Topaz Labs (5 models)	~5 sec	Photos, products, documents
ultra	Crystal + CodeFormer	~10 sec	Portraits, faces, high detail
super	Topaz + Crystal + CodeFormer	~15 sec	Maximum quality, print-ready

Rate limits

Master plan API access includes 1,000 requests per day. For higher volumes, contact us at api@imageupg.com

Error codes

Code	Description
400	Bad request — missing or invalid parameters
401	Unauthorized — invalid or missing API key
429	Rate limit exceeded
500	Server error — try again or contact support

SDKs & libraries

Official SDKs coming soon. In the meantime, use any HTTP client — the API accepts standard JSON requests.

Support

API support is available via api@imageupg.com or the Master plan Slack channel.