🔎 Upscale Image
Upscale a photo 2x or 4x with a real AI model. Upload, pick a size, download.
About this tool
Upscale Image enlarges a photo with a real AI upscaling model (Remacri 4x) instead of plain interpolation, so edges and fine detail survive instead of turning to mush. Upload a JPG, PNG or WEBP, choose 2x or 4x and download the result; there is nothing else to set up, no cropping, no sliders and no colour grading. The AI pass runs first at 4x and the result is brought down to exactly the size you picked when you choose 2x, which keeps the recovered detail while staying predictable for web use. Pictures above 8 megapixels skip the GPU pass and are enlarged with a high quality Lanczos resize, and the page tells you which path your file took. Output is a clean file with AI provenance stripped and GenBox authorship in the metadata, ready to publish. Free, no signup, no watermark.
API
POST /api/tools/upscale-image/run (multipart/form-data) → JSON with
outputs[].url, a zip link and a config_url.
Fields: prompt (required), style
(photorealistic|anime|cartoon|digital-art),
lighting (natural|cinematic|studio|night, photorealistic only),
composition (portrait|landscape|macro|product),
aspect (1:1|9:16|16:9) and enhance (1 = AI rewrite in English).
curl -X POST https://genbox.eu/api/tools/upscale-image/run \\ -F 'prompt=cat on the table' \\ -F 'style=photorealistic' -F 'composition=product' \\ -F 'aspect=1:1' -F 'enhance=0'
For AI agents · API specs
Technical specs
| Category | cleanup |
|---|---|
| Slug | upscale-image |
| Run endpoint | POST /api/tools/upscale-image/run |
| Content type | multipart/form-data (with file uploads) or application/json |
| Response | JSON: job, notes, outputs[].url, zip, config_url |
| Rate limit | API: 1 request / minute / IP. Live preview and image renders have their own separate limits, plus a short global cooldown between renders (storm protection). Over a limit you get HTTP 429 + a Retry-After header (local requests are unlimited) |
| Machine-readable spec | GET /api/tools/upscale-image |
| OpenAPI 3.1 (Swagger) | this tool (JSON) · all tools |
Request body
Every parameter accepted by the run endpoint, in request-body order.
Fields are optional unless marked required. The same schema is published as
OpenAPI 3.1.
Upload files with multipart/form-data; a JSON body replays a saved config.
| Parameter | Type | Required | Default / allowed values | Description |
|---|---|---|---|---|
image |
file (list) | required | |
JPG, PNG or WEBP. Several files at once are fine. |
factor |
tags | no | x2 · x4 |
2x doubles the width and height, 4x quadruples them. The 4x AI pass runs either way; 2x is brought back down with the detail kept. |
Call it from an agent
GET /api/tools/upscale-image- machine-readable spec of this tool (inputs, category, API block).GET /api/tools- list of every tool plus the categories.POST /api/tools/upscale-image/run- run it. Acceptsmultipart/form-data(with files) or a rawapplication/jsonbody. Returns JSON withoutputs[].url,zipandconfig_url.- The
config_urlJSON is the request body - POST it back to replay the same generation.
# agent example curl -s https://genbox.eu/api/tools/upscale-image/run \\ -H 'Content-Type: application/json' \\ --data @genbox-config-upscale-image.json
Rate limits
- Max 1 request per minute per IP on the run endpoint.
- Over the limit you get HTTP 429 with
retry_after(seconds) - wait that long and retry. - Higher limits and API keys are coming soon: an API key will lift the per-IP throttle. Not available yet.