Sign in

Create an upscale job

Submit a file for upscaling. Accepts either:

  • JSON body with image_url (publicly accessible URL)
  • multipart/form-data with an image file field

One credit is deducted from your monthly quota.

post/jobs

Request body

image_urlstring uri

Publicly accessible URL of the image to upscale.

mime_typestring

Content type of the linked file. Only read on the image_url path.

model'flare' | 'prism' | 'lumen' | 'mirage' | 'motion' | 'motion-x'

What to upscale with.

  • flare: everyday photos, fastest and cheapest, up to 4x.
  • prism: text, logos and product shots. Adds no detail that was not in the original. Up to 4x.
  • lumen: maximum real detail recovery, for print. Up to 8x.
  • mirage: invents plausible new detail. Most dramatic, least faithful. Up to 8x.
  • motion: standard video upscale, up to 4x.
  • motion-x: cinema-grade video, slower and dearer, up to 4x.
scaleinteger

Upscaling factor. Rejected when it exceeds the chosen model's ceiling.

Example request

{
  "image_url": "https://example.com/photo.jpg",
  "model": "flare"
}

Response

Job created successfully.

idstring uuid required
status'pending' | 'uploading' | 'processing' | 'downloading' | 'completed' | 'failed' | 'canceled' required
model'flare' | 'prism' | 'lumen' | 'mirage' | 'motion' | 'motion-x' required

What to upscale with.

  • flare: everyday photos, fastest and cheapest, up to 4x.
  • prism: text, logos and product shots. Adds no detail that was not in the original. Up to 4x.
  • lumen: maximum real detail recovery, for print. Up to 8x.
  • mirage: invents plausible new detail. Most dramatic, least faithful. Up to 8x.
  • motion: standard video upscale, up to 4x.
  • motion-x: cinema-grade video, slower and dearer, up to 4x.
scaleinteger required
original_filenamestring nullable required
result_urlstring uri nullable required

Presigned URL to the upscaled file. Valid for 1 hour.

errorstring nullable required

Why the job failed. Null unless status is 'failed'.

frames_totalinteger nullable required

Video only. Frames the job has to process.

frames_doneinteger nullable required

Video only. Frames processed so far.

created_atstring date-time required
updated_atstring date-time required

Example response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "model": "flare",
  "scale": 4,
  "original_filename": "photo.jpg",
  "result_url": "https://cdn.upres.ai/results/abc123.png"
}