# AI アバター

# 概要
AI マジックアバターツールでは、画像から画像への生成技術（image-to-image）を使います。つまり、アバターはユーザーの写真に基づいて生成されます。写真を選ぶと、アプリに組み込まれた技術がユーザーの顔の特徴を分析し、学習を開始します。
より多くのアバタースタイルについては、https://yce.makeupar.com/avatar を参照してください。
ユースケース:
![AI アバター](https://bcw-media.s3.ap-northeast-1.amazonaws.com/Christmas_Avatar_b861c35edf.jpg)
![AI アバター](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' の間にスペースが 1 つあることに注意してください。

Type: http
Scheme: bearer

## Download OpenAPI description

 - [AI アバター](https://docs.perfectcorp.com/_bundle/@l10n/ja/reference/ai_avatar_generator.yaml)

## V3.0

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