APIMODELSAPIMODELS
Docs/Real-ESRGAN Upscaler API

Real-ESRGAN Upscaler API

Real-ESRGAN 图片高清放大——最适合插画、二次元与手绘/绘画作品:放大到 4x、8K 乃至 10K,线条锐利、平涂干净。图生图(只传图,无 prompt),可选 GFPGAN 人脸增强。对真人照片只是放大,不修复模糊/破损/噪点。

认证

Authorization: Bearer YOUR_API_KEY

模型与价格

模型model价格说明
Real-ESRGAN Upscalerreal-esrgan$0.005/张图片放大,scale 1-10,可选人脸增强

代码示例

# ─── 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/..."] } }

请求参数

字段必填类型说明
model是stringreal-esrgan
image_url是string待放大的图片 URL(公网可访问)。也可用 image_base64 传本地图片。无需 prompt。
image_base64否string本地图片的 base64/data-URI(替代 image_url)
scale否number放大倍数 1-10(默认 4)
face_enhance否boolean是否开启 GFPGAN 人脸增强(默认 false)
callback_url否string任务完成后的回调 URL

说明

  • 图生图放大:传一张图 + scale,不需要 prompt
  • 最适合插画/二次元/手绘;对真人照片只放大、不修复模糊或噪点
  • 统一价 $0.005/张(含 scale 与人脸增强),失败不扣费
  • 异步任务:先建单拿 taskId,再轮询 GET ?task_id= 取结果

试一试:Playground

常见问题

Real-ESRGAN 放大多少钱?

固定 $0.005/张,含任意放大倍数(1-10)与人脸增强。仅成功扣费。

Real-ESRGAN 对真人照片有用吗?

对真人照片只是放大,不修复模糊/破损/噪点。强项是插画、二次元与手绘作品:线条锐利、平涂干净。