iApp Image Upscaler

将图像放大 2 倍或 4 倍，输出最高 1680 万像素，重建边缘、纹理与文字而非模糊处理。

POST/v3/store/image-generation/image-upscaler/upscale试一试

价格1 IC每次请求
承载1,500 张/小时
累计调用11.1K次

v1.0.0-20260907
运行中

输入

file: product.jpg
scale: 4
output_format: png

输出POST /v3/store/image-generation/image-upscaler/upscale

status: success
model: photo
scale: 4
input: width: 800 height: 800
width: 3200
height: 3200
mime_type: image/png
bytes: 9871234
time: model: 0.61 total: 1.42
iapp: images: 1 version: 1.0.0-20260907

全部字段见“响应”一节

请求

curl -X POST https://api.iapp.co.th/v3/store/image-generation/image-upscaler/upscale \
  -H "apikey: YOUR_API_KEY" \
  -F "file=@product.jpg" \
  -F "scale=4" \
  -F "output_format=png"

响应

200成功。字段在"响应"一节说明。

{
  "status": "success",
  "model": "photo",
  "scale": 4,
  "input": { "width": 800, "height": 800 },
  "width": 3200,
  "height": 3200,
  "mime_type": "image/png",
  "bytes": 9871234,
  "image_base64": "iVBORw0KGgoAAAANSUhEUgAADIAAAAyACAIAAAB...",
  "time": { "model": 0.61, "total": 1.42 },
  "iapp": { "images": 1, "version": "1.0.0-20260907" }
}

请求

multipart/form-data，每次一张图像。无论尺寸和倍率，每张 1 IC；被拒绝或失败的请求不计费。

请求头

apikeystring必填

您的 API 密钥，在控制台的 API Keys 中创建。

请求体

filefile必填

图像：JPEG、PNG 或 WebP，最大 10 MB、1680 万像素；按 EXIF 方向旋转并保留透明度。已发送 image_base64 时无需此项。

image_base64string

Base64 图像，可带 data: 前缀，替代 file。

scaleinteger

4（默认）或 2。4 倍时输入最大 1024 × 1024；2 倍时最大 2048 × 2048。

modelstring

photo（默认）用于照片；anime 用于插画和平面作品；fast 用于吞吐量比细节更重要的场合。

output_formatstring

png（默认，无损）、jpeg 或 webp。4096 × 4096 的照片存为 PNG 约 10 至 20 MB，存为质量 92 的 JPEG 约 1 至 3 MB。

qualityinteger

jpeg 与 webp 的质量，1 至 100。默认 92。

responsestring

json（默认）返回面板中的对象，图像为 Base64；image 返回图像字节及对应的 Content-Type。

GET /v3/store/image-generation/image-upscaler/models 列出模型与限制，免费。

响应

所用的 model 与 scale、input 尺寸、输出的 width 与 height、mime_type、bytes、image_base64，以及 time：model 为放大耗时，total 另加解码上传与编码结果的时间。每个成功响应都带有 iapp-input-images: 1 与 x-iapp-output-size 头。

状态码

代码	`error_code`	含义
400	`invalid_image`	不是可读的 JPEG、PNG 或 WebP
400	`input_too_large`	输入超过 1680 万像素
400	`output_too_large`	输入 × 倍率会超过 1680 万像素；消息给出该倍率下的最大输入
400	`invalid_scale`、`invalid_model`、`invalid_output_format`	字段值超出上述范围
413	`file_too_large`	上传超过 10 MB
503	`starting`	服务正在启动；30 秒后重试

详情

实测

photo 模型与普通双三次缩放对比：iApp Image Generation 图库的 29 张 900 × 540 图像，每张缩小 4 倍再放大回原尺寸，2026 年 9 月 7 日。

指标	双三次	放大器
LPIPS 感知距离，越低越好	0.284	0.159
放大器更接近原图的图像数		29 / 29
PSNR，越高越好	27.2 dB	25.7 dB

LPIPS 衡量结果在人眼中与原图的接近程度；PSNR 奖励缩放产生的安全模糊，因此重建纹理总要付出一点 PSNR。

耗时，生产 GPU，5 次中位数	模型	PNG 编码	JPEG 编码
512 × 512 至 2048 × 2048	0.23 秒	0.34 秒	0.05 秒
1024 × 1024 至 4096 × 4096	0.98 秒	1.37 秒	0.18 秒
1920 × 1080 至 3840 × 2160	0.41 秒	0.61 秒	0.08 秒
2048 × 2048 至 4096 × 4096	0.78 秒	1.27 秒	0.18 秒

1024 × 1024 至 4096 × 4096 时，插画模型 0.32 秒，fast 模型 0.06 秒。一块 GPU 在最大输出下每小时约处理 1,500 张 PNG、约 3,000 张 JPEG；超出即排队。

限制

每个密钥的速率限制：每秒 5 次、每分钟 60 次、每小时 1,200 次。
源图中不存在的细节是生成的，不是恢复的：40 像素的人脸或小字会变清晰，但未必真实，因此输出不能作为低分辨率源图内容的证据。
源图的压缩和模糊会被清理；运动模糊和失焦区域仍然柔和。

数据处理

图像在内存中处理并随响应返回；不写入磁盘，不保留。模型运行在 iApp 位于泰国的自有 GPU 上，没有图像发送给第三方。依 PDPA 与 GDPR 取得同意并告知当事人，由作为数据控制者的您负责。

更新日志

版本	日期	变更
v1.0.0-20260907	2026 年 9 月 7 日	首次发布：photo、插画与 fast 模型的 2 倍和 4 倍放大，输出 PNG、JPEG 与 WebP，最高 1680 万像素并保留透明度，每张 1 IC。

请求​

响应​

详情​

请求

响应

详情