{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/ja/develop/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"FAQ","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":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"faq","__idx":0},"children":["FAQ"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Q: 'Unit' とは何を意味し、どのように使われますか？"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["A:"]}," Unit は YouCam API の操作に使用される通貨であることに注意してください。異なる AI 機能では異なる量のユニットが差し引かれます。本ドキュメントでは、Unit のコード名として \"Credit\" が使用されています。"," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Q: なぜ InvalidTaskId エラーが発生しますか？"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["A:"]}," タイムアウトしたタスクのステータスを確認すると、",{"$$mdtype":"Tag","name":"em","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["InvalidTaskId"]}]}," エラーが発生します。そのため、AI タスクを実行したら、ステータスが ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["success"]}," または ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["error"]}," のいずれかになるまで、",{"$$mdtype":"Tag","name":"em","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["polling_interval"]}]}," 内で ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ポーリング"]}," してステータスを確認する必要があります。"," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Q: どのように認証を行いますか？"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["A:"]}," API キーは、認証プロセスを完了するための ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Bearer Token"]}]}," です。",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Bearer Token"]}," を使用してリクエストヘッダーに API キーを含めます:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Authorization: Bearer YOUR_API_KEY\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["詳細やご質問については、",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.makeupar.com/consumer/blog"},"children":["ブログページ"]},"および ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://yce.makeupar.com/api-console/en/api-playground/ai-skin-analysis/"},"children":["API プレイグラウンド"]}," を参照してください。または ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"mailto:YouCamOnlineEditor_API@perfectcorp.com"},"children":["YouCamOnlineEditor_API@perfectcorp.com"]}," までメールをお送りください。カスタマーサクセスチームが喜んでお手伝いします。 ;)"," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Q: curl で画像をアップロードするには？"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["A:"]}," curl --location --request PUT '{url_api_response}' --header '{headers_in_api_response}' --data-binary @'{local_file_path}'"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"curl --location --request PUT 'https://example.com/sample-result-url' --header 'Content-Type: image/jpg' --header 'Content-Length: 50000'  --data-binary @'./test.jpg'\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Q: AI API はどのプラットフォームをサポートしていますか？モバイルデバイスで使用できますか？"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["A:"]}," AI API は異なるプラットフォーム間で動作します。標準的な RESTful API を基盤としているため、サーバー間通信、モバイルデバイス、Web ブラウザなどから使用できます。"," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Q: Flutter で Android と iOS の両方に AI API を使用できますか？"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["A:"]}," ","AI API は標準的な RESTful API なので、Flutter の組み込み HTTP API を使用してリクエストを送信できます。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ネットワーククエリに関する公式 Flutter ドキュメントをいくつか紹介します。"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["https://docs.flutter.dev/cookbook/networking/fetch-data"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["https://pub.dev/packages/http"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["次に、Flutter の http パッケージを使用して Bearer 認証で HTTP GET を呼び出すシンプルな方法です:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"dart","header":{"controls":{"copy":{}}},"source":"import 'dart:convert';\nimport 'package:http/http.dart' as http;\n\nFuture<void> fetchData() async {\n    String token = \"your_bearer_token_here\"; // Replace with your actual token\n\n    final response = await http.get(\n        Uri.parse(\"https://yce-api-01.makeupar.com/s2s/v2.0/task/ai-task\"), // Replace the `ai-task` with the AI feature you intend to use.\n        headers: {\n        \"Content-Type\": \"application/json\",\n        \"Authorization\": \"Bearer $token\",\n        },\n    );\n\n    if (response.statusCode == 200) {\n        print(\"Data fetched successfully: ${response.body}\");\n    } else {\n        print(\"Failed to fetch data: ${response.statusCode}\");\n    }\n}\n","lang":"dart"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["認証の主要な手順:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["トークンの取得 – SharedPreferences または他の安全なストレージ方法を使用して、トークンを保存・取得できます。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["ヘッダーにトークンを含める – リクエストヘッダーで \"Authorization\": \"Bearer $token\" を使用します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["期限切れトークンの処理 – API が 401 InvalidAccessToken エラーを返す場合、必要に応じてトークンを更新してください。"," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Q: API キーは API キーですが、シークレットキーはどこで見つかりますか？"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["A:"]}," シークレットキーは最初に生成したときのみ作成されます。そのため、すぐに保存してください。後ではもう表示されません。"," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Q: Wix を使用して AI API をウェブサイトへ統合できますか？"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["A:"]}," 現在、Wix で AI API を使用する公式統合ガイドはありません。ただし、RESTful API 自体は、標準的な Web クエリをサポートする限りプラットフォームに制限を課しません。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["まず Wix が提供する公式ドキュメントを読むことを推奨します: https://dev.wix.com/docs/develop-websites/articles/get-started/integrate-with-3rd-parties"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Wix は主にその Velo 開発プラットフォームを通じて、サードパーティ API との統合方法をいくつか提供しています:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Fetch API:"," ","これは最も一般的な方法で、標準的な JavaScript Fetch API の実装です。Wix サイトのフロントエンドまたはバックエンドコードから外部 API へ HTTP リクエストを送信できます。"," ","バックエンド呼び出し: セキュリティの観点（特にキーを必要とする API）および CORS 問題の回避のために推奨されます。API キーを安全に保存するには Secrets Manager を使用します。"," ","フロントエンド呼び出し: 可能ですがセキュリティが低く、CORS 制限に遭遇する場合があります。"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["npm パッケージ:"," ","Velo は承認された npm パッケージの使用をサポートしており、幅広い事前構築の JavaScript モジュールを活用してサードパーティ機能でサイトの機能を拡張できます。"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["サービスプラグイン（旧称 SPI / カスタムエクステンション）:"," ","これにより、カスタムロジックを注入したり、サードパーティサービスを Wix のビジネスソリューション（例: Wix Stores、Wix Bookings）に直接統合したりできます。サービスプラグインを使用すると、既存のアプリフローの一部をカスタマイズしたり、カスタム送料、動的価格設定、代替決済プロバイダーなどの機能のために外部サービスを統合したりできます。"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["HTTP 関数:"," ","サイトの機能を API として公開でき、サードパーティサービスが Wix サイトのバックエンド関数を呼び出し、サイトのデータやロジックとやり取りできるようになります。"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["統合の手順（Fetch API を例に）:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["API キーの保存: サードパーティ API が認証を必要とする場合、API キーなどの機密認証情報を Wix の Secrets Manager に安全に保存します。"," ","wix-fetch のインポート: Velo バックエンドまたはフロントエンドコードで wixFetch モジュールをインポートします。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"JavaScript","header":{"controls":{"copy":{}}},"source":"import { fetch } from 'wix-fetch';\n","lang":"JavaScript"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["API 呼び出しの実行: fetch 関数を使用して、必要なヘッダーとボディデータを含めてサードパーティ API へリクエストを送信します。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"JavaScript","header":{"controls":{"copy":{}}},"source":"export async function getWeatherData() {\n    const apiKey = await getSecret(\"yourApiKeyName\"); // Retrieve from Secrets Manager\n    const response = await fetch(`https://api.weatherapi.com/v1/current.json?key=${apiKey}&q=London`, {\n        method: 'GET',\n        headers: {\n            'Content-Type': 'application/json'\n        }\n    });\n    const data = await response.json();\n    return data;\n}\n","lang":"JavaScript"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["レスポンスの処理: API から受信したデータを処理し、サイトのデザインや機能に統合します。"," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Q: WooCommerce に AI API を統合できますか？"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["A:"]}," 現在、WooCommerce で AI API を使用する公式統合ガイドはありません。ただし、RESTful API 自体は、標準的な Web クエリをサポートする限りプラットフォームに制限を課しません。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["まず WooCommerce が提供する公式ドキュメントを読むことを推奨します: https://woocommerce.com/document/woocommerce-rest-api/"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["サードパーティ API を WooCommerce に統合できます:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["WooCommerce REST API の活用:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["WooCommerce は、外部アプリケーションがストアデータとやり取りできるようにする堅牢な REST API を提供しています。"," ","WooCommerce > 設定 > 高度な設定 > REST API で、特定の権限（Read、Write、または Read/Write）を持つ API キーを作成できます。"," ","これにより、カスタム統合を構築するか、この API を活用するサードパーティサービスを使用することで、在庫同期、注文処理、顧客データ同期などのタスクを自動化できます。"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["プラグインの利用:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["多くの WordPress および WooCommerce プラグインは、決済ゲートウェイ、配送業者、CRM システム、会計ソフトなどの人気サードパーティサービスとの統合を目的に設計されています。"," ","プラグインには事前構築の統合が提供されることが多く、セットアッププロセスが簡素化され、カスタムコーディングの必要性が減ります。"," ","例としては、特定の決済プロセッサ（Stripe、PayPal など）、配送ソリューション（FedEx、USPS など）のプラグインや、WPGet API のような一般的な API 統合ツールがあります。"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["カスタムコードと Webhook:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["独自の統合ニーズがある場合、または適切なプラグインがない場合は、WordPress テーマやカスタムプラグイン内でカスタムコードを実装できます。"," ","これは、WordPress / WooCommerce のフックとフィルターを使用して特定のイベントで API 呼び出しをトリガーすることを含みます（例: 購入後のアクション用の woocommerce_payment_complete）。"," ","Webhook を使用すると、特定のイベントが発生したときに（例: 新規注文、商品更新）、WooCommerce からサードパーティサービスへリアルタイムデータを送信することもできます。"," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]}]}]}]}]}]},"headings":[{"value":"FAQ","id":"faq","depth":1}],"frontmatter":{"seo":{"title":"FAQ"}},"lastModified":"2026-09-18T12:18:36.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ja/develop/faq","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}