什么是图像放大 API，它如何工作？

它是一个 HTTP 端点，用训练好的模型提升图像分辨率。它不像普通缩放那样在已有像素之间插值，而是预测该图像在更高分辨率下应当包含的细节——边缘、纹理与结构——并把它们重建出来。您 POST 图像，然后从响应中读取放大后的结果。

支持哪些放大倍数和图像类型？

factor 参数接受 2 或 4，默认为 4。输入可以是最大 25 MB 的 JPEG（JPG）、PNG 和 WebP，输出可返回 jpeg（默认）或 png。

放大 API 是如何计费的？

费用随倍数而定：factor=2 为 2 积分，factor=4（默认值）为 4 积分。Starter 每月 400 积分、9.99 美元，Pro 每月 1,400 积分、29.99 美元，订阅期间未使用的积分可滚存。基于积分的计费意味着，用量大的月份和清闲的月份，单张图片的成本是一样的。

这个 API 也能提升画质、去模糊或修复老照片吗？

放大在放大的同时会重建细节，因此顺带让偏软的图像更清晰，而 sharpen 参数会进一步加强这一效果。对于受损或褪色的照片——划痕、撕裂、掉色——请改用照片修复 API，它是为修复而不是为分辨率设计的。

放大是同步的还是异步的？

同步。没有任务 ID 需要轮询，也没有 webhook 需要配置——放大后的图像就在同一个响应体中，每次请求有 60 秒上限。

放大后的图像可以用于商业用途吗？

可以。包括免费套餐在内的所有套餐都包含完整的商业使用权，且任何输出都不带水印。API 返回的任何内容，您都可以出售、打印或发布。

你们会存储我放大的图像吗？

不会。该 API 是无状态的：它不会创建项目、不会保存文件，也不会保留您的图像。您上传的文件会写入一个临时对象，处理完成后在响应返回的同时立即删除。唯一保留的是一条使用日志，记录发生过一次调用以及消耗了多少积分。您的图像绝不会用于训练模型。

2–4 积分每次调用

图像放大 API

从您自己的后端把图像分辨率提升 2 倍或 4 倍。可选人脸增强与锐化，输出 JPEG 或 PNG，价格随您所选的放大倍数而变。

REST · JSON
无水印
不存储任何内容

获取 API 密钥查看文档

endpoint

POST /v1/upscale-image

基础 URL: https://app.imggen.ai
认证: Authorization: Bearer sk_live_…
费用: 2–4 积分
输入: JPEG (JPG), PNG and WebP · max 25 MB

01 — 概览

什么是图像放大 API？

ImgGen AI 图像放大 API 是一个 REST 端点，它用 AI 而非简单插值来提升图像分辨率。它会重建边缘、纹理与细节，而不是拉伸像素，因此输出依然锐利。您发送一张图像和一个放大倍数，更高分辨率的结果会在同一个请求中返回。

这是 ImgGen AI 图像编辑 API 七个端点之一，它们共用同一个 API 密钥、同一个基础 URL，以及相同的请求与响应格式。如果您还需要在浏览器中而非通过代码使用该功能，同一套 AI 模型也驱动着 AI Image Upscaler 工具。

02 — 请求

请求参数

向 https://app.imggen.ai/v1/upscale-image 发送一个 POST 请求，并在 Authorization 请求头中使用 API 密钥进行认证。

此端点接受的参数
参数	类型	必填	默认值	说明
image	file	必填	—	放大倍数。接受 2 或 4。
factor	number	可选	4	额外执行人脸重建。适用于肖像和合影。
enhanceFace	boolean	可选	false	对放大后的结果额外锐化。
sharpen	boolean	可选	false	输出格式。接受 jpeg 或 png。
output	string	可选	jpeg	Output format. Accepts jpeg or png.

03 — 集成

如何集成图像放大 API？

在您的 ImgGen 账户中创建一个 API 密钥，将其设为环境变量，然后调用该端点。以下是同一个请求的 cURL、Node.js 与 Python 写法。

curl --request POST \
  --url 'https://app.imggen.ai/v1/upscale-image' \
  --header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
  --form image=@/path/to/photo.jpg \
  --form factor=4 \
  --form enhanceFace=false \
  --form sharpen=false \
  --form output=jpeg

import fs from 'node:fs';

const form = new FormData();
form.append('image', new Blob([fs.readFileSync('photo.jpg')]), 'photo.jpg');
form.append('factor', '4');
form.append('enhanceFace', 'false');
form.append('sharpen', 'false');
form.append('output', 'jpeg');

const res = await fetch('https://app.imggen.ai/v1/upscale-image', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.IMGGEN_API_KEY}` },
  body: form,
});

const data = await res.json();
// data.image is a base64-encoded PNG
fs.writeFileSync('result.png', Buffer.from(data.image, 'base64'));

import base64, os, requests

with open("photo.jpg", "rb") as f:
    res = requests.post(
        "https://app.imggen.ai/v1/upscale-image",
        headers={"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}"},
        files={"image": f},
    data={"factor": "4", "enhanceFace": "false", "sharpen": "false", "output": "jpeg"},
    )

data = res.json()
with open("result.png", "wb") as out:
    out.write(base64.b64decode(data["image"]))

04 — 响应

响应

成功的调用会返回 JSON。结果为 base64 编码——写入磁盘或对象存储前请先解码。每次成功的响应还会带上 X-Credit-Remaining 请求头，显示本次调用后的余额。

{
  "success": true,
  "message": "Image upscaled successfully",
  "image": "iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="
}

05 — 限制

值得了解的限制与行为

该端点接受 JPEG（JPG）、PNG 和 WebP，文件最大 25 MB，并在 60 秒内同步返回结果——无需轮询任务，也无需配置 webhook。

选择您的输出格式

需要无损结果或要保留 alpha 通道时设置 output=png；处理大批量商品目录时，jpeg 能让响应体积更小。

人脸增强需手动开启

enhanceFace 会额外执行人脸重建，用于增强并放大肖像。拍摄商品和风景时没有人脸可优化，请保持关闭。

Synchronous by design

There is no job queue to poll. The upscaled image comes back in the same response, within the 60-second request ceiling.

06 — 生产实践