# AI 肌改善シミュレーション

# 概要
**AI 駆動の肌シミュレーション**
AI 肌シミュレーションでは、顔の肌状態のビフォーアフターを可視化します。
最大 10 種類の肌悩み（輝き、ニキビ、皮脂、目の下のたるみ、クマ、シミ、毛穴、肌質、しわ、赤み）を可視化できます。
![](https://plugins-media.makeupar.com/smb/blog/post/2025-04-17/4edad54f-ef6b-4842-b104-d114889318b1.jpg)
各シミュレーションは数秒で生成されます。
![](https://plugins-media.makeupar.com/smb/blog/post/2025-11-13/webp_27e3ad50-7769-46de-822c-c9300f87f57d.webp)
e コマースウェブサイト、モバイルアプリケーションなどで使えます。
![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/strapi/assets/AI_Skin_Simulation_pores_b1e209ee58.jpg)
![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/strapi/assets/AI_Skin_Simulation_283421234a.jpg)


---

## 統合ガイド
このガイドでは、以下を説明します。
AI 肌改善シミュレーション API のワークフロー：
**エンドポイント:** `/s2s/v2.0/task/skin-simulation`
**認証必須:** `Authorization: Bearer YOUR_API_KEY`
**ワークフロー手順:**
1. **画像アップロードの準備:**
  - プロセスはセルフィー画像の準備から始まります。
2. **AI 肌改善シミュレーション設定**
各肌悩み（例：しわ、毛穴、赤み）について、**シミュレーション強度**を **0.0 から 1.0** の値で調整します：
  - **0.0**
:
*元の*
肌の外観を表示します—変更なし。
  - **1.0**
: その悩みに対して AI が生成できる
*最も自然で健康的に見える*
強化を適用します。
**仕組み:**
  - 低い設定（例：0.2～0.4）では、細かいしわや軽微な欠陥が微妙に緩和されます。
  - 高い設定（例：0.7～1.0）では、中程度または深いしわの大幅な軽減、滑らかな質感、トーンの改善など、より顕著な改善が、自然な肌のディテールを保持しながらも発生します。
望ましい見た目になるまで調整してください。
3. **AI タスクの開始とタスク ID の取得:**
  - アップロードした画像と肌シミュレーション設定を HTTP POST リクエストで
`/s2s/v2.0/task/skin-simulation`
 に送信します。
  - このやり取りを識別する一意のタスク ID をレスポンスで待ちます。
4. **タスクステータスのポーリング（継続的な確認）:**
  - 取得した
`task_id`
 を使用して、HTTP GET リクエスト（例：
`GET /task/${task_id}`
）でタスクステータスを定期的にポーリングします。
  - 以下を継続的に監視します：
    - `Task_status = "success"`
（処理完了）。
    - `Task_status = "error"`
（該当する場合、解決または再試行）。
  - ステータスが success に遷移したら、ワークフローを適切に更新します。



---

* 認証

- リクエストヘッダーに
**Bearer トークン**
 を使用して API キーを含めます：

```
Authorization: Bearer YOUR_API_KEY
```

API キーの確認場所: https://yce.makeupar.com/api-console/en/api-keys/.


---

* 画像のアップロード

ファイルをサーバーに直接アップロードするか、AI タスクペイロードに有効な画像 URL を提供できます。
* アップロードエンドポイント


```
POST /s2s/v2.0/file
```
すでに公開画像 URL がある場合は、この手順をスキップできます。


---

* AI 肌改善シミュレーション強度の調整

**AI 肌改善シミュレーション設定**

各肌悩み（例：しわ、毛穴、赤み）について、**シミュレーション強度**を **0.0 から 1.0** のスケールで調整します：
- **0.0**
 →
*元の外観*
 — AI 強化は適用されません。
- **1.0**
 → その悩みに対する最大限の改善。

**異なる強度レベルでの期待効果：**
| 強度範囲 | 効果 |
|  --- | --- |
| **0.1 – 0.3** | 微妙な改善: 細かいしわの軽微な平滑化、毛穴のわずかな軽減、赤みの穏やかな軽減。 |
| **0.4 – 0.6** | 中程度の改善: 質感と透明感の改善。 |
| **0.7 – 1.0** | 顕著な改善: 中程度から深いしわの大幅な軽減、トーンの均一化、毛穴と赤みの最小化。 |

低め（例：0.2）から開始して調整します。


---

* AI 肌改善シミュレーション AI タスクの作成と結果のポーリング

画像をアップロードし、**少なくとも 1 つ**の肌悩みのシミュレーション強度を 0.0 以上に設定した後、タスクを開始できます。API はリクエストを非同期で処理します。ステータスが `success` または `error` に達するまで、タスクステータスをポーリングする必要があります。
* タスク作成エンドポイント


```
POST /s2s/v2.0/task/skin-simulation
```
* ポーリングエンドポイント


```
GET /s2s/v2.0/task/skin-simulation/{task_id}
```


---

## ファイル仕様とエラー
* AI 肌改善シミュレーション仕様

**カメラと撮影ガイドライン**
**ライティング条件**
環境が十分に明るく、均一に照明されていることを確認してください。強い逆光、局所的な露出オーバー、顔への大きな影を避けてください。可能な限り自然光または柔らかい屋内照明を使用してください。ピンク、ブルー、その他の色付き光源など、有色光は肌の色調の表現を歪める可能性があるため使用しないでください。
**顔の位置と遮蔽**
顔がカメラを直接向いている正面からのビューを撮影してください。頭の回転は最小限に抑え、過度な傾きや左右への向きを避けてください。額、頬、あごを含む顔全体が完全に可視であり、遮蔽されていないことを確認してください。髪、マスク、手、メガネのフレーム、携帯電話、または顔の特徴を部分的に覆うその他のオブジェクトは使用しないでください。
**表情とポーズ**
両目を開いた自然でリラックスした表情を保ってください。口は閉じたままでもわずかに開いていても構いませんが、ポーズを無理にしたり誇張したりしないでください。
**フレーム内の顔サイズ**
正確な分析に必要な十分なディテールを確保するために、顔は画像幅の少なくとも 60% を占める必要があります。被写体が小さすぎる、遠すぎる、または不適切にフレーミングされている画像の撮影は避けてください。
![](https://plugins-media.makeupar.com/strapi/assets/thumbnail_skin_analysis_01_5b5defd339.png)


---

* サポートされる形式と寸法

| AI 機能 | サポートされる寸法 | サポートされるファイルサイズ | サポートされる形式 |
|  --- | --- | --- | --- |
| AI 肌改善シミュレーション | 短辺 >= 480, 長辺 <= 2560 | < 10MB | jpg/jpeg/png |

* エラーコード

| **エラーコード** | **説明** |
|  --- | --- |
| `error_below_min_image_size` | 入力画像の解像度が最小必要サイズ未満です（例：< 256×256 ピクセル）。より高解像度の画像をアップロードしてください。 |
| `error_exceed_max_image_size` | 入力画像の解像度が最大許容サイズを超えています（例：> 2560×2560 ピクセル）。アップロード前に画像をリサイズまたはダウンスケールしてください。 |
| `error_invalid_params` | 無効なリクエストパラメータが提供されました。 |
| `error_src_face_too_small` | 検出された顔が画像幅の 60% 未満を占めています—正確な肌分析には小さすぎます。フレーム中央に大きく鮮明な顔がある画像を使用してください。 |
| `error_src_face_out_of_bound` | 検出された顔が画像境界の外側に部分的または完全に位置しています（例：顔が切り詰められすぎている）。額、頬、あごを含む顔全体が可視であり、適切にフレーミングされていることを確認してください。 |
| `error_lighting_dark` | 画像内の環境光が信頼できる肌分析には不十分です（例：露出不足、顔に影が支配的）。顔に均一な照明がある明るく撮影された画像をアップロードしてください。 |

* 環境と依存関係

| サンプルコード言語 / ツール | 推奨ランタイムバージョン |
|  --- | --- |
| cURL | - bash >= 3.2   - curl >= 7.58 (モダンな TLS/HTTP サポート)   - jq >= 1.6 (堅牢な JSON パーシング) |
| Node.js (JavaScript) | Node >= 18 (グローバル fetch 用) |
| JavaScript | - Chrome / Edge >= 80   - Firefox >= 74   - Safari >= 13.1 |
| PHP | PHP >= 7.4 (モダンな TLS/互換性用), ext-curl (推奨) または allow_url_fopen=On + ext-openssl, ext-json |
| Python | Python >= 3.10 (f-strings 用), requests >= 2.20.0 |
| Java | Java 11+ (HttpClient 用), Jackson Databind >= 2.12.0 |



---

## JS Camera Kit


---

## ユニット消費
* 肌シミュレーション

| AI 機能 | 消費ユニット |
|  --- | --- |
| 1～4 悩みの分析 | 4 |
| 5～10 悩みの分析 | 6 |



---

License: Privacy policy

## Servers

```
https://yce-api-01.makeupar.com
```

## Security

### BearerAuthenticationV2

標準の「Bearer 認証」を使用します。ヘッダーに `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_skin_simulation.yaml)

## V1.0

 - [POST /s2s/v2.0/task/skin-simulation](https://docs.perfectcorp.com/ja/reference/ai_skin_simulation/v1.0/paths/~1s2s~1v2.0~1task~1skin-simulation/post.md): このエンドポイントで肌改善シミュレーションプロセスを開始します。ソースファイル（URL または File ID 経由）を提供し、シミュレーションパラメータ（しわ、輝きなど）を指定する必要があります。少なくとも 1 つのパラメータはゼロ以外である必要があります。タスクは非同期で処理され、このレスポンスで返される `task_id` を使用してステータスを確認できます。
 - [GET /s2s/v2.0/task/skin-simulation/{task_id}](https://docs.perfectcorp.com/ja/reference/ai_skin_simulation/v1.0/paths/~1s2s~1v2.0~1task~1skin-simulation~1%7Btask_id%7D/get.md)