AI修图

接口描述

AI修图接口可以对输入图片进行智能美化处理，支持颜色调整、面部重塑、身体美型等多种修图能力。接口提供丰富的可调节参数，支持批量高效处理，能够实现百张照片同步修图，适用于图片直播、体育赛事、人像摄影等场景。

AI修图接口为异步接口，需要分步骤调用创建任务接口和查询结果接口，2个接口QPS均为2，具体使用方法如下：

步骤：

1、调用创建任务接口，根据图片和修图参数创建AI修图任务，获取task_id参数。

2、建议过15s后，轮询调用查询结果接口，根据task_id查询AI修图任务结果。

在线调试

您可以在 示例代码中心 调试该接口，可进行签名验证、在线查看请求内容和返回结果，并可自动生成示例代码。

请求说明

创建任务

HTTP 方法：POST

请求URL： https://aip.baidubce.com/rest/2.0/image-process/v1/retouching/create_task

请求参数

transform_options (变换选项) 参数结构

IColorParams（颜色调整）主要参数

其中lut的路径和名称对应如下：

AllHumanOptions (全图人体美化) 参数结构

PartialHumanOptions (人体部位美化) 参数结构

PartialTemplates 针对特定类型人群进行修图

• 相应人群修图结构体不存在时，取 PartialHumanOptions 中参数作为该人群默认值
• 相应人群修图结构体存在时，该人群所有修图参数以该结构体内部为准

以上结构体内部修图参数同 PartialHumanOptions

返回参数

请求示例

{
  "url": "https://example.com/image.jpg",
  "callback_data": "user_123",
  "IColorParams": {
    "ai_color": 1,
    "auto_exposure": 0.5,
    "auto_whitebalance": 0.5,
    "lut_id": "110041",
    "lut_value": 0.6
  },
  "PartialHumanOptions": {
    "remove_face_flaw": 0.8,
    "face_thin": 0.5,
    "eye_scale": 0.3,
    "face_smooth": 0.6,
    "skin_white": 0.4
  },
  "transform_options": {
    "auto_correct_angle": true
  }
}

返回示例

{
    "log_id": 1234567890,
    "result": {
        "task_id": "4df032d7c4df22cc494bfa23a5f98c7e"
    }
}

查询结果

HTTP 方法：post

请求URL： https://aip.baidubce.com/rest/2.0/image-process/v1/retouching/query_task

请求参数

返回参数

返回示例

{
    "log_id": 1234567890,
    "result": {
        "task_status": 1,
        "task_errcode": 0,
        "dlink": "https://example.com/result.jpg",
        "callback_data": "user_123"
    }
}