创建放大任务接口的四个参数逐一说明
接口形态
创建任务用 POST /api/task/,请求体是 JSON,四个参数:
curl -d '{"style": "art", "noise": "3", "x2": "1", "input": "图片地址"}' \
-H 'X-API-KEY: 你的密钥' \
<接口地址>/api/task/
参数明细
| 参数 | 类型 | 取值 | 对应界面选项 |
|---|---|---|---|
| style | 字符串 | art / photo | 卡通/插画、照片 |
| noise | 字符串 | -1 / 0 / 1 / 2 / 3 | 无、低、中、高、最高 |
| x2 | 字符串 | 1 / 2 / 3 / 4 | 2x、4x、8x、16x |
| input | 字符串 | 公网可访问的图片地址 | 你上传的那张图 |
注意三个细节:
- x2 不是倍数本身——
x2: "1"表示 2x,"4"表示 16x,是档位序号不是系数; - noise 是 -1 起步——「无降噪」是 -1 而不是 0,
0对应的是「低」; - 所有值都是字符串——官方示例里连噪声档都带引号,照抄字符串写法最稳。
与界面权限的联动
接口侧的档位与账户权限一致:8x(x2="3")与 16x(x2="4")需要付费权限,免费账户提交会被拒绝或回落,以实际返回为准。参数语义见放大倍数怎么选与降噪强度怎么调。
参数组合的正确性检查
提交前自查四项,减少白跑:
返回值里拿什么
任务创建成功后返回任务 ID(官方查询示例里的 tid 形态)。把这个 ID 存下来——后续查询、重试、结果下载全靠它,见查询放大结果。
批量场景的提交节奏:一次 POST 建一个任务,循环建多个;单接口调用没有「一次传一组图」的批量参数,批量靠调用侧编排,见API 接口全景。