# AI 虚拟化身生成器

# 概览
AI 魔法头像这款应用用的是图生图技术，也就是以您的照片为基础生成头像。用户选好照片后，应用内置的技术就开始分析并学习您的五官特征。
想要更多头像风格，请参见 https://yce.makeupar.com/avatar
使用场景：
![AI Avatar Generator](https://bcw-media.s3.ap-northeast-1.amazonaws.com/Christmas_Avatar_b861c35edf.jpg)
![AI Avatar Generator](https://plugins-media.makeupar.com/smb/blog/post/2023-04-06/fc2c3b2e-2b7f-48c9-96c1-cdb780f9dc1d.jpg)
拍摄建议：
![Suggestions for How to Shoot](https://bcw-media.s3.ap-northeast-1.amazonaws.com/AI_Hair_Extension_recommendation_ba24bd5d92.png)


---

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

| AI 功能 | 支持尺寸 | 支持文件大小 | 支持格式 |
|  --- | --- | --- | --- |
| AI 虚拟化身生成器 | 输入：长边 <= 4096，输出：长边 <= 1024 | < 10MB | jpg/jpeg/png |

* 错误码

| 错误码 | 说明 |
|  --- | --- |
| exceed_max_filesize | 输入文件大小超出上限 |
| invalid_parameter | 参数取值无效 |
| error_download_image | 下载原图出错 |
| error_decode_image | 解码原图出错 |
| error_nsfw_content_detected | 在原图中检测到不适宜内容（NSFW） |



---

## 点数消耗
| AI 功能 | 消耗点数 |
|  --- | --- |
| AI 虚拟化身生成器 V3.0 | 4 张图 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_avatar_generator.yaml)

## V3.0

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