AI修图
更新时间:2026-05-22
接口描述
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
请求参数
| 参数 | 是否必选 | 类型 | 可选值范围 | 说明 |
|---|---|---|---|---|
| image | 和url二选一 | string | - | 图像数据,base64编码,支持jpg/jpeg/png/bmp格式,大小不超过50M |
| url | 和image二选一 | string | - | 图片下载链接,不限制大小 |
| callback_data | 否 | string | - | 回调透传参数 |
| IColorParams | 否 | struct | - | 颜色调整参数,JSON字符串 |
| AllHumanOptions | 否 | struct | - | 全图人体美化参数,JSON字符串 |
| PartialHumanOptions | 否 | struct | - | 人体部位美化参数,JSON字符串 |
| PartialTemplates | 否 | struct | - | 针对特定类型人群修图参数,JSON字符串 |
| transform_options | 否 | struct | - | 变换选项,JSON字符串 |
transform_options (变换选项) 参数结构
| 美化类型 | 功能 | 功能名 | 参数类型 | 取值范围 | 取值说明 |
|---|---|---|---|---|---|
| 图片分组 | 图片自动矫正 | auto_correct_angle | bool | true/false | 值为true时将图片旋转到构图不歪斜的角度 |
| 图片压缩 | 结果图大小压缩 | size_compress | bool | true/false | 值为true时将结果图压缩至 50M 以内 |
IColorParams(颜色调整)主要参数
| 美化类型 | 功能 | 功能名 | 参数类型 | 取值范围 | 取值说明 |
|---|---|---|---|---|---|
| 滤镜 | LUT滤镜 | lut_value | float | [0,1] | 滤镜程度值 |
| 滤镜 | LUT滤镜 | lut_id | string | 枚举值 | 参见下方表格,lut_id 与名称对应表 |
| 白平衡 | 色温 | temperature | float | [-1,1] | 数值越大,效果越强 |
| 白平衡 | 色调 | tint | float | [-1,1] | 数值越大,效果越强 |
| 基本调整 | 曝光 | exposure | float | [-1,1] | 数值越大,效果越强 |
| 基本调整 | 对比度 | contrast | float | [-1,1] | 数值越大,效果越强 |
| 基本调整 | 亮度 | brightness | float | [-1,1] | 数值越大,效果越强 |
| 基本调整 | 自然饱和度 | vibrance | float | [-1,1] | 数值越大,效果越强 |
| 基本调整 | 饱和度 | saturation | float | [-1,1] | 数值越大,效果越强 |
| 高动态范围 | 高光 | highlight | float | [-1,1] | 数值越大,效果越强 |
| 高动态范围 | 阴影 | shadow | float | [-1,1] | 数值越大,效果越强 |
| 高动态范围 | 白色 | white | float | [-1,1] | 数值越大,效果越强 |
| 高动态范围 | 黑色 | black | float | [-1,1] | 数值越大,效果越强 |
| 细节 | 数量 | sharpen_amount | float | [0,1] | 数值越大,细节越明显。注意:组内 2 个参数需一起使用,缺少任意项均无效 |
| 细节 | 半径 | sharpen_radius | float | [0,1] | 数值越大,细节越明显。注意:组内 2 个参数需一起使用,缺少任意项均无效 |
| HSL | 结构体数组,内部参数定义见下方 | hsl_params | array | [{"hsl_gamut": 0, "hsl_hue": 0.5, "hsl_saturation": 0, "hsl_brightness": 0}, {"hsl_gamut": 1, "hsl_hue": 0.6, "hsl_saturation": 0, "hsl_brightness": 0}] |
HSL 参数数组 |
| HSL | 色域 | hsl_gamut | int | {0,1,2,3,4,5,6,7} | 色域选择,对应红、橙、黄、绿、青、蓝、紫、洋红 |
| HSL | 色相 | hsl_hue | float | [-1,1] | 数值越大,效果越强 |
| HSL | 饱和度 | hsl_saturation | float | [-1,1] | 数值越大,效果越强 |
| HSL | 明度 | hsl_brightness | float | [-1,1] | 数值越大,效果越强 |
| AI调色 | 总开关 | ai_color | int | 0/1 | 注意:当 ai_color 为 0 时,智能曝光、智能白平衡的值不生效 |
| AI调色 | 智能曝光 | auto_exposure | float | [0,1] | 示例:ai_color: 1, auto_exposure: 0.3。数值越大,效果越强 |
| AI调色 | 智能白平衡 | auto_whitebalance | float | [0,1] | 示例:ai_color: 1, auto_whitebalance: 0.3。数值越大,效果越强 |
| 背景增强 | 背景增强 | bg_enhance | float | [0,1] | 数值越大,效果越强 |
| 去薄雾 | 去薄雾 | remove_fog | float | [0,1] | 数值越大,效果越强(画面越鲜艳、清晰、锐利) |
其中lut的路径和名称对应如下:
| 路径图片名称 | 滤镜名字 | 路径图片名称 | 滤镜名字 | 路径图片名称 | 滤镜名字 |
|---|---|---|---|---|---|
| huiyi | 回忆 | shaonv | 少女 | hongrun | 红润 |
| dushi | 都市 | weiguang | 微光 | hongchun | 红唇 |
| andiao | 暗调 | beautySkin | 自然 | baixi | 白皙 |
| baicha | 白茶 | caomei | 草莓 | chaobai | 超白 |
| haijiao | 海礁 | hutao | 胡桃 | jvziqishui | 爱橘 |
| riguang | 日光 | weilan | 蔚蓝 | yejing | 夜景 |
| yangqi | 氧气 | qingkong | 青空 | roumei | 柔美 |
| qingshe | 轻奢 | yuanlin | 淡雅 | hanxi | 薄荷 |
| gudian | 古典 | jiaopian | 硬调2 | senxi | 粉白 |
| menghuan | 梦幻 | yingshi | 废土 | huaijiu | 复古 |
| zhongshi | 和煦2 | zazhi | 西部 | yingdiao | 高级感 |
| qingtou | 亮白 | qingliang | 清亮 | yinglang | 深林 |
| zuojiu | 暖阳 | huidiao | 夏威夷 | yingdiao2 | 清冷 |
| modeng | 时尚 | 110041 | 清透 | 110042 | 荔枝 |
| 110043 | 柔灰 | 110044 | 柔灰2 | 110045 | 轻盈 |
| 110046 | 中灰 | 110047 | 真实 | 110048 | 清晰 |
| 110049 | 悠远 | 110050 | 温暖 | 110051 | 中调 |
| 110052 | 硬冷 | 110053 | 漫画 | 110054 | 阳光 |
| 110055 | 蓝调 | 110056 | 晴朗 | 110057 | 清晨 |
| 110058 | 经典 | 110059 | 经典2 | 110060 | 奈格 |
| 110061 | 暗调 | 110062 | 灰调 | 110063 | 硬调 |
| 110064 | 冷调 | 110065 | 冷调2 | 110066 | 和煦 |
| 110067 | 素雅 | 110068 | 暗雅 | 110069 | 老片 |
| 110070 | 荒原 | 110071 | 落日 | 110072 | 纪实 |
| 110073 | 青橙 | 110074 | 怀旧 | 110075 | 梦核 |
| 110076 | 红梦 | 110077 | 溢出 | 110078 | 冷光 |
| 110079 | 软糖 | 110080 | 硬糖 | 110081 | 黑金 |
| 110082 | 摩登 | 110083 | 街头 | 110084 | 街头2 |
| 110085 | 霓虹 | 110086 | 霓虹2 | 110087 | 黑白 |
| 110088 | 旧照 | 110089 | 高级 | 110090 | 海滩 |
| 110091 | 礁石 | 110092 | 银海 | 110093 | 余辉 |
| 110094 | 雾海 | 110095 | 高原湖 | 110096 | 古城 |
| 110097 | 硬闪 | 110098 | 羌塘 | 110099 | 泛舟 |
| 110100 | 苗族白 | 110101 | 布达拉 | 110102 | 簪花 |
| 110103 | 沙漠 | 110104 | 清月夜 | 110105 | 光之海 |
| 110106 | 漫步 | 110107 | 碣石 | 110108 | 翠蓝卷 |
AllHumanOptions (全图人体美化) 参数结构
| 美化类型 | 功能 | 子功能 | 功能名 | 参数类型 | 取值范围 | 取值说明 |
|---|---|---|---|---|---|---|
| 全图身体美型 | 长腿 | - | leg_long | float | [0,1] | 数值越大,腿越长(全图生效) |
| 全图身体美型 | 增高 | - | body_heighten | float | [0,1] | 数值越大,上身越高(全图生效) |
| 全图皮肤调整 | 多人肤色统一 | - | all_skin_color_same | float | [0,1] | 数值越大,全体肤色越均匀(全图生效) |
| 背景美化 | 背景去瑕疵 | 纯色背景 | remove_pure_bg_flaw | float | [0,1] | 数值越大,祛瑕疵越干净 |
| 背景美化 | 背景去瑕疵 | 非纯色背景 | remove_bg_flaw | float | [0,1] | 数值越大,祛瑕疵越干净 |
PartialHumanOptions (人体部位美化) 参数结构
| 美化类型 | 分组 | 功能 | 子功能 | 功能名 | 参数类型 | 取值范围 | 取值说明 |
|---|---|---|---|---|---|---|---|
| 祛除瑕疵 | - | 祛瑕疵-脸部 | - | remove_face_flaw | float | [0,1] | 数值越大,祛瑕疵越干净 |
| 祛除瑕疵 | - | 祛瑕疵-身体 | - | remove_body_flaw | float | [0,1] | 数值越大,祛瑕疵越干净 |
| 祛除瑕疵 | - | 祛颈纹 | - | remove_neck_wrinkles | float | [0,1] | 数值越大,祛颈纹越干净 |
| 祛除瑕疵 | - | 祛双下巴 | - | remove_double_chin | float | [0,1] | 数值越大,祛双下巴越干净 |
| 祛除瑕疵 | - | 祛唇纹 | - | remove_lip_wrinkles | float | [0,1] | 数值越大,唇纹越淡 |
| 祛除瑕疵 | - | 祛法令纹 | - | remove_laugh_line | float | [0,1] | 数值越大,法令纹越淡 |
| 祛除瑕疵 | - | 祛黑眼圈 | - | remove_dark_circles | float | [0,1] | 数值越大,黑眼圈越淡 |
| 祛除瑕疵 | - | 祛眼周纹 | - | remove_eye_around_wrinkles | float | [0,1] | 数值越大,眼周纹越淡 |
| 祛除瑕疵 | - | 祛抬头纹 | - | remove_forehead_wrinkles | float | [0,1] | 数值越大,抬头纹越淡 |
| 祛除瑕疵 | - | 祛油光-脸部 | - | remove_face_glossy | float | [0,1] | 数值越大,油光越淡 |
| 祛除瑕疵 | - | 祛痣-脸部 | - | remove_face_moles | int | 0 or 1 | 0 关 1 开,祛除脸部痣 |
| 祛除瑕疵 | - | 祛副乳 | - | remove_polymastia | int | 0 or 1 | 0 关 1 开,祛除副乳 |
| 祛除瑕疵 | - | 祛妊娠线 | - | remove_stretch_mark | float | [0,1] | 数值越大,妊娠线越淡 |
| 面部重塑 | 脸型 | 小脸 | - | face_small | float | [-1,1] | 数值越大,脸越小 |
| 面部重塑 | 脸型 | 瘦脸 | - | face_thin | float | [-1,1] | 数值越大,脸越瘦 |
| 面部重塑 | 脸型 | V脸 | - | face_v | float | [-1,1] | 数值越大,脸越尖 |
| 面部重塑 | 脸型 | 下颌 | 两侧 | jaw_width | float | [-1,1] | 数值越大,双下颌越瘦 |
| 面部重塑 | 脸型 | 下颌 | 左下颌 | jaw_width_left | float | [-1,1] | 数值越大,左下颌越瘦 |
| 面部重塑 | 脸型 | 下颌 | 右下颌 | jaw_width_right | float | [-1,1] | 数值越大,右下颌越瘦 |
| 面部重塑 | 脸型 | 颧骨 | 两侧 | cheekbone_width | float | [-1,1] | 数值越大,双颧骨越凹陷 |
| 面部重塑 | 脸型 | 颧骨 | 左颧骨 | cheekbone_width_left | float | [-1,1] | 数值越大,左颧骨越凹陷 |
| 面部重塑 | 脸型 | 颧骨 | 右颧骨 | cheekbone_width_right | float | [-1,1] | 数值越大,右颧骨越凹陷 |
| 面部重塑 | 脸型 | 脸宽 | - | face_width | float | [-1,1] | 数值越大,脸越宽 |
| 面部重塑 | 脸型 | 额头 | - | forehead_height | float | [-1,1] | 数值越大,额头越高 |
| 面部重塑 | 脸型 | 下巴长短 | - | chin_height | float | [-1,1] | 数值越大,下巴越长 |
| 面部重塑 | 脸型 | 面部对称 | - | face_symmetry | float | [0,1] | 数值越大,面部越对称 |
| 面部重塑 | 眉毛 | 粗细 | - | eyebrow_thickness | float | [-1,1] | 数值越大,眉毛越粗 |
| 面部重塑 | 眉毛 | 眉距 | - | eyebrow_distance | float | [-1,1] | 数值越大,眉间距越大 |
| 面部重塑 | 眉毛 | 位置 | - | eyebrow_height | float | [-1,1] | 数值越大,眉毛越高 |
| 面部重塑 | 眼睛 | 大小 | 双眼 | eye_scale | float | [-1,1] | 数值越大,双眼越大 |
| 面部重塑 | 眼睛 | 大小 | 左眼 | eye_scale_left | float | [-1,1] | 数值越大,左眼越大 |
| 面部重塑 | 眼睛 | 大小 | 右眼 | eye_scale_right | float | [-1,1] | 数值越大,右眼越大 |
| 面部重塑 | 眼睛 | 高度 | 双眼 | eye_height | float | [-1,1] | 数值越大,双眼越高 |
| 面部重塑 | 眼睛 | 高度 | 左眼 | eye_height_left | float | [-1,1] | 数值越大,左眼越高 |
| 面部重塑 | 眼睛 | 高度 | 右眼 | eye_height_right | float | [-1,1] | 数值越大,右眼越高 |
| 面部重塑 | 眼睛 | 宽度 | 双眼 | eye_width | float | [-1,1] | 数值越大,双眼越宽 |
| 面部重塑 | 眼睛 | 宽度 | 左眼 | eye_width_left | float | [-1,1] | 数值越大,左眼越宽 |
| 面部重塑 | 眼睛 | 宽度 | 右眼 | eye_width_right | float | [-1,1] | 数值越大,右眼越宽 |
| 面部重塑 | 眼睛 | 距离 | 双眼 | eye_distance | float | [-1,1] | 数值越大,双眼距越大 |
| 面部重塑 | 眼睛 | 距离 | 左眼 | eye_distance_left | float | [-1,1] | 数值越大,左眼越靠外 |
| 面部重塑 | 眼睛 | 距离 | 右眼 | eye_distance_right | float | [-1,1] | 数值越大,右眼越靠外 |
| 面部重塑 | 眼睛 | 倾斜 | 双眼 | eye_angle | float | [-1,1] | 数值越大,双眼角越上翘 |
| 面部重塑 | 眼睛 | 倾斜 | 左眼 | eye_angle_left | float | [-1,1] | 数值越大,左眼角越上翘 |
| 面部重塑 | 眼睛 | 倾斜 | 右眼 | eye_angle_right | float | [-1,1] | 数值越大,右眼角越上翘 |
| 面部重塑 | 眼睛 | 位置 | 双眼 | eye_position | float | [-1,1] | 数值越大,双眼越高 |
| 面部重塑 | 眼睛 | 位置 | 左眼 | eye_position_left | float | [-1,1] | 数值越大,左眼越高 |
| 面部重塑 | 眼睛 | 位置 | 右眼 | eye_position_right | float | [-1,1] | 数值越大,右眼越高 |
| 面部重塑 | 眼睛 | 双眼对称 | - | eye_scale_same | bool | true/false | 修复左右大小眼 |
| 面部重塑 | 鼻子 | 大小 | - | nose_scale | float | [-1,1] | 数值越大,鼻子越大 |
| 面部重塑 | 鼻子 | 鼻高 | - | nose_height | float | [-1,1] | 数值越大,鼻子越高 |
| 面部重塑 | 鼻子 | 鼻梁 | - | nose_bridge | float | [-1,1] | 数值越大,鼻梁越高 |
| 面部重塑 | 鼻子 | 鼻翼 | - | nose_wing | float | [-1,1] | 数值越大,鼻翼越大 |
| 面部重塑 | 鼻子 | 鼻尖 | - | nose_tip | float | [-1,1] | 数值越大,鼻尖越大 |
| 面部重塑 | 嘴巴 | 大小 | - | mouth_scale | float | [-1,1] | 数值越大,嘴巴越大 |
| 面部重塑 | 嘴巴 | 嘴宽 | - | mouth_width | float | [-1,1] | 数值越大,嘴巴越宽 |
| 面部重塑 | 嘴巴 | 位置 | - | mouth_position | float | [-1,1] | 数值越大,嘴巴越高 |
| 面部重塑 | 嘴巴 | 丰上唇 | - | lip_plump_up | float | [-1,1] | 数值越大,上嘴唇越厚 |
| 面部重塑 | 嘴巴 | 丰下唇 | - | lip_plump_down | float | [-1,1] | 数值越大,下嘴唇越厚 |
| 身体美型 | - | AI塑形 | - | ai_body_thin | float | [0,1] | 数值越大,身体越瘦 |
| 身体美型 | - | 瘦身 | - | body_thin | float | [0,1] | 数值越大,身体越瘦 |
| 身体美型 | - | 小头 | - | head_small | float | [-1,1] | 数值越大,头越小 |
| 身体美型 | - | 脖子长度 | - | neck_length | float | [-1,1] | 数值越大,脖子越长 |
| 身体美型 | - | 天鹅颈 | 左 | left_swan_neck | float | [0,1] | 数值越大,左侧脖子越瘦 |
| 身体美型 | - | 天鹅颈 | 右 | right_swan_neck | float | [0,1] | 数值越大,右侧脖子越瘦 |
| 身体美型 | - | 瘦脖子 | - | neck_thin | float | [0,1] | 数值越大,脖子越瘦 |
| 身体美型 | - | 瘦手臂 | - | arm_thin | float | [0,1] | 数值越大,手臂越瘦 |
| 身体美型 | - | 瘦腰 | - | waist_thin | float | [0,1] | 数值越大,腰越瘦 |
| 身体美型 | - | 瘦腿 | - | leg_thin | float | [0,1] | 数值越大,腿越瘦 |
| 皮肤调整 | - | 中性灰磨皮脸部 | - | face_smooth_gray | float | [0,1] | 数值越大,明亮度越均匀 |
| 皮肤调整 | - | 高低频磨皮脸部 | 整体 | face_smooth_fine | float | [0,1] | 数值越大,皮肤越光滑。注意:组内 3 个参数需一起使用,缺少任意项均无效 |
| 皮肤调整 | - | 高频增强-脸部 | - | face_smooth_highpass | float | [-1,1] | 数值越大,皮肤特征越明显;没有需求传 0。注意:组内 3 个参数需一起使用,缺少任意项均无效 |
| 皮肤调整 | - | 低频平整-脸部 | - | face_smooth_lowpass | float | [0,1] | 数值越大,皮肤纹理越低;没有需求传 0。注意:组内 3 个参数需一起使用,缺少任意项均无效 |
| 皮肤调整 | - | 高低频磨皮身体 | 整体 | body_smooth_fine | float | [0,1] | 数值越大,皮肤越光滑。注意:组内 3 个参数需一起使用,缺少任意项均无效 |
| 皮肤调整 | - | 高频增强-身体 | - | body_smooth_highpass | float | [-1,1] | 数值越大,皮肤特征越明显。注意:组内 3 个参数需一起使用,缺少任意项均无效 |
| 皮肤调整 | - | 低频平整-身体 | - | body_smooth_lowpass | float | [0,1] | 数值越大,皮肤纹理越低。注意:组内 3 个参数需一起使用,缺少任意项均无效 |
| 皮肤调整 | - | 水润磨皮脸部 | - | face_smooth | float | [0,1] | 数值越大,皮肤越光滑水润 |
| 皮肤调整 | - | 水润磨皮身体 | - | body_smooth | float | [0,1] | 数值越大,皮肤越光滑水润 |
| 皮肤调整 | - | 面部高光立体 | - | face_highlight | float | [0,1] | 数值越大,脸部高光越明显 |
| 皮肤调整 | - | 面部阴影立体 | - | face_shadow | float | [0,1] | 数值越大,脸部阴影越明显 |
| 皮肤调整 | - | 皮肤清晰度 | - | skin_sharpen | float | [0,1] | 数值越大,皮肤纹理越清晰 |
| 皮肤调整 | - | 皮肤美白 | - | skin_white | float | [0,1] | 数值越大,皮肤越白 |
| 皮肤调整 | - | 皮肤透亮 | - | skin_bright | float | [0,1] | 数值越大,皮肤越透亮 |
| 皮肤调整 | - | 皮肤红润 | - | skin_red | float | [0,1] | 数值越大,皮肤越红润 |
| 皮肤调整 | - | 肤色统一脸部 | - | face_color_same | float | [0,1] | 数值越大,脸部肤色越均匀 |
| 皮肤调整 | - | 肤色统一身体 | - | body_color_same | float | [0,1] | 数值越大,身体肤色越均匀 |
| 皮肤调整 | - | 肤色选择 | 类型 | skin_color_id | int | 枚举值 | 不同肤色类型,1 是冷白,2 是奶白,3 是粉白,4 是暖白,5 是焦糖,6 是麦黑 |
| 皮肤调整 | - | 肤色选择 | 程度值 | skin_color | float | [0,1] | 数值越大,肤色变化越大 |
| 皮肤调整 | - | 肤色偏好 | - | skin_prefer | float | [-1,1] | 数值越大,肤色越暖 |
| 牙齿美化 | - | 牙齿美白 | 整体 | teeth_white | float | [0,1] | 数值越大,牙齿越白。注意:组内 3 个参数需一起使用,缺少任意项均无效 |
| 牙齿美化 | - | 牙齿美白 | 明亮 | teeth_white_add_bright | float | [0,1] | 数值越大,牙齿越明亮;没有需求传 1。注意:组内 3 个参数需一起使用,缺少任意项均无效 |
| 牙齿美化 | - | 牙齿美白 | 祛黄 | teeth_white_des_yellow | float | [0,1] | 数值越大,牙齿祛黄越明显;没有需求传 1。注意:组内 3 个参数需一起使用,缺少任意项均无效 |
| 牙齿美化 | - | 牙齿修复 | - | teeth_repair | int | 0 or 1 | 0 关 1 开,修复牙齿缺陷 |
| 眼睛增强 | - | 亮眼 | - | shiny_eye | float | [-1,1] | 数值越大,眼睛越明亮 |
| 眼睛增强 | - | 祛红血丝 | - | remove_eye_streaks | float | [-1,1] | 数值越大,祛红血丝越明显 |
| 眼睛增强 | - | 眼神光 | 类型 | makeup_eyeball_id | int | 枚举值 | 眼神光类型,数值为 1 到 16。1-8 对应 G01-G08,9-16 对应 S01-S08 |
| 眼睛增强 | - | 眼神光 | 程度值 | makeup_eyeball | float | [0,1] | 数值越大,眼神光越明显 |
| 头发调整 | - | 发缝填充 | - | fill_hair_part | float | [0,1] | 数值越大,发缝填充力度越大 |
| 头发调整 | - | 颅顶调整 | - | calvaria_height | float | [-1,1] | 数值越大,颅顶越高 |
| 头发调整 | - | 发际线调整 | - | hairline_height | float | [-1,1] | 数值越大,发际线越高 |
| 头发调整 | - | 祛碎发 | 整体 | remove_burst_hair | float | [0,1] | 数值越大,祛碎发力度越大。注意:组内 3 个参数需一起使用,缺少任意项均无效 |
| 头发调整 | - | 祛碎发 | 背景区域 | remove_burst_hair_back | float | [0,1] | 背景区域祛碎发力度,没有需求传 1。注意:组内 3 个参数需一起使用,缺少任意项均无效 |
| 头发调整 | - | 祛碎发 | 人物区域 | remove_burst_hair_body | float | [0,1] | 人物区域祛碎发力度,没有需求传 1。注意:组内 3 个参数需一起使用,缺少任意项均无效 |
| 头发调整 | - | 祛白发 | - | remove_white_hair | float | [0,1] | 数值越大,祛白发力度越大 |
| 妆容调整 | - | 高光立体 | - | makeup_highlight | float | [0,1] | 数值越大,脸部高光立体越明显 |
| 妆容调整 | - | 阴影立体 | - | makeup_shadow | float | [0,1] | 数值越大,脸部阴影立体越明显 |
| 妆容调整 | - | 眉毛增强 | 左 | left_eyebrow_enhance | float | [0,1] | 数值越大,左眉毛越黑 |
| 妆容调整 | - | 眉毛增强 | 右 | right_eyebrow_enhance | float | [0,1] | 数值越大,右眉毛越黑 |
| 妆容调整 | - | 眉毛 | 类型 | makeup_eyebrow_id | int | 枚举值 | 1:一字眉,2:新月眉,3:小山眉,4:水波眉,5:秋娘眉,6:欧美挑眉,7:柳叶眉,8:羽雕眉 |
| 妆容调整 | - | 眉毛 | 眉毛程度值 | makeup_eyebrow | float | [0,1] | 数值越大,眉毛程度越深 |
| 妆容调整 | - | 眼妆 | 类型 | makeup_eye_shadow_id | int | 枚举值 | 1-10 一共 10 种眼妆,无具体名字 |
| 妆容调整 | - | 眼妆 | 程度值 | makeup_eye_shadow | float | [0,1] | 数值越大,眼妆程度越深 |
| 妆容调整 | - | 睫毛 | 类型 | makeup_eyelash_id | int | 枚举值 | 1-14 一共 14 种睫毛,无具体名字 |
| 妆容调整 | - | 睫毛 | 程度值 | makeup_eyelash | float | [0,1] | 数值越大,睫毛程度越深 |
| 妆容调整 | - | 口红 | 类型 | makeup_lipstick_id | int | 枚举值 | 1:正红色,2:勃艮第红,3:烂番茄,4:亮粉色,5:瑰红色,6:布朗尼,7:瘾红,8:狂热棕,9:点绛唇,10:棠梂,11:檀绯,12:桃笙,13:桃溪,14:木质粉 |
| 妆容调整 | - | 口红 | 程度值 | makeup_lipstick | float | [0,1] | 数值越大,口红程度越深 |
| 妆容调整 | - | 腮红 | 类型 | makeup_blush_id | int | 枚举值 | 1-8 一共 8 种腮红,无具体名字 |
| 妆容调整 | - | 腮红 | 程度值 | makeup_blush | float | [0,1] | 数值越大,腮红程度越深 |
| 妆容调整 | - | 装饰 | 类型 | makeup_freckle_id | int | 枚举值 | 1-8 一共 8 种雀斑,无具体名字 |
| 妆容调整 | - | 装饰 | 程度值 | makeup_freckle | float | [0,1] | 数值越大,雀斑程度越深 |
| 妆容调整 | - | 修容 | 类型 | makeup_face_id | int | 枚举值 | 1-7 一共 7 种修容,无具体名字 |
| 妆容调整 | - | 修容 | 程度值 | makeup_face | float | [0,1] | 数值越大,修容程度越深 |
| 衣服美化 | - | 衣服祛褶皱 | 祛褶皱力度 | clothes_flaw_remove | float | [0,1] | 数值越大,祛瑕疵越干净 |
| 面部流畅 | - | 面部流畅 | - | face_smooth_new | float | [0,1] | 数值越大,效果越明显。该功能会将脸部外轮廓拉得更平滑,使人像看起来更年轻、脸部更柔和美观 |
PartialTemplates 针对特定类型人群进行修图
- 相应人群修图结构体不存在时,取 PartialHumanOptions 中参数作为该人群默认值
- 相应人群修图结构体存在时,该人群所有修图参数以该结构体内部为准
| 修图结构体 | 类型 | 示例 | 人群类型 |
|---|---|---|---|
| male_young | struct | {"face_thin":0.6,"eye_scale":0.5} |
青年男人 |
| female_young | struct | {"face_thin":0.6,"eye_scale":0.5} |
青年女人 |
| male_old | struct | {"skin_white":0.4,"remove_wrinkles":0.8} |
老年男人 |
| female_old | struct | {"skin_white":0.4,"remove_wrinkles":0.8} |
老年女人 |
| child | struct | {"eye_scale":0.7} |
婴幼儿 |
以上结构体内部修图参数同 PartialHumanOptions
返回参数
| 字段 | 类型 | 说明 |
|---|---|---|
| log_id | uint64 | 唯一日志 ID,用于问题定位 |
| result | object | 返回结果 |
| result.task_id | string | 任务 ID,用于查询任务结果,有效期 8 小时 |
请求示例
JSON
1{
2 "url": "https://example.com/image.jpg",
3 "callback_data": "user_123",
4 "IColorParams": {
5 "ai_color": 1,
6 "auto_exposure": 0.5,
7 "auto_whitebalance": 0.5,
8 "lut_id": "110041",
9 "lut_value": 0.6
10 },
11 "PartialHumanOptions": {
12 "remove_face_flaw": 0.8,
13 "face_thin": 0.5,
14 "eye_scale": 0.3,
15 "face_smooth": 0.6,
16 "skin_white": 0.4
17 },
18 "transform_options": {
19 "auto_correct_angle": true
20 }
21}
返回示例
JSON
1{
2 "log_id": 1234567890,
3 "result": {
4 "task_id": "4df032d7c4df22cc494bfa23a5f98c7e"
5 }
6}
查询结果
HTTP 方法:post
请求URL: https://aip.baidubce.com/rest/2.0/image-process/v1/retouching/query_task
请求参数
| 字段 | 是否必选 | 类型 | 说明 |
|---|---|---|---|
| task_id | 是 | string | 创建任务时返回的任务 ID |
返回参数
| 字段 | 类型 | 说明 |
|---|---|---|
| log_id | uint64 | 唯一的 log_id,用于问题定位 |
| error_code | int | 错误码 |
| error_msg | string | 错误描述信息 |
| request_id | number | 请求 ID,问题定位时使用。当接口报错时,请记录此 ID |
| result | dict | 返回结果 |
| result.task_id | string | 任务 ID |
| result.status | string | 任务状态。pending:排队中;processing:运行中;success:成功;failed:失败 |
| result.dlink | string | 结果图下载链接,有效期 8 小时 |
| result.callback_data | string | 提交任务时的透传参数 |
返回示例
JSON
1{
2 "log_id": 1234567890,
3 "result": {
4 "task_status": 1,
5 "task_errcode": 0,
6 "dlink": "https://example.com/result.jpg",
7 "callback_data": "user_123"
8 }
9}
评价此篇文章
