# AI 虛擬美瞳變色片

# 概述
AI 虛擬美瞳變色片虛擬模擬透過精準偵測虹膜、保留自然反射、精確模擬鏡片在不虹膜顏色上的不透明度與混合，並讓使用者探索從細微變化到鮮豔藍色轉變的各種色調，全部整合在單一專業級 AI API 中，提供即時且極其逼真的隱形眼鏡試戴體驗。
![](https://plugins-media.makeupar.com/smb/blog/post/2022-01-25/2a348e5b-6a2b-4f08-bc54-1d16a0777e87.jpg)
**隱形眼鏡虛擬模擬**
使用我們的 AI 驅動虛擬試戴工具，即時改變眼色。AI 虛擬美瞳變色片透過精準偵測虹膜並套用自然、逼真的色彩調整，帶來極其逼真的結果，讓購物者無需實體樣品即可探索新風格。
**極其逼真的輸出**
系統保留自然的眼部反射以呈現真實結果，確保每次色彩變化都栩栩如生。
**進階隱形眼鏡濾鏡模擬**
隱形眼鏡濾鏡能精確重現不同虹膜底色下的不透明度與混合效果，讓顧客以逼真的層次與色調虛擬試戴全系列鏡片。
**不僅僅是改變眼色**
這項技術超越了簡單的濾鏡，提供專業級的虛擬鏡片體驗，提升顧客信心並提高轉換率。


---

## 整合指南
* 拍攝自拍
  * 在適當光線下正對鏡頭。
  * 使用 JS Camera Kit 拍攝照片。
* 準備您的鏡片風格圖
* 提供**一張清晰的鏡片風格圖片**：
  * 格式：
**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 取得上傳網址與檔案 ID
使用檔案 API 回應中回傳的上傳網址，上傳下列檔案：
  * 您的自拍照片
  * 鏡片風格圖片
* 執行 AI 任務 ***/s2s/v2.0/task/eye-color-vto***
使用檔案 ID 或圖片網址作為輸入來源執行 AI 任務。依需求設定特效參數。
* 輪詢任務狀態
使用回傳的 **task_id** 監控任務進度。
輪詢 **GET /task/eye-color-vto** 以查詢引擎狀態。
任務會維持在**「執行中」**狀態，直到完成。任務執行期間不會消耗點數。

![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/strapi/assets/webp_9535461b-69fc-4432-b56b-2d7c4cd0bf3b_b1ef78e813.jpg)
* **應用情境範例**
AI 虛擬美瞳變色片虛擬模擬改變了顧客選購彩色隱形眼鏡的方式。流程簡單直觀、具互動性，且使用者幾乎不需費力。
  - 步驟 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 功能 | 消耗的點數 |
|  --- | --- |
| AI 虛擬美瞳變色片 V1.0 | 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_eye_color_lens.yaml)

## V1.0

 - [POST /s2s/v2.0/task/eye-color-vto](https://docs.perfectcorp.com/zh-tw/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/webhook)。 若您的整合不支援 webhook 或無法使用
 - [GET /s2s/v2.0/task/eye-color-vto/{task_id}](https://docs.perfectcorp.com/zh-tw/reference/ai_eye_color_lens/v1.0/paths/~1s2s~1v2.0~1task~1eye-color-vto~1%7Btask_id%7D/get.md)