无损放大

免费体验

将照片或卡通插画放大至 2 倍、4 倍、8 倍或 16 倍，支持选择模型风格和降噪强度。

接口返回的结果图片链接一般有效期为 1 小时，请及时下载存储。

鉴权

每个 API 请求都必须在请求头中携带你的 API Key。请按当前文档中的请求方式和参数说明，将其作为 X-API-KEY 请求头传入。

X-API-KEY: YOUR_API_KEY

创建无损放大任务

POST /api/tasks/visual/advanced-scale

请求参数

image_url string 可选

图片下载地址。与 image_file 至少提供一个；同时传入时优先使用 image_file。支持 HTTP 和 OSS 协议，最长 512 个字符，下载超时 20 秒。

二选一必填

image_file file 可选

图片文件（二进制）。与 image_url 至少提供一个；同时传入时优先使用 image_file。以服务端接收到的图片为准，大小不超过 50MB（含 50MB）。

图片上传要求请参看使用规范与限制#6。

scale_factor string 可选

放大倍数。传入的是选项值，并非实际倍数。

1：2x（默认）
2：4x
3：8x
4：16x

style string 可选

模型风格选择。

photo：照片（默认）
art：卡通插画

noise string 可选

降噪强度。

-1：无（默认）
0：低
1：中
2：高
3：最高

output_format string 可选

输出图片格式。可传 jpg、png 或空值。

返回参数

status integer

HTTP 响应状态码：200 表示请求成功，非 200 表示请求失败。详见状态码说明。

message string

接口返回的信息说明。处理失败时可参考此字段，或携带错误信息和 task_id 联系商务或技术支持。

data.task_id string

无损放大任务 ID，用于查询处理结果。处理失败时请携带此参数联系支持人员。

查询无损放大结果

异步请求建议每 1 秒 轮询一次结果，本接口最大轮询时长为 600 秒；累计轮询超过该时长仍未返回结果，即可视为超时失败。

GET /api/tasks/visual/advanced-scale/{task_id}

路径参数

task_id string 必填

创建无损放大任务后返回的任务 ID。

返回参数

status integer

HTTP 响应状态码：200 表示请求成功，非 200 表示请求失败。详见状态码说明。

message string

接口返回的信息说明。处理失败时可参考此字段，或携带错误信息和 task_id 联系商务或技术支持。

data.task_id string

无损放大任务 ID，用于查询处理结果。处理失败时请携带此参数联系支持人员。

data.image string

无损放大结果图片下载地址或 base64 数据；结果链接一般有效期为 1 小时。

data.created_at integer

任务创建时间戳。

data.processed_at integer

任务开始处理时间戳。

data.completed_at integer

任务完成时间戳。

data.progress integer

任务处理进度，取值范围 0～100。100 表示处理完成，小于 100 表示正在处理中；最终结果请结合 data.state 判断。

data.state integer

任务状态码，详见状态码说明。

1：处理成功；
> 1：处理中；
< 0：失败。

data.state_detail string

任务状态详情。

data.time_elapsed string

任务处理耗时。

data.return_type integer

结果返回方式。

data.cost number

接口返回的费用值。

data.use_point integer

本次任务消耗的算粒。每次成功调用消耗 3 算粒。

使用规范与限制

接口返回的结果图片链接一般有效期为 1 小时，请及时下载存储。
HTTP status 为 200 仅表示 HTTP 请求成功；data.state = 1 才表示无损放大成功，data.state < 0 表示失败。成功或失败后均应终止轮询。
URL 作为参数传递时，请遵守 URL 编码规范，避免参数解析异常。
通常在 1～2 分钟内完成，耗时受图片大小影响，最长不超过 10 分钟。
默认 QPS 为 2；如需提高限制，请联系商务。每次成功调用消耗 3 算粒。
上传图片需符合以下格式和大小限制。

格式大小

jpg, jpeg, bmp, png, webp 不超过 50MB（含 50MB）

格式	大小
jpg, jpeg, bmp, png, webp	不超过 50MB（含 50MB）

响应

{
  "status": 200,
  "data": {
    "task_id": "7b63df59-76cc-4035-9f94-01b720ea5665",
    "completed_at": 1789541563,
    "cost": 0,
    "created_at": 1789541552,
    "image": "oss://oss-cn-shenzhen.aliyuncs.com/wxtechdev/pub/tasks/output/visual_external_scale/7b63df59-76cc-4035-9f94-01b720ea5665-image1.png",
    "processed_at": 1789541552,
    "progress": 100,
    "return_type": 2,
    "state": 1,
    "state_detail": "Complete",
    "use_point": 3
  }
}