本文档介绍人脸滤镜FaceFilter的语法及示例。
功能描述
FaceFilter可以对图片的整体风格进行转变。
假设原始图如下。

我们对原始图进行不同风格的转换,效果如下。
- 默认效果
- 向日葵
- 垦丁
- 桔梗
- 大理
- 丽江
前提条件
输入限制
- 图片分辨率:图片分辨率最大不超过2000×2000像素。
- URL地址中不能包含中文字符。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | FaceFilter |
要执行的操作。取值:FaceFilter。 |
ImageURL | String | 是 | https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/facebeauty.jpeg |
图片URL地址。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL。 |
ResourceType | String | 是 | 垦丁 |
选择图片风格,包括:默认、向日葵、桔梗、垦丁、大理、丽江。 |
Strength | Float | 是 | 0.8 |
滤镜强度,取值范围0~1。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Data | Struct |
返回的结果数据内容。 |
|
ImageURL | String | http://algo-app-taobao-mm-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/pixelai-portrait-filter/2020_03_24/bd6bb112b4ef3c8c_facebeauty.jpg?Expires=1585278860&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=UB3gBjSyTm0EZC0K881P883JpX**** |
输出转换风格后的图片URL地址。 |
RequestId | String | EA20A53F-9523-4FE6-92D4-69F9E0A066AF |
请求ID。 |
示例
请求示例
http(s)://facebody.cn-shanghai.aliyuncs.com/?Action=FaceFilter
&ImageURL=https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/facebeauty.jpeg
&ResourceType=垦丁
&Strength=0.8
&<公共请求参数>
正常返回示例
XML
格式
<RequestId>EA20A53F-9523-4FE6-92D4-69F9E0A066AF</RequestId>
<Data>
<ImageURL>http://algo-app-taobao-mm-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/pixelai-portrait-filter/2020_03_24/bd6bb112b4ef3c8c_facebeauty.jpg?Expires=1585278860&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=UB3gBjSyTm0EZC0K881P883JpX****</ImageURL>
</Data>
JSON
格式
{
"RequestId": "EA20A53F-9523-4FE6-92D4-69F9E0A066AF",
"Data": {
"ImageURL": "http://algo-app-taobao-mm-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/pixelai-portrait-filter/2020_03_24/bd6bb112b4ef3c8c_facebeauty.jpg?Expires=1585278860&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=UB3gBjSyTm0EZC0K881P883JpX****"
}
}
错误码
关于人脸滤镜的错误码,详情请参见常见错误码。
SDK参考
阿里云视觉AI能力支持使用SDK调用,具体可参见SDK总览下载安装。
安全声明
- 请确保上传的图片或文件来源符合相应的法律法规。
- 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。
在文档使用中是否遇到以下问题
更多建议
匿名提交