journeyapi.devDocs
API reference

Upscale an image

Render an image you already generated at full resolution.

POST/v1/images/upscale

Takes an image id from a finished job and returns the same image at full resolution. Faithful reproduces exactly what is there; enhanced reconstructs detail the original was too small to hold.

Body

image_idstringrequired
The image to upscale, from a succeeded job.
modestring
faithful (default) or enhanced.
scaleinteger
Output multiplier, 2 or 4. Defaults to 2.
prioritystring
standard (default) or batch. Batch costs a quarter and carries no concurrency guarantee.
webhook_urlstring
Overrides the account webhook for this job only.
metadataobject
Up to 16 key-value pairs echoed back on the job, for correlating with your own records.
Request
curl -X POST https://api.journeyapi.dev/v1/images/upscale \
  -H "Authorization: Bearer $JOURNEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "image_id": "img_01HQ8VZ4T2B7MC", "mode": "faithful", "scale": 2 }'
Response · 202 Accepted
{
  "id": "job_01HQ8VZB7T4NQ1",
  "object": "job",
  "type": "upscale",
  "status": "queued",
  "source_image_id": "img_01HQ8VZ4T2B7MC",
  "cost_usd": 0.02,
  "created_at": "2026-09-18T09:15:44Z"
}