{"templateId":"api_docs","sharedDataIds":{"apiDocsStore":"api-docs-@l10n/ja/reference/ai_nail_transfer.yaml","sidebar":"sidebar-@l10n/ja/reference/sidebars.yaml"},"props":{"definitionId":"@l10n/ja/reference/ai_nail_transfer.yaml","settings":{"baseUrlPath":"/ja/reference/ai_nail_transfer"},"disableAutoScroll":true,"seo":{"title":"ネイル再現","description":"YouCam API documentation by Perfect Corp. Learn how to use Skin analysis API, Virtual try-on API, Image editing API, and Video generative AI APIs.","siteUrl":"https://docs.perfectcorp.com","keywords":"AI Skin Analysis, AI Clothes, AI Hairstyle, AI Outfits","image":"/assets/favicon.cd6fa4d833b2a573b3c6dae68386b293da205b203402cb0c97b80bd2acc07ea2.8351e24f.png"},"dynamicMarkdocComponents":[],"metadata":{"type":"openapi","title":"ネイル再現","version":"","description":"# 概要\nネイル再現 API では、参照写真のネイルデザインを手の写真に転送します。\n\nジェルネイル、ネイルアート、ポリッシュ仕上げ、ラメ、シェルアクセント、メタリックテクスチャーなどのネイルスタイルをプレビューとして再現します。\n\n美容ブランド、サロン、ネイルアーティストで使えます。\n\n![](https://plugins-media.makeupar.com/smb/blog/post/2022-11-24/8821ab6e-9852-4401-89df-dd6005fb81fc.jpg)\n\n## 統合ガイド\nこのガイドでは、以下を説明します。\n\nネイル再現 API のワークフロー：\n\n**エンドポイント:** `/s2s/v2.0/task/ai-nail`\n\n**認証必須:** `Authorization: Bearer YOUR_API_KEY`\n\n**ワークフロー手順:**\n\n1. **画像アップロード準備:**\n- プロセスは、File API を使用して `/s2s/v2.0/file` に手の画像を準備することから始まります。\n\n2. **参照写真のアップロード:**\n- 希望するネイルデザインが写った参照写真を、File API を使用して `/s2s/v2.0/file` にアップロードします。すべての爪が明確に見えるようにしてください。\n\n1. **AI タスクの開始とタスク ID の取得:**\n- アップロードした画像を HTTP POST リクエストで `/s2s/v2.0/task/ai-nail` に送信します。\n- このインタラクションを識別する一意の `task_id` をレスポンスで待ちます。\n\n1. **タスクステータスのポーリング（継続的な確認）:**\n- 取得した `task_id` を使用して、HTTP GET リクエスト（例：`GET /task/${task_id}`）でタスクステータスを定期的にポーリングします。\n- 以下を継続的に監視します：\n- `Task_status = \"success\"`（処理完了）。\n- `Task_status = \"error\"`（該当する場合、解決または再試行）。\n- ステータスが success に遷移したら、ワークフローを適切に更新します。\n\nこのワークフローにより、タスクの監視と結果の取得を行います。\n\n---\n\n* 認証\n- リクエストヘッダーに **Bearer Token** を使用して API キーを含めます：\n```\nAuthorization: Bearer YOUR_API_KEY\n```\nAPI キーの確認場所: https://yce.makeupar.com/api-console/en/api-keys/.\n\n\n* 1. 画像のアップロード\n\nファイルをサーバーに直接アップロードするか、AI タスクペイロードに有効な画像 URL を指定します。\n\n* アップロードエンドポイント\n\n```\nPOST /s2s/v2.0/file\n```\n\nまたは、公開画像 URL が既に存在する場合は、この手順をスキップします。\n\n---\n\n* 2. 参照写真のアップロード\n\nファイルをサーバーに直接アップロードするか、AI タスクペイロードに有効な画像 URL を指定します。すべての爪が見えるようにしてください。\n\n* アップロードエンドポイント\n\n```\nPOST /s2s/v2.0/file\n```\n\n---\n\n* 3. ネイル再現 AI タスクの作成と結果のポーリング\n\n画像と完全なエフェクトペイロードが用意できたら、タスクを作成します。API はリクエストを非同期で処理します。ステータスが `success` または `error` になるまで、タスクステータスをポーリングします。\n\n* タスク作成エンドポイント\n\n```\nPOST /s2s/v2.0/task/ai-nail\n```\n\n* ポーリングエンドポイント\n\n```\nGET /s2s/v2.0/task/ai-nail/{task_id}\n```\n\n---\n\n## ファイル仕様とエラー\n\n* ネイル再現 仕様\n\n    **対応する手のビュー**\n\n    画像あたり最大 2 本の手に対応します。追加の手は無視されます。検出のため、各手が画像面積の少なくとも 0.5% を占める必要があります（FHD で約 102×102 px、2K で 139×139 px、4K 画像で 204×204 px）。\n\n    ![](https://plugins-media.makeupar.com/strapi/assets/small_webp_bare_nails_014_f6451b0343.png)\n\n\n    **対応する参照画像**\n\n    ![](https://plugins-media.makeupar.com/strapi/assets/small_webp_ref_6_341b11df3d.png)\n\n    ![](https://plugins-media.makeupar.com/strapi/assets/small_webp_ref_2_86a47c1c26.png)\n\n---\n\n* 対応フォーマットと寸法\n\n|AI 機能|対応寸法|対応ファイルサイズ|対応フォーマット|\n| ---- | ---- | ---- | ---- |\n| ネイル再現 | 長辺 <= 4096 | < 10MB | jpg/jpeg/png |\n\n* エラーコード\n\n| エラーコード | 説明 |\n| ---- | ---- |\n| exceed_max_filesize | 画像ファイルが大きすぎます |\n| invalid_parameter | 入力パラメータが不足しているか、形式が正しくありません |\n| error_download_image | ファイルアップロードが完了していないか、画像 URL が無効です |\n| error_inference | 推論に失敗しました。入力画像と参照画像がサポートされているか確認してください |\n| no_hand_detected | ソース画像で手が検出されませんでした |\n\n\n* 環境と依存関係\n\n| サンプルコード言語 / ツール | 推奨ランタイムバージョン |\n|---|---|\n| cURL | - bash >= 3.2</br>- curl >= 7.58 (モダンな TLS/HTTP サポート)</br>- jq >= 1.6 (堅牢な JSON 解析) |\n| Node.js (JavaScript) | Node >= 18 (グローバル fetch 用) |\n| JavaScript | - Chrome / Edge >= 80</br>- Firefox >= 74</br>- Safari >= 13.1 |\n| PHP | PHP >= 7.4 (モダンな TLS/互換性用), ext-curl (推奨) または allow_url_fopen=On + ext-openssl, ext-json |\n| Python | Python >= 3.10 (f-strings 用), requests >= 2.20.0 |\n| Java | Java 11+ (HttpClient 用), Jackson Databind >= 2.12.0 |\n\n---\n\n## ユニット消費量\n\n| AI 機能 | 消費ユニット |\n|---|---|\n| ネイル再現 V1.0 | 1 |\n\n---\n"},"compilationErrors":[],"markdown":{"partials":{},"variables":{"rbac":{"teams":["anonymous"]},"user":{},"remoteAddr":{"hostname":"docs.perfectcorp.com","port":4000,"ipAddress":"216.73.216.56"},"lang":"ja","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"master"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/ja/reference/ai_nail_transfer","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}