YouCam Skills

將 YouCam AI 變成可直接套用的 Agent Skills。

YouCam Skills 將 Perfect Corp. 的 YouCam AI 能力，打包成可安裝到 agent 環境中的 skills。這代表使用者可以用自然語言觸發真實的 YouCam API：

「我的皮膚看起來怎麼樣？」
「在我身上試這個髮型。」
「讓我在影片中試穿這件外套。」

在背後，每個 skill 會處理 API 呼叫、任務建立、輪詢、費用檢查與結果回報。每個 skill 也可以直接從 CLI 執行，用於測試、自動化，或非 agent 的工作流程。

Skills

YouCam Skills 存放庫：https://github.com/YouCam-API/skills

安裝

若您的 agent 主機支援 Skills CLI，可直接從 GitHub 安裝：

npx skills add YouCam-API/skills

這會列出此存放庫中的六個 skills，讓您挑選要加入哪些，以及要加入您已安裝的哪些 agent（Claude Code、Cursor 等）。若要跳過提示，直接指定要加入的 skills 與/或特定 agent：

npx skills add YouCam-API/skills --skill skin-analysis-expert -a claude-code

或安裝全部內容，安裝到所有偵測到的 agent：

npx skills add YouCam-API/skills --all

此存放庫將 6 種以 AI 驅動的美容、儀容、頭髮、肌膚與時尚試穿體驗，以模組化的 Agent Skills 形式提供：

Skill	使用情境
Skin Analysis Expert	從一張自拍分析 16 項肌膚問題以及膚質。可選擇 HD/SD 細節，以及疊加或遮罩的視覺化方式。
Facial Consultant	讀取臉部顏色與比例，包含膚色、眼色、眉色、唇色、髮色、五官形狀，以及黃金比例測量。
Beauty Advisor	依據臉型與膚色推薦彩妝造型，並使用精選或自訂的美妝特效，將結果渲染到照片上。
Hair Color & Style Advisor	依據臉部特徵建議髮型與髮色，並使用範本、參考照片、色彩預設或自調色盤進行預覽。
Hair Diagnostics	評估髮量密度、髮質、毛躁度與髮長，並將發現彙整成一份報告。
Clothes Try-on Studio	在使用者照片上進行服飾虛擬試穿，可選擇更換背景，並產生轉動、走秀、擺pose 等短動態影片。

為什麼重要

對開發者而言：

YouCam API 的自然語言入口
可安裝的 skill 結構，適用於 agent 環境
以 CLI 為主的測試方式，使用 youcam_core.py
自動化的上傳 → 建立任務 → 輪詢流程
在呼叫付費 API 前，具備點數感知的執行檢查
簡易的擴充模型，便於新增或客製化 skills

對產品與行銷用途而言：

AI 美容、護膚、護髮與時尚試穿體驗
以使用者照片驅動的個人化推薦
使用者可立即理解的視覺預覽
明確的執行前費用溝通
針對 AI 生成結果，內建負責任使用的說明

運作方式

每個 skill 都遵循相同的工作流程：

使用者以一般語言描述需求。
Agent 選擇合適的 YouCam Skill。
Skill 詢問必要輸入，例如照片或目標動作。
Skill 在執行前檢查或估算點數成本。
隨附的腳本上傳媒體並建立 API 任務。
輪詢任務直到完成。
結果以結構化 JSON 回傳，並清楚摘要。

設定

需求：

Python 3
pip
YouCam API key
requests
PyYAML

在 skill 資料夾內執行：

python scripts/youcam_core.py setup

這會建立本地虛擬環境並安裝相依套件。

或者：

pip install -r scripts/requirements.txt

取得 API key：

https://yce.makeupar.com/api-console/

API Key 設定

youcam_core.py 依下列順序尋找憑證：

環境變數：

YOUCAM_API_KEY=your_key_here

skill 資料夾內的本地 credentials.json 檔案：

{
  "api_key": "your_key_here"
}

由於每個 skill 都有自己的資料夾，憑證是以 skill 為單位分別設定。

驗證您的金鑰並檢查餘額，不會消耗點數：

python scripts/youcam_core.py validate-key

執行前的費用檢查

在進行付費 API 呼叫之前，使用者或 agent 可以執行免費的預先檢查：

python scripts/youcam_core.py cost --feature skin-analysis
python scripts/youcam_core.py credits

兩個指令都是免費的，會回傳價格或餘額資訊。

這讓建立「點數感知」的工作流程更容易，讓使用者在消耗點數前先確認。

CLI 快速上手

直接執行一個 skill：

python scripts/youcam_core.py run \
  --feature skin-analysis \
  --src_file selfie.jpg \
  --param format=json \
  --param dst_actions='["hd_pore","hd_skin_type"]'

這會：

上傳來源圖片
建立 API 任務
輪詢完成狀態
輸出結構化 JSON

實用的旗標：

旗標	用途
`--feature`	選擇目標 YouCam 功能。
`--src_file`	主要輸入圖片/影片的本地路徑或網址。
`--ref_file`	選擇性的第二個輸入，例如服飾照片。
`--param`	可重複使用的鍵值 API 參數。
`--version`	需要時覆蓋預設的 API 版本。

支援的媒體格式通常為 JPG、JPEG 或 PNG。影片功能可能支援 MP4。此工具不會自動轉換檔案。

若輪詢停止後任務仍在執行中：

python scripts/youcam_core.py status \
  --feature skin-analysis \
  --task_id <task_id>

Agent 使用體驗

在支援 Skills 的 agent 環境中使用時，使用者不需要知道 API 名稱或參數。他們只需直接提出想要的結果：

「分析我的肌膚。」
「為我推薦一個髮型。」
「把這套衣服穿在我身上，並讓它動態起來。」
「從這張照片檢查我的頭髮健康狀況。」

agent 會選擇正確的 skill、收集必要輸入、確認費用、執行 API 工作流程，並回傳易於理解的結果。

重要說明

所有輸出皆為 AI 生成，僅供參考。它們不是醫療、皮膚科、美妝或專業造型建議。

結果品質取決於：

照片解析度
光線
臉部角度
影像清晰度
主體能見度
支援的輸入格式

某些 API 欄位偶爾可能無法取得。Skills 的設計是省略缺少的資料，而不是憑空產生數值。