端點總覽

這是什麼。 標準肌膚檢測針對您選定的肌膚困擾，給出客觀、可量化的分數，並附上精準的偵測遮罩與熱圖。

運用先進的 AI 深度學習與臉部區域分割技術，Perfect Corp AI 肌膚檢測不必接觸皮膚，就能從數位影像評估可見的肌膚狀況。方案會輸出量化分數、偵測遮罩、熱圖與 AR 疊加效果，用個人化的肌膚洞察幫使用者更了解自己的膚況，並據此打造屬於每個人的護膚流程。

支援的肌膚困擾包括：
- 皺紋
- 含水量
- 緊實度
- 上眼皮下垂
- 下眼皮下垂
- 毛孔
- 質地
- 痤瘡
- 油脂
- 斑點
- 黑眼圈
- 光澤
- 泛紅
- 眼袋
- 淚溝

此外還會輸出膚質、推估的肌膚年齡與整體膚況分數。所有結果都是出自影像的指標，僅供護膚參考，不構成臨床測量、診斷或醫學評估。

建立 AI 任務

# Standard Skin Analysis V2.1
curl -sS -X POST "$BASE_URL/s2s/v2.1/task/skin-analysis" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "src_file_url": "https://your-cdn.example.com/customer-001.jpg",
    "dst_actions": ["hd_wrinkle", "hd_pore", "hd_texture", "hd_acne"],
    "format": "zip",
    "pf_camera_kit": true
  }'

輪詢取得報告與推薦

每次呼叫都會立刻回傳一個 BasicRunTaskResponseV2；用回傳的 id 輪詢任務就行，報告與推薦結果都放在 llm_results.json 裡。

# 1. Run the task and capture the task id
TASK_ID=$(curl -sS -X POST "$BASE_URL/s2s/v2.1/task/skin-analysis" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ ... }' | jq -r '.data.task_id')

# 2. Poll until task_status is "success"
curl -sS -H "Authorization: Bearer $API_KEY" \
  "$BASE_URL/s2s/v2.1/task/skin-analysis/$TASK_ID"

task_status 會從 running 走到 success | error。用 format: zip 時，results.url 是一條有效期限 2 小時的下載連結，ZIP 裡有一個 skinanalysisResult 資料夾，包含 score_info.json 與所有偵測結果圖片。用 format: json 時，results.output 會把分數直接回傳在回應內容中。

請求欄位速查

欄位	必填	說明
`src_file_id` / `src_file_url`	是（二者其一）	輸入圖片，規則依 `BasicRunTaskV2`
`dst_actions`	是	要全選 HD 功能，或全選 SD 功能——不可混用
`format`	否	`zip`（預設）\| `json`——兩者的回應 schema 不同
`pf_camera_kit`	否	V2.1 新增；臉部輪廓與五官定位
`miniserver_args`	否	遮罩疊加，以及 HD 毛孔／皺紋的背景控制項
`advanced_report`	否	有送就出報告；`{}` 表示全採預設值；不送就沒有報告
`product_recommendation`	否	有送就出推薦；需要 `catalog_id`

解析度。 所有輸出圖片的長邊都以 2560 px 為上限，輸入圖片會自動調整尺寸。若 enable_mask_overlay 為 false，您拿到的是原始遮罩 .png，必須自行合成——請先確認輸入解析度，長邊超過 2560 px 時，就以 2560 px 來設定您的顯示尺寸。