给开发者的放大接口全景与接入思路

官方对 API 的定位

官网 FAQ 里「有 API 吗」的回答是：有的！登录后在用户中心可以看到用法。 也就是说 API 是登录用户的内置能力，不需要单独申请资质，密钥从用户中心拿，见获取 API 密钥。

三段式工作流

官方接口文档把放大流程拆成三段，环环相扣：

段	接口路径	方法	干什么
一	/api/img_upload	POST	申请临时上传地址，把原图 PUT 上去
二	/api/task/	POST	提交放大任务（类型/倍数/降噪/图片地址）
三	/api/task/{任务ID}	GET	轮询任务状态，完成后取结果地址

外加一个补救接口：对失败任务用 POST 打 /api/task/{任务ID} 触发重试，见失败任务的 API 重试。

鉴权方式

所有请求通过 HTTP 头 X-API-KEY 携带密钥。官方示例里密钥出现的形态是 X-API-KEY: YOUR_API_KEY，实际值在登录后的用户中心复制。

和网页端的关系

参数完全同源——接口里的 style、noise、x2 与网页端配置面板一一对应，参数含义见创建任务的参数说明；
额度同一个池子——接口提交的任务消耗的是同一账户的放大额度（免费 20 张/月或套餐额度），API 不是免费的第二条通道；
限制同样生效——50MB/3000px（付费）等上传约束与网页端一致，见尺寸上限。

适合接入的三类场景

素材站/图库——几千张小图批量高清化，人工点网页不现实；
内容生产流水线——文章配图、商品图在发布环节自动放大；
内部工具集成——把放大能力挂进自己的脚本、机器人或内部平台。

动手前的建议顺序

先读上传原图理解第一段为什么存在（预签名上传），再看创建任务与查询结果，最后照着 Python 全流程示例跑通最小闭环。

相关阅读：获取 API 密钥、批量放大。