端點總覽

這是什麼。 一份由大型語言模型撰寫、用自然語言呈現的全方位肌膚報告。模型的輸入是您的精準 AI 肌膚檢測結果，再加上一個專業護膚參考資料庫。模型不是在猜您的膚況——它解讀的是實測、量化的肌膚指標與真實的偵測遮罩，把這些結果對照專業護膚資料之後，才在 llm_results.json 回傳一份完整的報告。

報告的各面向由哪些 dst_actions 支撐。 報告能寫多豐富，取決於您要求了哪些功能。dst_actions 為必填，而且同一個請求不可混用 HD 與 SD 功能——請選定其中一族。

報告面向	V2.1 功能	回傳的區域
臉部輪廓與五官定位	`pf_camera_kit: true`	—
膚質	`hd_skin_type`	`whole`, `t_zone`, `u_zone`
T 區與 U 區對比	`hd_skin_type`	`t_zone`, `u_zone`
額頭紋與眉間紋	`hd_wrinkle`	`forehead`, `glabellar`
魚尾紋與法令紋	`hd_wrinkle`	`crowfeet`, `nasolabial`
毛孔分佈	`hd_pore`	`forehead`, `nose`, `cheek`, `whole`
肌膚平滑度	`hd_texture`	`whole`

參數

欄位	類型	預設值	說明
`language`	string enum	`enu`	`enu` `cht` `jpn` `kor` `fra` `deu` `esn` `ita` `ptb` `ind` `ara`
`tone`	string enum	`warm`	`warm` \| `direct`——兩種語氣都維持專業
`country`	string	—	為報告加入氣候與季節脈絡
`city`	string	—	為報告加入氣候與季節脈絡

想全採預設值，就送 "advanced_report": {}；完全不要報告，就把整個物件省掉。

建立 AI 任務

# Skin Analysis with Advanced Skin Report
curl -sS -X POST "$BASE_URL/s2s/v2.1/task/skin-analysis-report" \
  -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_skin_type", "hd_wrinkle", "hd_pore", "hd_texture"],
    "format": "zip",
    "pf_camera_kit": true,
    "advanced_report": {
      "language": "cht",
      "tone": "direct",
      "country": "Taiwan",
      "city": "Taipei"
    }
  }'

# Same call, every report default (enu / warm, no climate context)
curl -sS -X POST "$BASE_URL/s2s/v2.1/task/skin-analysis-report" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "src_file_id": "your-uploaded-file-id",
    "dst_actions": ["hd_skin_type", "hd_wrinkle", "hd_pore", "hd_texture"],
    "pf_camera_kit": true,
    "advanced_report": {}
  }'

輪詢取得報告與推薦

每次呼叫都會立刻回傳一個 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-report" \
  -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-report/$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 來設定您的顯示尺寸。