# 整体流程美颜 API 接入支持通过 **智能创作云\-AI特效模板消费OpenAPI ** 异步调用。流程为： 1. 通过 **`/openapi/ai_effect/submit`** ** ** 接口传入图片**`resource_list`** ** ** (每个任务只支持一张，多传无用) 提交美化任务得到 **task_id** 2. 通过 **`/openapi/ai_effect/query`** ** ** 接口传入 **TaskId** 轮询获取美化后的图片 **result_url** 接口详情、鉴权见 [智能创作云 AI 特效模板消费 OpenAPI 接入指引（APIKey 版）](https://bytedance.larkoffice.com/wiki/LyBwwcLrDiagnckxppwcegYynPd) 文档 |名称 |类型 |值 |备注 | |---|---|---|---| |template_id |String |"245621002" | | # extra 参数公共参数 **`beautyToolConfigKey`** ** ** 必填 |名称 |类型 |值 |备注 | |---|---|---|---| |beautyToolConfigKey |String |beautyCustom_v1 | | 1. ## 预设美化口令支持通过PC端工具保存的美化口令 beautyCode 进行图像美化，请求数据样例 ```JSON { "template_id": "245621002", "payload": { "resource_list": ["https://aa.com/bb.jpg"], "extra": { "beautyToolConfigKey": "beautyCustom_v1", "beautyCode": "xxx" } } } ``` 2. ## 自定义美化参数支持通过传参添加美颜、风格妆、微整形、美体、画质、滤镜等效果。详细分组参数列表如下：美颜 (beauty) |名称 |key |value 类型 |value 范围 |备注 | |---|---|---|---|---| |去油光 |yaguang |int |[0, 100] | | |肤色统一|unify_skin_color|int |[0, 100] | |\ | | | | | | |美白\-粉白|whiten_fenbai|int |[0, 100]| |\ | | | | | | |丰盈 |face_plump|int |[0, 100] | |\ | | | | | | |去颈纹 |neck_wrinkles |int |[0, 100] | | |锐化 |sharp |int |[0, 100] | | |清晰 |clear |int |[0, 100] | | |全身磨皮 |smooth_body|int |[0, 100] | |\ | | | | | | 风格妆 (style_makeup) |名称 |key |value 类型 |value 范围 |备注 | |---|---|---|---|---| |伪素颜|weisuyan |int |[0, 100]| |\ | | | | | | |硬朗 |yinglang |int |[0, 100]| |\ | | | | | | 微整形 (reshape) |名称 |key |value 类型 |value 范围 |备注 | |---|---|---|---|---| |流畅脸 |liuchanglian |int |[0, 100] | | |下颌线|xiahexian |int |[0, 100] | |\ | | | | | | |去双下巴 |shuangxiaba|int |[0, 100] | |\ | | | | | | |面部\-瘦脸\-自然脸 |slimface_nature |int |[0, 100] | | |面部\-窄脸 |face_cutface |int |[\-50, 50] | | |面部\-小头|face_shrinkhead |int |[0, 100] | |\ | | | | | | |面部\-颧骨|face_cheekbone |int |[\-50, 50] | |\ | | | | | | |面部\-下巴长短 |face_chin_v2|int |[\-50, 50] | |\ | | | | | | |面部\-发际线 |face_forehead |int|[\-50, 50] | |\ | | | | | | |眼睛\-大小 |eye|int|[\-50, 50]| |\ | | | | | | |眼睛\-亮眼 |eye_brighten |int |[0, 100]| |\ | | | | | | |鼻子\-瘦鼻|nose |int |[\-50, 50] | |\ | | | | | | |嘴巴\-白牙 |whiten_teeth |int |[0, 100] | | 美体 (bodyshaping) |名称 |key |value 类型 |value 范围 |备注 | |---|---|---|---|---| |瘦身|slimbody|int |[0, 100] | |\ | | | | | | |长腿 |leglength|int |[0, 100] | |\ | | | | | | |瘦腰 |slimwaist |int |[0, 100] | | 画质 (image_quality) |名称 |key |value 类型 |value 范围 |备注 | |---|---|---|---|---| |色温 |temperature |int |[\-50, 50] | | |色调 |tone |int |[\-50, 50] | | |饱和度 |saturation |int |[\-50, 50] | | |亮度 |brightness |int |[\-50, 50] | | |对比度 |contrast |int |[\-50, 50] | | |高亮 |highlight |int |[\-50, 50] | | |阴影 |shadow |int |[0, 100] | | |光感 |lightperception |int |[\-50, 50] | | |颗粒 |particles |int |[0, 100] | | |褪色 |fading |int |[0, 100] | | |暗角 |vignette |int |[0, 100] | | 滤镜 (filter) |名称 |key |value 类型 |value 范围 |备注 | |---|---|---|---|---| |亮橘 |liangju |int |[0, 100] | | |原相机 |yuanxiangji |int |[0, 100] | | 可以自定义组合美化参数（**default ** 为默认参数组必传）请求数据样例 ```JSON { "template_id": "245621002", "payload": { "resource_list": ["https://aa.com/bb.jpg"], "extra": { "beautyToolConfigKey": "beautyCustom_v1", "default": { "beauty": { "yaguang": 80, "unify_skin_color": 70, "whiten_fenbai": 0, "face_plump": 0, "neck_wrinkles": 50, "sharp": 10, "clear": 30, "smooth_body": 40 }, "style_makeup": { "yinglang": 50 }, "reshape": { "liuchanglian": 100, "xiahexian": 100, "shuangxiaba": 100, "slimface_nature": 10, "face_cutface": 0, "face_shrinkhead": 10, "face_cheekbone": 0, "face_chin_v2": 0, "face_forehead": 0, "eye": 10, "eye_brighten": 100, "nose": 10, "whiten_teeth": 100 }, "bodyshaping": { "slimbody": 30, "leglength": 0, "slimwaist": 30 } } } } } ``` # Sample Code api_sample.py

智能美化特效