ネイル再現
ネイル再現 API では、参照写真のネイルデザインを手の写真に転送します。
ジェルネイル、ネイルアート、ポリッシュ仕上げ、ラメ、シェルアクセント、メタリックテクスチャーなどのネイルスタイルをプレビューとして再現します。
美容ブランド、サロン、ネイルアーティストで使えます。
このガイドでは、以下を説明します。
ネイル再現 API のワークフロー：
エンドポイント: /s2s/v2.0/task/ai-nail
認証必須: Authorization: Bearer YOUR_API_KEY
ワークフロー手順:
- 画像アップロード準備:
- プロセスは、File API を使用して
/s2s/v2.0/fileに手の画像を準備することから始まります。
- 参照写真のアップロード:
- 希望するネイルデザインが写った参照写真を、File API を使用して
/s2s/v2.0/fileにアップロードします。すべての爪が明確に見えるようにしてください。
- AI タスクの開始とタスク ID の取得:
- アップロードした画像を HTTP POST リクエストで
/s2s/v2.0/task/ai-nailに送信します。 - このインタラクションを識別する一意の
task_idをレスポンスで待ちます。
- タスクステータスのポーリング（継続的な確認）:
- 取得した
task_idを使用して、HTTP GET リクエスト（例：GET /task/${task_id}）でタスクステータスを定期的にポーリングします。 - 以下を継続的に監視します：
Task_status = "success"（処理完了）。Task_status = "error"（該当する場合、解決または再試行）。- ステータスが success に遷移したら、ワークフローを適切に更新します。
このワークフローにより、タスクの監視と結果の取得を行います。
- 認証
- リクエストヘッダーに Bearer Token を使用して API キーを含めます：
Authorization: Bearer YOUR_API_KEYAPI キーの確認場所: https://yce.makeupar.com/api-console/en/api-keys/.
- 画像のアップロード
ファイルをサーバーに直接アップロードするか、AI タスクペイロードに有効な画像 URL を指定します。
- アップロードエンドポイント
POST /s2s/v2.0/fileまたは、公開画像 URL が既に存在する場合は、この手順をスキップします。
- 参照写真のアップロード
ファイルをサーバーに直接アップロードするか、AI タスクペイロードに有効な画像 URL を指定します。すべての爪が見えるようにしてください。
- アップロードエンドポイント
POST /s2s/v2.0/file- ネイル再現 AI タスクの作成と結果のポーリング
画像と完全なエフェクトペイロードが用意できたら、タスクを作成します。API はリクエストを非同期で処理します。ステータスが success または error になるまで、タスクステータスをポーリングします。
- タスク作成エンドポイント
POST /s2s/v2.0/task/ai-nail- ポーリングエンドポイント
GET /s2s/v2.0/task/ai-nail/{task_id}ネイル再現 仕様
対応する手のビュー
画像あたり最大 2 本の手に対応します。追加の手は無視されます。検出のため、各手が画像面積の少なくとも 0.5% を占める必要があります（FHD で約 102×102 px、2K で 139×139 px、4K 画像で 204×204 px）。
対応する参照画像
- 対応フォーマットと寸法
| AI 機能 | 対応寸法 | 対応ファイルサイズ | 対応フォーマット |
|---|---|---|---|
| ネイル再現 | 長辺 <= 4096 | < 10MB | jpg/jpeg/png |
- エラーコード
| エラーコード | 説明 |
|---|---|
| exceed_max_filesize | 画像ファイルが大きすぎます |
| invalid_parameter | 入力パラメータが不足しているか、形式が正しくありません |
| error_download_image | ファイルアップロードが完了していないか、画像 URL が無効です |
| error_inference | 推論に失敗しました。入力画像と参照画像がサポートされているか確認してください |
| no_hand_detected | ソース画像で手が検出されませんでした |
- 環境と依存関係
| サンプルコード言語 / ツール | 推奨ランタイムバージョン |
|---|---|
| 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 |