# カラコンバーチャル試着

# 概要
カラコンバーチャル試着では、虹彩を検出し、レンズの不透明度とブレンドをシミュレートして目の色を変えます。
![](https://plugins-media.makeupar.com/smb/blog/post/2022-01-25/2a348e5b-6a2b-4f08-bc54-1d16a0777e87.jpg)
**コンタクトレンズバーチャルシミュレーション**
AI 駆動のバーチャル試着ツールで、目の色を変えます。虹彩を検出し、色調調整を適用します。
**リアルな出力**
自然な目の反射を保持します。
**コンタクトフィルターシミュレーション**
異なる虹彩のベースカラーにわたって不透明度とブレンドを再現します。


---

## 統合ガイド
* セルフィーを撮影する
  * 適切な照明の下でカメラに直接向きます。
  * JS Camera Kit を使用して写真をキャプチャします。
* レンズスタイルの切り抜き画像を準備する
* **1 つの明確なレンズスタイル画像**を提供します：
  * 形式：
**PNG**
（推奨：背景透過済み）
  * 寸法：
**200 × 200 ≤ W × H ≤ 600 × 600**
  * ファイルサイズ：
**< 10 MB**
**サンプル：**
![](https://d3ss46vukfdtpo.cloudfront.net/static/media/01.00ccf3ac.png)
![](https://d3ss46vukfdtpo.cloudfront.net/static/media/02.c8beb3fc.png)
* ***/s2s/v2.0/file*** API を介してアップロード URL とファイル ID を取得する
ファイル API レスポンスで返されたアップロード URL を使用して、以下のファイルをアップロードします：
  * セルフィー写真
  * レンズスタイル画像
* AI タスク ***/s2s/v2.0/task/eye-color-vto*** を実行する
ファイル ID または画像 URL を入力ソースとして使用して AI タスクを実行します。効果パラメータを必要に応じて設定します。
* タスクステータスのポーリング
返された **task_id** を使用してタスクの進捗を監視します。
**GET /task/eye-color-vto** をポーリングしてエンジンのステータスを確認します。
タスクは完了するまで **“running”** 状態のままです。タスク実行中はユニットは消費されません。

![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/strapi/assets/webp_9535461b-69fc-4432-b56b-2d7c4cd0bf3b_b1ef78e813.jpg)
* **サンプルアプリケーションシナリオ**
  - ステップ 1: 色を選ぶ
試着したい色合いを選択します。
  - ステップ 2: バーチャル試着カメラを開く
バーチャル試着ツールを起動します。
  - ステップ 3: ライブカメラを使用または写真をアップロードする
ライブカメラで撮影するか、写真をアップロードしてカラーコンタクトレンズをバーチャルに試着します。
![](https://plugins-media.makeupar.com/smb/blog/post/2025-03-28/2732a9f0-9cae-4639-b765-15866550b109.jpg)

## ファイル仕様とエラー
* 対応形式と寸法

| タイプ | 対応寸法 | 対応ファイルサイズ | 対応形式 |
|  --- | --- | --- | --- |
| AI カラコンバーチャルシミュレーション | セルフィー画像:    *   長辺 ≤ 1920 px     *   短辺 ≥ 320 px レンズスタイル画像:    *   ファイル形式: PNG     *   解像度: 200 × 200 ≤ W × H ≤ 600 × 600 px | < 10MB | jpg/png |

* エラーコード

| エラーコード | 説明 |
|  --- | --- |
| error_below_min_image_size | 画像の幅または高さが 320 ピクセル未満の場合、使用するには小さすぎます |
| error_face_position_invalid | 画像内で顔全体が完全に可視であり、一部が切れていない必要があります |
| error_face_position_too_small | 写真内の顔が小さすぎて適切に分析できません |
| error_face_position_out_of_boundary | 顔が大きすぎるか、写真の端の一部が外れています |
| error_insufficient_lighting | 照明が暗すぎて分析が困難です |
| error_face_angle_invalid | 顔の角度が適切ではありません。正面を向いた撮影では、頭を正面から 10 度以内に保ってください。横を向いた撮影では、角度が 15 度以上である必要があります |

* 環境と依存関係

| サンプルコード言語 / ツール | 推奨ランタイムバージョン |
|  --- | --- |
| 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 機能 | 消費ユニット |
|  --- | --- |
| カラコンバーチャル試着 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' の間にスペースが 1 つ必要です。

Type: http
Scheme: bearer

## Download OpenAPI description

 - [カラコンバーチャル試着](https://docs.perfectcorp.com/_bundle/@l10n/ja/reference/ai_eye_color_lens.yaml)

## V1.0

 - [POST /s2s/v2.0/task/eye-color-vto](https://docs.perfectcorp.com/ja/reference/ai_eye_color_lens/v1.0/paths/~1s2s~1v2.0~1task~1eye-color-vto/post.md): AI タスクは非同期です。機能ごとに Webhook がサポートされている場合は、Webhook による完了処理を優先します。Webhook エンドポイントを設定し、Webhook 署名を検証したうえで、`success` または `error` の通知が来たら、受け取った `task_id` を使ってタスクの結果を照会します。設定と検証の詳細は [Webhook 統合ガイド](/develop/
 - [GET /s2s/v2.0/task/eye-color-vto/{task_id}](https://docs.perfectcorp.com/ja/reference/ai_eye_color_lens/v1.0/paths/~1s2s~1v2.0~1task~1eye-color-vto~1%7Btask_id%7D/get.md)