{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/ja/develop/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"YouCam スキル","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":"youcam-スキル","__idx":0},"children":["YouCam スキル"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["YouCam AI をドロップイン型の Agent Skills に変える。"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["YouCam Skills は、Perfect Corp の YouCam AI 機能をエージェント環境向けにインストール可能なスキルとしてパッケージ化します。つまり、ユーザーは自然言語で実際の YouCam API をトリガーできます:"]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["「私の肌はどんな状態ですか？」",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"「この髪型を私に試着して。」",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"「このジャケットを動画で試着させて。」"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["裏側では、各スキルが API 呼び出し、タスク作成、ポーリング、コストチェック、結果レポートを処理します。すべてのスキルはテスト、自動化、非エージェントのワークフローのために CLI から直接実行することもできます。"]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"スキル","__idx":1},"children":["スキル"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["YouCam Skills リポジトリ: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/YouCam-API/skills"},"children":["https://github.com/YouCam-API/skills"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"インストール","__idx":2},"children":["インストール"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["エージェントホストが ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/vercel-labs/skills"},"children":["Skills CLI"]}," をサポートしている場合、"," ","GitHub から直接インストールできます:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"npx skills add YouCam-API/skills\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["これにより、このリポジトリの 6 つのスキルがリスト表示され、追加するものを選択できます。次に、"," ","インストールしたエージェント（Claude Code、Cursor など）のどれに追加するかを尋ねられます。プロンプトをスキップするには、特定の"," ","スキルと/または特定のエージェントを直接指定します:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"npx skills add YouCam-API/skills --skill skin-analysis-expert -a claude-code\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["または、検出されたすべてのエージェントにすべてインストールします:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"npx skills add YouCam-API/skills --all\n"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["このリポジトリは、AI によるビューティー、グルーミング、ヘア、スキン、ファッションの試着体験を 6 つ、モジュール化された Agent Skills として公開しています:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"スキル"},"children":["スキル"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"ユースケース"},"children":["ユースケース"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Skin Analysis Expert"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1 枚のセルフィーから 16 の肌悩みと肌タイプを分析します。HD/SD の詳細度と、オーバーレイまたはマスクの可視化を選択できます。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Facial Consultant"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["顔の色や比率を読み取ります。肌のトーン、目の色、眉の色、唇の色、髪の色、パーツの形、黄金比の測定値を含みます。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Beauty Advisor"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["顔の形と肌のトーンに基づいてメイクルックを提案し、キュレーションまたはカスタムのビューティーエフェクトを使用して結果を写真にレンダリングします。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Hair Color & Style Advisor"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["顔の特徴からヘアスタイルとカラーを提案し、テンプレート、参考写真、カラープリセット、カスタムパレットでプレビューできます。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Hair Diagnostics"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["髪の密度、タイプ、うねり、長さを評価し、結果を 1 つのレポートにまとめます。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Clothes Try-on Studio"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ユーザーの写真でのバーチャル服装試着。背景の置換や、ターン、ランウェイウォーク、ポーズなどの短いモーション動画もオプションで対応します。"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"なぜ重要なのか","__idx":3},"children":["なぜ重要なのか"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["開発者向け:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["YouCam API の自然言語エントリポイント"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["エージェント環境向けのインストール可能なスキル構造"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["youcam_core.py"]}," による CLI ファーストのテスト"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["アップロード → タスク作成 → ポーリングの自動フロー"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["有料 API 呼び出し前のクレジットを考慮した実行"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["スキルの追加やカスタマイズのためのシンプルな拡張モデル"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["プロダクトおよびマーケティング用途:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["AI によるビューティー、スキンケア、ヘアケア、ファッションの試着体験"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["ユーザーの写真に基づくパーソナライズされた提案"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["ビジュアルプレビュー"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["実行前の明確なコストコミュニケーション"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["AI 生成結果に関する責任ある利用のメッセージを内蔵"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"動作原理","__idx":4},"children":["動作原理"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["各スキルは同じワークフローに従います:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["ユーザーが普段の英語でリクエストを説明します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["エージェントが適切な YouCam スキルを選択します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["スキルが写真やターゲットアクションなどの必須入力を求めます。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["スキルが実行前にクレジットコストを確認または見積もります。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["同梱のスクリプトがメディアをアップロードし、API タスクを作成します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["タスクは完了するまでポーリングされます。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["結果は構造化 JSON で返され、明確に要約されます。"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"セットアップ","__idx":5},"children":["セットアップ"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["要件:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Python 3"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["pip"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["YouCam API キー"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requests"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PyYAML"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["スキルフォルダ内で次を実行します:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"python scripts/youcam_core.py setup\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["これによりローカルの仮想環境が作成され、依存関係がインストールされます。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["または:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"pip install -r scripts/requirements.txt\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["API キーの取得先:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["https://yce.makeupar.com/api-console/"]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"api-キーの設定","__idx":6},"children":["API キーの設定"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["youcam_core.py"]}," はこの順序で認証情報を検索します:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["環境変数:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"YOUCAM_API_KEY=your_key_here\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":2},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["スキルフォルダ内のローカル ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["credentials.json"]}," ファイル:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"api_key\": \"your_key_here\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["各スキルは独自のフォルダを持つため、認証情報はスキルごとに設定されます。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["クレジットを消費せずにキーを検証し、残高を確認します:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"python scripts/youcam_core.py validate-key\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"実行前のコストチェック","__idx":7},"children":["実行前のコストチェック"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["有料 API 呼び出しを行う前に、ユーザーまたはエージェントが無償の事前チェックを実行できます:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"python scripts/youcam_core.py cost --feature skin-analysis\npython scripts/youcam_core.py credits\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["両方のコマンドは無償で、料金または残高情報を返します。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["これにより、支出前にユーザーが確認するクレジットを考慮したワークフローの構築が容易になります。"]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"cli-クイックスタート","__idx":8},"children":["CLI クイックスタート"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["スキルを直接実行します:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"python scripts/youcam_core.py run \\\n  --feature skin-analysis \\\n  --src_file selfie.jpg \\\n  --param format=json \\\n  --param dst_actions='[\"hd_pore\",\"hd_skin_type\"]'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["これにより:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["ソース画像をアップロード"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["API タスクを作成"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["完了までポーリング"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["構造化 JSON 出力を表示"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["便利なフラグ:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"フラグ"},"children":["フラグ"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"目的"},"children":["目的"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--feature"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ターゲットの YouCam 機能を選択します。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--src_file"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["主な入力画像/動画へのローカルパスまたは URL。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--ref_file"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["衣服の写真などの任意の第 2 の入力。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--param"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["繰り返し指定可能なキーバリュー形式の API パラメータ。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--version"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["必要に応じてデフォルトの API バージョンを上書きします。"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["サポートされるメディア形式は通常 JPG、JPEG、PNG です。動画機能では MP4 が受け入れられる場合があります。このツールはファイルを自動的に変換しません。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ポーリングが停止した後もタスクが実行中の場合:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"python scripts/youcam_core.py status \\\n  --feature skin-analysis \\\n  --task_id <task_id>\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"エージェント体験","__idx":9},"children":["エージェント体験"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Skills をサポートするエージェント環境内で使用する場合、ユーザーは API 名やパラメータを知る必要はありません。単に結果を依頼するだけです:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["「私の肌を分析して。」"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["「私に合った髪型を提案して。」"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["「この服装を私に着せて、動かせて。」"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["「この写真から髪の健康状態をチェックして。」"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["エージェントが適切なスキルを選択し、必須入力を収集し、コストを確認し、API ワークフローを実行し、理解しやすい結果を返します。"]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"重要な注意事項","__idx":10},"children":["重要な注意事項"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["すべての出力は AI によって生成され、参考用です。医療的、皮膚科的、美容的、プロのスタイリングに関する助言ではありません。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["結果の品質は以下に依存します:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["写真の解像度"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["ライティング"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["顔の角度"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["画像の鮮明さ"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["被写体の見え方"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["サポートされる入力形式"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["一部の API フィールドは時々利用できない場合があります。スキルは値を捏造するのではなく、欠損データを省略するように設計されています。"]}]},"headings":[{"value":"YouCam スキル","id":"youcam-スキル","depth":1},{"value":"スキル","id":"スキル","depth":2},{"value":"インストール","id":"インストール","depth":2},{"value":"なぜ重要なのか","id":"なぜ重要なのか","depth":2},{"value":"動作原理","id":"動作原理","depth":2},{"value":"セットアップ","id":"セットアップ","depth":2},{"value":"API キーの設定","id":"api-キーの設定","depth":2},{"value":"実行前のコストチェック","id":"実行前のコストチェック","depth":2},{"value":"CLI クイックスタート","id":"cli-クイックスタート","depth":2},{"value":"エージェント体験","id":"エージェント体験","depth":2},{"value":"重要な注意事項","id":"重要な注意事項","depth":2}],"frontmatter":{"seo":{"title":"YouCam スキル"}},"lastModified":"2026-09-18T12:18:36.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ja/develop/agent_skills","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}