文档中心

智能美化特效

AI 美颜 API 接入指南

美颜 API V2.0 传统修图接口文档 (APIKey版)

美颜 API V2.0 传统修图接口文档 (APIKey版)

整体流程

美颜 API 接入支持通过智能创作云-AI特效模板消费OpenAPI 异步调用。

流程为：

通过 /openapi/ai_effect/submit 接口传入图片resource_list (每个任务只支持一张，多传无用) 提交美化任务得到 task_id

通过 /openapi/ai_effect/query 接口传入 TaskId 轮询获取美化后的图片 result_url

接口详情、鉴权见智能创作云 AI 特效模板消费 OpenAPI 接入指引（APIKey 版）文档

名称	类型	值	备注
template_id	String	"245621002"

extra 参数

公共参数 beautyToolConfigKey 必填

名称	类型	值	备注
beautyToolConfigKey	String	beautyCustom_v1

预设美化口令

支持通过PC端工具保存的美化口令 beautyCode 进行图像美化，请求数据样例

自定义美化参数

支持通过传参添加美颜、风格妆、微整形、美体、画质、滤镜等效果。详细分组参数列表如下：

美颜 (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 为默认参数组必传）请求数据样例

Sample Code

api_sample.py

最近更新时间：2026.05.15 17:27:33

这个页面对您有帮助吗？

有用

有用

无用

无用