执行「肤质分析 + 高级测肤报告 + 商品推荐」任务。

请求

AI 任务是异步处理的。功能支持 Webhook 时，优先用 Webhook 来接收完成通知。配置好您的 Webhook 端点、校验 Webhook 签名，收到 success 或 error 通知后，用收到的 task_id 查询任务结果。配置与校验的细节请见 Webhook 接入指南。

若功能不支持 Webhook，或您的接入方式用不了 Webhook，就请实现轮询。提交 AI 任务后，按固定间隔（例如每 10 秒）轮询状态接口，直到任务状态变为 success 或 error。

安全

BearerAuthenticationV2

正文application/json必需

Any of:

该对象表示一次 AI 肤质分析任务的运行。

dst_actionsArray of strings(RunSkincareTaskDstActions)必需

AI 肤质分析的分析项目。分析项目分为 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 的 URL。 - json：结果直接以 JSON 形式在响应体中返回。注意：format=json 与 format=zip 的响应结构不同。

Enum:"json""zip"

示例:"zip"

pf_camera_kitboolean

示例:true

advanced_reportobject(SkinAnalysisAdvancedReport)

高级测肤报告的选项，结果放在 llm_results.json 里返回。不传这个对象、或传一个空对象，就全部用默认值。

product_recommendationobject(SkinAnalysisProductRecommendation)

必填。从您的某个商品目录里推荐商品，结果放在 llm_results.json 里返回。

src_file_urlstring必需

用于运行任务的文件 URL，该 URL 需可公开访问。

示例:"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"
  }
}

执行「肤质分析 + 高级测肤报告 + 商品推荐」任务。

请求

响应

这有帮助吗？