# AI 虛擬化身

# 概述
AI 魔法頭像工具使用 image-to-image 技術，也就是頭像根據您的照片生成。當使用者選取照片後，應用中內嵌的技術便開始分析並學習使用者的臉部特徵。
更多頭像風格，請參考 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)
拍攝建議：
![拍攝建議](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 authentication'。請在標頭中放入您的 'API Key'：`Authorization:Bearer YOUR_API_KEY`。請注意 'Bearer' 與 'YOUR_API_KEY' 之間有一個空格。

Type: http
Scheme: bearer

## Download OpenAPI description

 - [AI 虛擬化身](https://docs.perfectcorp.com/_bundle/@l10n/zh-TW/reference/ai_avatar_generator.yaml)

## V3.0

 - [GET /s2s/v2.0/task/template/ai-avatar](https://docs.perfectcorp.com/zh-tw/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-tw/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 或無法使用
 - [GET /s2s/v2.0/task/ai-avatar/{task_id}](https://docs.perfectcorp.com/zh-tw/reference/ai_avatar_generator/v3.0/paths/~1s2s~1v2.0~1task~1ai-avatar~1%7Btask_id%7D/get.md)