# AI 刘海滤镜虚拟试戴

# 概览
用 AI 试出最适合您的刘海
效果真实：试戴逼真的刘海，找出最衬您脸型的样式。​
样式丰富：各式刘海任您挑，各种性格、各种场合都顾得到。​
上手轻松：界面友好，试新刘海轻松好玩​。
想看更多刘海样式？请参见 https://yce.makeupar.com/bangs-filter。
使用场景：
![AI Hair Bang Generator](https://bcw-media.s3.ap-northeast-1.amazonaws.com/hair_style_v1_video_1200x674px_1_259f619dfd.png)
![AI Hair Bang Generator](https://bcw-media.s3.ap-northeast-1.amazonaws.com/hair_style_v1_video_1200x674px_2_7146754733.png)
拍摄建议：
![Suggestions for How to Shoot](https://bcw-media.s3.ap-northeast-1.amazonaws.com/AI_Hair_Extension_recommendation_ba24bd5d92.png)


---

## 文件规格与错误码
* 支持的格式与尺寸

| AI 功能 | 支持尺寸 | 支持文件大小 | 支持格式 |
|  --- | --- | --- | --- |
| AI 刘海滤镜虚拟试戴生成 | 长边 <= 1024，脸宽 >= 128，脸部姿态：-10 < pitch < +10，-45 < yaw < +45，-15 < roll < +15，仅支持单人脸，需露出完整脸部 | < 10MB | jpg/jpeg/png |

* 错误码

| 错误码 | 说明 |
|  --- | --- |
| error_no_shoulder | 原图中看不到肩膀 |
| error_large_face_angle | 上传图片中的脸部角度过大 |
| error_insufficient_landmarks | 在原图中检测不到足够的人脸或人体关键点 |
| error_hair_too_short | 输入的头发太短 |
| error_face_pose | 原图的脸部姿态不受支持 |
| error_bald_image | 输入的发型为光头 |



---

## 点数消耗
| AI 功能 | 消耗点数 |
|  --- | --- |
| AI 刘海滤镜虚拟试戴 V1.0 | 1 |



---

License: Privacy policy

## Servers

```
https://yce-api-01.makeupar.com
```

## Security

### BearerAuthenticationV2

使用标准的 Bearer 鉴权。把您的 API 密钥放进请求头： `Authorization:Bearer YOUR_API_KEY`。请注意 'Bearer' 与 'YOUR_API_KEY' 之间有一个空格。

Type: http
Scheme: bearer

## Download OpenAPI description

 - [AI 刘海滤镜虚拟试戴](https://docs.perfectcorp.com/_bundle/@l10n/zh-CN/reference/ai_bangs.yaml)

## V1.0

 - [GET /s2s/v2.0/task/template/hair-bang](https://docs.perfectcorp.com/zh-cn/reference/ai_bangs/v1.0/paths/~1s2s~1v2.0~1task~1template~1hair-bang/get.md)
 - [POST /s2s/v2.0/task/hair-bang](https://docs.perfectcorp.com/zh-cn/reference/ai_bangs/v1.0/paths/~1s2s~1v2.0~1task~1hair-bang/post.md): 本接口用模板与源图片发起刘海生成流程。任务会异步处理，您可以使用本响应返回的 task_id 查询其状态。
 - [GET /s2s/v2.0/task/hair-bang/{task_id}](https://docs.perfectcorp.com/zh-cn/reference/ai_bangs/v1.0/paths/~1s2s~1v2.0~1task~1hair-bang~1%7Btask_id%7D/get.md)