跳转到内容
/
Analysis + Advanced Repor...

端點總覽

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

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

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

參數

欄位類型預設值說明
languagestring enumenuenu cht jpn kor fra deu esn ita ptb ind ara
tonestring enumwarmwarm | direct——兩種語氣都維持專業
countrystring—為報告加入氣候與季節脈絡
citystring—為報告加入氣候與季節脈絡

想全採預設值，就送 "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 來設定您的顯示尺寸。