執行「肌膚檢測＋進階肌膚報告＋產品推薦」任務。

请求

AI 任務是非同步的。當功能支援 webhook 時，請優先使用以 webhook 為基礎的完成處理。設定您的 webhook 端點、驗證 webhook 簽章，並在收到 success 或 error 通知後，使用收到的 task_id 查詢任務結果。設定與驗證細節請見 webhook 整合指南。

若您的整合不支援 webhook 或無法使用 webhook，請實作輪詢。送出 AI 任務後，以固定間隔（例如每 10 秒）輪詢狀態端點，直到任務狀態為 success 或 error。

安全

BearerAuthenticationV2

正文application/json必需

Any of:

這個物件代表一個執行肌膚檢測任務。

dst_actionsArray of strings(RunSkincareTaskDstActions)必需

肌膚檢測的動作項目。共有 2 種功能類型：HD 與 SD。您可選擇一項或多項功能，但必須全部為 SD 或全部為 HD。注意：HD 與 SD 功能不可混合。 HD 功能：

hd_redness：測量泛紅嚴重程度。
hd_oiliness：判斷油脂程度。
hd_age_spot：偵測老化斑與色素沉著。
hd_radiance：評估肌膚光澤。
hd_moisture：評估肌膚含水量。
hd_dark_circle：分析眼部周圍的黑眼圈。
hd_eye_bag：偵測眼袋。
hd_droopy_upper_eyelid：測量上眼皮下垂嚴重程度。
hd_droopy_lower_eyelid：測量下眼皮下垂嚴重程度。
hd_firmness：評估肌膚緊實度與彈性。
hd_texture：分析整體肌膚質地。
hd_acne：偵測痤瘡。
hd_pore：偵測並評估不同臉部區域的毛孔（額頭、鼻子、臉頰、全臉）。
hd_wrinkle：測量各臉部區域的皺紋嚴重程度（額頭、眉間、魚尾紋、眼周、法令紋、木偶紋、全臉）。
hd_tear_trough：偵測淚溝。
hd_skin_type：子類別（全臉、T 區、U 區）評估膚質為正常、油性、乾性、混合性、泛紅、乾性且泛紅、油性且泛紅，或混合性且泛紅。

SD 功能：

wrinkle：一般皺紋分析。
droopy_upper_eyelid：測量上眼皮下垂嚴重程度。
droopy_lower_eyelid：測量下眼皮下垂嚴重程度。
firmness：評估肌膚緊實度與彈性。
acne：評估痤瘡。
moisture：測量肌膚含水量。
eye_bag：偵測眼袋。
dark_circle_v2：分析黑眼圈。
age_spot：偵測老化斑。
radiance：評估肌膚明亮度。
redness：測量泛紅程度。
oiliness：判斷油脂程度。
pore：測量毛孔可見度。
texture：分析整體肌膚質地。
tear_trough：偵測淚溝。
skin_type：子類別（全臉、T 區、U 區）評估膚質為正常、油性、乾性、混合性、泛紅、乾性且泛紅、油性且泛紅，或混合性且泛紅。

Items Enum:"hd_wrinkle""hd_pore""hd_texture""hd_acne""hd_oiliness""hd_radiance""hd_eye_bag""hd_age_spot""hd_dark_circle""hd_droopy_upper_eyelid"

示例:

[
  "hd_wrinkle",
  "hd_pore",
  "hd_texture",
  "hd_acne"
]

miniserver_argsobject(RunSkincareTaskMiniserverArgs)

formatstring

分析結果的回應格式。預設為 'zip'。- zip：結果會被打包成可下載的 ZIP 檔案，內含 skinanalysisResult 資料夾，包含 score_info.json 與所有偵測結果圖片。回應會包含下載該 ZIP 檔案的網址。- json：結果會以 JSON 格式直接回傳在回應內容中。請注意：format=json 與 format=zip 的回應 schema 不同。

Enum:"json""zip"

示例:"zip"

pf_camera_kitboolean

示例:true

advanced_reportobject(SkinAnalysisAdvancedReport)

進階肌膚報告的選項，結果放在 llm_results.json 回傳。不送這個物件、或送一個空物件，即採用全預設值。

product_recommendationobject(SkinAnalysisProductRecommendation)

必填。從您的某個產品目錄中推薦產品，結果放在 llm_results.json 回傳。

src_file_urlstring必需

要執行任務的檔案網址。該網址應可公開存取。

示例:"https://example.com/selfie.jpg"

curl -i -X POST \
  https://yce-api-01.makeupar.com/s2s/v2.1/task/skin-analysis-report-recommendation \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "src_file_url": "https://example.com/selfie.jpg",
    "dst_actions": [
      "hd_wrinkle",
      "hd_pore",
      "hd_texture",
      "hd_acne"
    ],
    "miniserver_args": {
      "enable_mask_overlay": true,
      "enable_dark_background_hd_pore": true,
      "color_dark_background_hd_pore": "3D3D3D",
      "opacity_dark_background_hd_pore": 0.4,
      "enable_dark_background_hd_wrinkle": true,
      "color_dark_background_hd_wrinkle": "3D3D3D",
      "opacity_dark_background_hd_wrinkle": 0.4
    },
    "format": "zip",
    "pf_camera_kit": true,
    "advanced_report": {
      "language": "cht",
      "tone": "direct",
      "country": "Taiwan",
      "city": "Taipei"
    },
    "product_recommendation": {
      "catalog_id": "123456789012345678",
      "top_n": 3
    }
  }'

响应

「肌膚檢測＋進階肌膚報告＋產品推薦」任務執行成功

正文application/json

statusinteger

回應狀態

示例:200

dataobject

响应

{
  "status": 200,
  "data": {
    "task_id": "grH0CvsgXuAIHLUzD0V1Ol34hoet3R1tvdbtiVHrDb6_UqCLKIejAIajwxrhOAfe"
  }
}

執行「肌膚檢測＋進階肌膚報告＋產品推薦」任務。

请求

响应

这有帮助吗？