APIMODELSAPIMODELS
Документация API

apimodels.app

Docs/Real-ESRGAN Upscaler API

Real-ESRGAN Upscaler API

Real-ESRGAN image upscaler — best for illustration, anime and hand-drawn / painted artwork: enlarge to 4x, 8K or 10K with crisp lines and clean flats. Image-to-image (an image, no prompt), with optional GFPGAN face enhancement. On real photos it only enlarges — it does not repair blur, damage or noise.

Authentication

Authorization: Bearer YOUR_API_KEY

Model & pricing

ModelmodelPriceNotes
Real-ESRGAN Upscalerreal-esrgan$0.005/imageImage upscaling, scale 1-10, optional face enhance

Code examples

# ─── Upscale an image (Real-ESRGAN) ───────────────────────
curl -X POST https://api.apimodels.app/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "real-esrgan",
    "image_url": "https://example.com/artwork.png",
    "scale": 4,
    "face_enhance": false
  }'

# Response (async — a task is created):
# { "code": 200, "msg": "success", "data": { "taskId": "clxxx", "state": "pending" } }


# ─── Poll for the upscaled result ─────────────────────────
curl "https://api.apimodels.app/v1/images/generations?task_id=TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"
# { "code": 200, "data": { "state": "completed", "resultUrls": ["https://r2.apimodels.app/..."] } }

Request parameters

FieldRequiredTypeDescription
modelYesstringreal-esrgan
image_urlYesstringURL of the image to upscale (publicly reachable). Or use image_base64 for a local image. No prompt needed.
image_base64NostringBase64/data-URI of a local image (alternative to image_url)
scaleNonumberUpscale factor 1-10 (default 4)
face_enhanceNobooleanEnable GFPGAN face enhancement (default false)
callback_urlNostringWebhook URL called when task completes

Notes

  • Image-to-image upscaling: pass one image + scale, no prompt
  • Best for illustration / anime / hand-drawn art; on real photos it only enlarges, it does not fix blur or noise
  • Flat $0.005/image (scale and face enhance included), charged only on success
  • Async: create a task to get a taskId, then poll GET ?task_id= for the result

Try it in the Playground

FAQ

How much does Real-ESRGAN upscaling cost?

Flat $0.005 per image, including any scale factor (1-10) and optional face enhancement. Charged only on success.

Does Real-ESRGAN work on real photos?

It only enlarges real photos — it does not repair blur, damage or noise. It shines on illustration, anime and hand-drawn artwork, where lines stay crisp and flats stay clean.