AI 图片 · 创建异步任务, 用于生成白底图.

一、接口名称

二、鉴权与签名

公共参数

三、业务参数

3.1 通用参数

3.2 图片入参规则

推荐在表单的 images 文本字段中提交以下 JSON 数组（不是整个请求改为 JSON body）：

[
  {"role": "product", "url": "https://example.com/tshirt.jpg"}, 
]

@Test
public void createWhiteBgTask() throws Exception {
    String apiUrl = "https://kf.fw199.com/gateway/ai/image/task/create"; 
    String sourceImageUrl =
            "https://gw.alicdn.com/imgextra/O1CN0195pSHaOCiVB2vH2e_!!890482188-0-picasso.jpg_.webp";
    // images 为 JSON 字符串，整体作为一个参数参与签名
    String images = "[{\"url\":\"" + sourceImageUrl + "\",\"role\":\"product\"}]";
    Map<String, String> data = new HashMap<>();
    data.put("appid", Config.AppId);
    data.put("timestamp", String.valueOf(System.currentTimeMillis() / 1000));
    data.put("task_type", "goods.white_bg");
    data.put("service_tier", "fast");   
    data.put("images", images);
    data.put("prompt", "");                // 白底图可为空，空字符串也参与签名
    data.put("callback_url", "http://fcpush.vs.fw199.com/pushorder");
    data.put("width", "1024");                // 0 或未传：输出尺寸跟商品原图
    data.put("height", "1024");
    data.put("sign", Utils.Sign(data, Config.AppSecret));
    String result = doHttpRequest(apiUrl, data);
    System.out.println("result:" + result);
}

提交任务返回结果

{
    "code": 0,
    "message": "ok",
    "data": {
        "task_id": "ait20260908133532829845",
        "client_task_id": "ait20260908133532829845",
        "task_type": "goods.white_bg",
        "status": "created",
        "duplicated": false
    },
    "trace_id": "e0e75b64-8fd3-4af1-afb9-b134de9db0a5"
}

四、异步任务回调

当图片处理任务完成以后, 蜂巢自动将处理完成的图片,回调给请求入参callback_url传入的网址.

异步任务http回调的内容

{
    "client_task_id": "ait20260908133532829845",
    "error_code": "",
    "error_msg": null,
    "output": {
        "images": [
            {
                "url": "https://static.fw199.com/fc/xxxxxxxxxxxxxxxxxxxxxxxxx.png"
            }
        ]
    },
    "status": "success",
    "task_id": "ait20260908133532829845",
    "task_type": "goods.white_bg"
}

本地模拟蜂巢http异步回调给您的网站Url(callback_url),

curl -i -X POST 'https://youdomain.com/api/fengchao/callback' \
  -H 'Content-Type: application/json' \
  -d '{
    "client_task_id": "ait20260908133532829845",
    "error_code": "",
    "error_msg": null,
    "output": {
      "images": [
        {
        "url": "https://static.fw199.com/fc/xxxxxxxxxxxxxxxxxxxxxxxxx.png"
        }
      ]
    }, 
    "status": "success",
    "task_id": "ait20260908133532829845",
    "task_type": "goods.white_bg"
  }'

五、效果展示

原图:

生成的白底图: