{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/zh-TW/develop/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"YouCam Skills","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-skills","__idx":0},"children":["YouCam Skills"]},{"$$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 能力，打包成可安裝到 agent 環境中的 skills。這代表使用者可以用自然語言觸發真實的 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":["在背後，每個 skill 會處理 API 呼叫、任務建立、輪詢、費用檢查與結果回報。每個 skill 也可以直接從 CLI 執行，用於測試、自動化，或非 agent 的工作流程。"]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"skills","__idx":1},"children":["Skills"]},{"$$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":["若您的 agent 主機支援 ",{"$$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":["這會列出此存放庫中的六個 skills，讓您挑選要加入哪些，以及要加入您已安裝的哪些 agent（Claude Code、Cursor 等）。若要跳過提示，直接指定要加入的 skills 與/或特定 agent："]},{"$$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":["或安裝全部內容，安裝到所有偵測到的 agent："]},{"$$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":["此存放庫將 6 種以 AI 驅動的美容、儀容、頭髮、肌膚與時尚試穿體驗，以模組化的 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":"Skill"},"children":["Skill"]},{"$$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":["從一張自拍分析 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":["評估髮量密度、髮質、毛躁度與髮長，並將發現彙整成一份報告。"]}]},{"$$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":["在使用者照片上進行服飾虛擬試穿，可選擇更換背景，並產生轉動、走秀、擺pose 等短動態影片。"]}]}]}]}]},{"$$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":["可安裝的 skill 結構，適用於 agent 環境"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["以 CLI 為主的測試方式，使用 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["youcam_core.py"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["自動化的上傳 → 建立任務 → 輪詢流程"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["在呼叫付費 API 前，具備點數感知的執行檢查"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["簡易的擴充模型，便於新增或客製化 skills"]}]},{"$$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":["每個 skill 都遵循相同的工作流程："]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["使用者以一般語言描述需求。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Agent 選擇合適的 YouCam Skill。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Skill 詢問必要輸入，例如照片或目標動作。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Skill 在執行前檢查或估算點數成本。"]},{"$$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 key"]},{"$$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":["在 skill 資料夾內執行："]},{"$$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 key："]},{"$$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-key-設定","__idx":6},"children":["API Key 設定"]},{"$$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":["skill 資料夾內的本地 ",{"$$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":["由於每個 skill 都有自己的資料夾，憑證是以 skill 為單位分別設定。"]},{"$$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 呼叫之前，使用者或 agent 可以執行免費的預先檢查："]},{"$$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":["直接執行一個 skill："]},{"$$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":["主要輸入圖片/影片的本地路徑或網址。"]}]},{"$$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":["選擇性的第二個輸入，例如服飾照片。"]}]},{"$$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":"agent-使用體驗","__idx":9},"children":["Agent 使用體驗"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["在支援 Skills 的 agent 環境中使用時，使用者不需要知道 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":["agent 會選擇正確的 skill、收集必要輸入、確認費用、執行 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 欄位偶爾可能無法取得。Skills 的設計是省略缺少的資料，而不是憑空產生數值。"]}]},"headings":[{"value":"YouCam Skills","id":"youcam-skills","depth":1},{"value":"Skills","id":"skills","depth":2},{"value":"安裝","id":"安裝","depth":2},{"value":"為什麼重要","id":"為什麼重要","depth":2},{"value":"運作方式","id":"運作方式","depth":2},{"value":"設定","id":"設定","depth":2},{"value":"API Key 設定","id":"api-key-設定","depth":2},{"value":"執行前的費用檢查","id":"執行前的費用檢查","depth":2},{"value":"CLI 快速上手","id":"cli-快速上手","depth":2},{"value":"Agent 使用體驗","id":"agent-使用體驗","depth":2},{"value":"重要說明","id":"重要說明","depth":2}],"frontmatter":{"seo":{"title":"YouCam Skills"}},"lastModified":"2026-10-30T07:26:32.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/zh-tw/develop/agent_skills","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}