bigjpg 中文文档 下载 App

创建放大任务接口的四个参数逐一说明

接口形态

创建任务用 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 / 42x、4x、8x、16x
input字符串公网可访问的图片地址你上传的那张图

注意三个细节:

与界面权限的联动

接口侧的档位与账户权限一致:8x(x2="3")与 16x(x2="4")需要付费权限,免费账户提交会被拒绝或回落,以实际返回为准。参数语义见放大倍数怎么选与降噪强度怎么调。

参数组合的正确性检查

提交前自查四项,减少白跑:

  1. input 地址公网可达(上传接口返回的地址天然满足);
  2. style 与图片实际类型一致(选错路径效果打折,见卡通还是照片);
  3. noise 与源图噪点水平匹配(见参数速查表);
  4. x2 在你的权限范围内。

返回值里拿什么

任务创建成功后返回任务 ID(官方查询示例里的 tid 形态)。把这个 ID 存下来——后续查询、重试、结果下载全靠它,见查询放大结果。

批量场景的提交节奏:一次 POST 建一个任务,循环建多个;单接口调用没有「一次传一组图」的批量参数,批量靠调用侧编排,见API 接口全景。

相关阅读:上传原图、获取密钥。