# Run a Skin Analysis task.

Create a skin analysis task using either a file_id (from the File API) or a publicly accessible image URL.
The task will analyze various skin attributes based on the specified dst_actions.

Endpoint: POST /s2s/v2.0/task/skin-analysis
Security: BearerAuthenticationV2

## Request fields (application/json):

  - `dst_actions` (array, required)
    The actions for Skin Analysis.
There are 2 types of features: HD and SD.
You can choose one or more features, either all in SD or all in HD.
Note: HD and SD features cannot be mixed.
HD features:
  - hd_redness: Measures skin redness severity.
  - hd_oiliness: Determines skin oiliness level.
  - hd_age_spot: Detects age spots and pigmentation.
  - hd_radiance: Evaluates skin radiance.
  - hd_moisture: Assesses skin hydration levels.
  - hd_dark_circle: Analyzes the presence of dark circles under the eyes.
  - hd_eye_bag: Detects eye bags.
  - hd_droopy_upper_eyelid: Measures upper eyelid drooping severity.
  - hd_droopy_lower_eyelid: Measures lower eyelid drooping severity.
  - hd_firmness: Evaluates skin firmness and elasticity.
  - hd_texture: Analyzes overall skin texture.
  - hd_acne: Detects acne presence.
  - hd_pore: Detects and evaluates pores in different facial regions (forehead, nose, cheek, whole).
  - hd_wrinkle: Measures the severity of wrinkles in various facial areas (forehead, glabellar, crowfeet, periocular, nasolabial, marionette, whole).
  - hd_tear_trough: Detects tear trough.
  - hd_skin_type: Evalutate skin type.

SD features:
  - wrinkle: General wrinkle analysis.
  - droopy_upper_eyelid: Measures upper eyelid drooping severity.
  - droopy_lower_eyelid: Measures lower eyelid drooping severity.
  - firmness: Evaluates skin firmness and elasticity.
  - acne: Evaluates acne presence.
  - moisture: Measures skin hydration.
  - eye_bag: Detects eye bags.
  - dark_circle_v2: Analyzes dark circles.
  - age_spot: Detects age spots.
  - radiance: Evaluates skin brightness.
  - redness: Measures skin redness.
  - oiliness: Determines skin oiliness.
  - pore: Measures pore visibility.
  - texture: Analyzes overall skin texture.
  - tear_trough: Detects tear trough.
  - skin_type: Evalutate skin type.
    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_droopy_lower_eyelid", "hd_firmness", "hd_moisture", "hd_redness", "hd_tear_trough", "hd_skin_type", "wrinkle", "pore", "texture", "acne", "oiliness", "radiance", "eye_bag", "age_spot", "dark_circle_v2", "droopy_upper_eyelid", "droopy_lower_eyelid", "firmness", "moisture", "redness", "tear_trough", "skin_type"

  - `miniserver_args` (object)

  - `miniserver_args.enable_mask_overlay` (boolean)
    Controls whether the mask is blended onto the image. True returns the overlaid image as a .jpg. False returns the raw mask as a .png. Default is false.

  - `miniserver_args.enable_dark_background_hd_pore` (boolean)
    Enable dark background for HD pore visualization

  - `miniserver_args.color_dark_background_hd_pore` (string)
    Color for HD pore dark background visualization (hex format)
    Example: "3D3D3D"

  - `miniserver_args.opacity_dark_background_hd_pore` (number)
    Opacity for HD pore dark background visualization
    Example: 0.4

  - `miniserver_args.enable_dark_background_hd_wrinkle` (boolean)
    Enable dark background for HD wrinkle visualization

  - `miniserver_args.color_dark_background_hd_wrinkle` (string)
    Color for HD wrinkle dark background visualization (hex format)
    Example: "3D3D3D"

  - `miniserver_args.opacity_dark_background_hd_wrinkle` (number)
    Opacity for HD wrinkle dark background visualization
    Example: 0.4

  - `format` (string)
    Response format of the analysis results. Default is 'zip'. - zip: Results will be packaged as a downloadable ZIP file containing a skinanalysisResult folder with score_info.json and all detection result images. The response will include a URL to download the ZIP file. - json: Results will be returned directly in the response body as JSON format. Note: The response schema differs between format=json and format=zip.
    Enum: "json", "zip"

## Response 200 fields (application/json):

  - `status` (integer)
    Response status
    Example: 200

  - `data` (object)

  - `data.task_id` (string)
    ID of this task. Task result is valid to query by this ID for 24 hours.
    Example: "grH0CvsgXuAIHLUzD0V1Ol34hoet3R1tvdbtiVHrDb6_UqCLKIejAIajwxrhOAfe"

## Response 400 fields (application/json):

  - `status` (integer)
    Response status
    Example: 500

  - `error` (string)
    Example: "Task execution timed out"

## Response 401 fields (application/json):

  - `status` (integer)
    Response status
    Example: 401

  - `error` (string)
    Example: "Invalid API key"

## Response 429 fields (application/json):

  - `status` (integer)
    Response status
    Example: 429

  - `error` (string)
    Example: "Rate limit exceeded"