カラコンバーチャル試着
カラコンバーチャル試着では、虹彩を検出し、レンズの不透明度とブレンドをシミュレートして目の色を変えます。
コンタクトレンズバーチャルシミュレーション
AI 駆動のバーチャル試着ツールで、目の色を変えます。虹彩を検出し、色調調整を適用します。
リアルな出力
自然な目の反射を保持します。
コンタクトフィルターシミュレーション
異なる虹彩のベースカラーにわたって不透明度とブレンドを再現します。
セルフィーを撮影する
- 適切な照明の下でカメラに直接向きます。
- JS Camera Kit を使用して写真をキャプチャします。
レンズスタイルの切り抜き画像を準備する
1 つの明確なレンズスタイル画像を提供します：
- 形式：PNG（推奨：背景透過済み）
- 寸法：200 × 200 ≤ W × H ≤ 600 × 600
- ファイルサイズ：< 10 MB
サンプル：
/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” 状態のままです。タスク実行中はユニットは消費されません。
サンプルアプリケーションシナリオ
ステップ 1: 色を選ぶ 試着したい色合いを選択します。
ステップ 2: バーチャル試着カメラを開く バーチャル試着ツールを起動します。
ステップ 3: ライブカメラを使用または写真をアップロードする ライブカメラで撮影するか、写真をアップロードしてカラーコンタクトレンズをバーチャルに試着します。
- 対応形式と寸法
| タイプ | 対応寸法 | 対応ファイルサイズ | 対応形式 |
|---|---|---|---|
| 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 |