PEperfectcorp
Analysis + Product Recommendation

Run a Skin Analysis + Product Recommendation task.

Changed on

AI tasks are asynchronous. Prefer webhook-based completion handling when the feature supports webhooks. Configure your webhook endpoint, verify webhook signatures, and use the received task_id to query the task result after a success or error notification. See the webhook integration guide for setup and verification details.

If webhooks are not supported or cannot be used in your integration, implement polling. After submitting an AI task, poll the status endpoint at regular intervals (e.g., every 10 seconds) until the task status is success or error.

post/s2s/v2.1/task/skin-analysis-recommendation

Request

  • Base URL
    https://yce-api-01.makeupar.com
  • Auth
    HTTP bearer

Request body

OR

Example request

{
  "src_file_url": "https://example.com/selfie.jpg",
  "dst_actions": [
    "hd_wrinkle",
    "hd_pore",
    "hd_texture",
    "hd_acne"
  ],
  "miniserver_args": {
    "color_dark_background_hd_pore": "3D3D3D",
    "opacity_dark_background_hd_pore": 0.4,
    "color_dark_background_hd_wrinkle": "3D3D3D",
    "opacity_dark_background_hd_wrinkle": 0.4
  },
  "format": "zip",
  "pf_camera_kit": true,
  "product_recommendation": {
    "catalog_id": "123456789012345678",
    "top_n": 3
  }
}

Response

Successful execution of Skin Analysis + Product Recommendation task

statusinteger

Response status

Example response

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

Changes