# AI 丰发虚拟试戴

# 概览
即刻拥有蓬松丰盈的发量，整体形象更出彩！​
发量少、发质稀疏？加上自然蓬松感。用 AI 无缝补齐空缺、增发发量。直发、卷发、细软发都适用，相亲资料、简历等场合都能派上用场。
我们的 AI 工具能让您的每张照片都拥有恰到好处的发量与发密度，私人照、职业照、社交照都合适。告别照片里的塌发时刻，张张都是清爽蓬松的好发质。
使用场景：
![AI Hair Volume Generator](https://bcw-media.s3.ap-northeast-1.amazonaws.com/YCE_web_Hair_Volume_Filter_S4_img_01_836436ca00.jpg)
![AI Hair Volume Generator](https://plugins-media.makeupar.com/smb/blog/post/2024-08-26/51eadc51-aaa7-4ebc-ac78-e389be5e16b0.jpg)
拍摄建议：
![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 | 2 |



---

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_hair_volume.yaml)

## V1.0

 - [GET /s2s/v2.0/task/template/hair-vol](https://docs.perfectcorp.com/zh-cn/reference/ai_hair_volume/v1.0/paths/~1s2s~1v2.0~1task~1template~1hair-vol/get.md)
 - [POST /s2s/v2.0/task/hair-vol](https://docs.perfectcorp.com/zh-cn/reference/ai_hair_volume/v1.0/paths/~1s2s~1v2.0~1task~1hair-vol/post.md): AI 任务是异步处理的。功能支持 Webhook 时，优先用 Webhook 来接收完成通知。配置好您的 Webhook 端点、校验 Webhook 签名，收到 `success` 或 `error` 通知后，用收到的 `task_id` 查询任务结果。配置与校验的细节请见 [Webhook 接入指南](/develop/webhook)。 若功能不支持 Webhook，或您的接入方式用不了 We
 - [GET /s2s/v2.0/task/hair-vol/{task_id}](https://docs.perfectcorp.com/zh-cn/reference/ai_hair_volume/v1.0/paths/~1s2s~1v2.0~1task~1hair-vol~1%7Btask_id%7D/get.md)