Batch Upscale Images via API

API Access and Authentication

The UpRes API requires the Business plan ($49/month) or unlimited. Other paid plans and a pay-as-you-go credit balance alone do not grant API access. With an eligible plan, generate an API key at Settings → API Keys.

All requests use Bearer token authentication. Include your key in the Authorization header:

curl -X POST https://api.upres.ai/v1/jobs \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flare",
    "image_url": "https://example.com/photo.jpg",
    "scale": 4
  }'

Model Selection for Batch Workflows

For batch pipelines where throughput matters, Flare is the best default. Each image uses one credit, so a batch of 500 images needs 500 credits; with 10 concurrent requests, throughput depends on queue load.

For premium output — hero images, product shots for large e-commerce displays, portrait work — swap to Lumen or Mirage on a subset of your batch.

Handling a Large Batch

The API supports up to 10 concurrent requests. For batches of 100+ images, use a queue with concurrency control. Here's a pattern in Node.js:

import pLimit from 'p-limit';

const limit = pLimit(10); // max 10 concurrent

const upscale = (imageUrl: string) =>
  fetch('https://api.upres.ai/v1/jobs', {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${process.env.UPRES_API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      model: 'flare',
      image_url: imageUrl,
      scale: 4,
    }),
  }).then((r) => r.json());

const results = await Promise.all(
  imageUrls.map((url) => limit(() => upscale(url)))
);

Poll long jobs

The public jobs API is poll-based. Submit with image_url, model, and scale, then read result_url when status is completed. Download that URL into your own storage before it expires.

{
  "image_url": "https://your-bucket.s3.amazonaws.com/photo.jpg",
  "model": "mirage",
  "scale": 8
}

Error Handling and Retries

The API returns standard HTTP status codes. On 429 Too Many Requests, back off and retry. On 5xx errors, retry up to 3 times with exponential backoff. The API is idempotent — submitting the same image URL twice will create two separate jobs.

Use Cases for Batch API

• ›E-commerce: nightly upscale of new product SKUs before listing
• ›Photo lab: automated restoration pipeline for customer-submitted scans
• ›Real estate: batch upscaling of property listing photos
• ›Publishing: resolution enhancement for print-quality output
• ›Stock photography: bulk enhancement before upload to stock platforms