# AI 波浪卷发虚拟试戴

# 概览
不管是想要蓬松的卷圈、松散的大波浪，还是张扬的卷发造型，YouCam API 的卷发特效都能让您几秒钟就试到耳目一新的好发型——足不出户就能玩。
从柔和波浪到爆炸头，YouCam 的精准度和真实感都有口皆碑。下次去理发店之前，先用它大胆试新发型，心里更有底。
![](https://plugins-media.makeupar.com/smb/blog/post/2025-04-01/webp_03963789-fb1e-4ad8-be4d-48932e247376.jpg)
![](https://plugins-media.makeupar.com/smb/blog/post/2025-03-20/b25b228a-259b-4efb-a7c1-31d200b62e8c.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 | 原图的脸部姿态不受支持 |



---

## 点数消耗
| 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_wavy_hair.yaml)

## V1.0

 - [GET /s2s/v2.0/task/template/hair-curl](https://docs.perfectcorp.com/zh-cn/reference/ai_wavy_hair/v1.0/paths/~1s2s~1v2.0~1task~1template~1hair-curl/get.md)
 - [POST /s2s/v2.0/task/hair-curl](https://docs.perfectcorp.com/zh-cn/reference/ai_wavy_hair/v1.0/paths/~1s2s~1v2.0~1task~1hair-curl/post.md): 查询任务状态的方法，请参见轮询指南。
 - [GET /s2s/v2.0/task/hair-curl/{task_id}](https://docs.perfectcorp.com/zh-cn/reference/ai_wavy_hair/v1.0/paths/~1s2s~1v2.0~1task~1hair-curl~1%7Btask_id%7D/get.md)