# AI 接发虚拟试戴

# 概览
用 AI 找到最合心意的接发效果​
在设备上就能试遍各种长度——从长发到超长——以及各式发型、发色与刘海。不用凭感觉猜，先进的生成式 AI 让您看清每种接发效果戴在您头上的样子，决定换造型之前心里有数。​
先进的接发试戴能与您的现有发长自然衔接，正是尝试超长发型的好时机。
使用场景：
![AI Hair Extension](https://bcw-media.s3.ap-northeast-1.amazonaws.com/YCE_web_Hair_Extension_Filter_S2_img_07_098b6e08c4.jpg)
![AI Hair Extension](https://bcw-media.s3.ap-northeast-1.amazonaws.com/YCE_web_Hair_Extension_Filter_S1_img_01_eab88fe3e2.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 |

* 错误码

| 错误码 | 说明 |
|  --- | --- |
| 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_hair_extension.yaml)

## V1.0

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