Skip to content

AI Makeup Virtual Try-On API (v1.8) (1.0.0)

The AI Makeup API provides a powerful, hyper-realistic virtual makeover experience powered by patented face-analyzing technology. This service enables applications to apply true-to-life makeup effects onto user-provided selfie images with unprecedented customization capabilities.

Download OpenAPI description
makeup_vto.json
makeup_vto.yaml
Languages
Servers
Production server
https://api.example.com/v2.0

Apply virtual makeup to a photo

Request

Apply hyper-realistic makeup effects to user photos with customizable options.

Key Features:

  • Hyper-realistic Rendering: Leverages revolutionary 3D face AI technology
  • Patented Technology: Powered by jitter-free, lag-free deep learning algorithms
  • Real-time Precision: Ultra-precise facial tracking
  • True-to-life Matching: Accurately matches real-world product colors and textures
Bodyapplication/jsonrequired
One of:
src_file_urlstringrequired

URL of the file to process. The URL should be publicly accessible.

Example: "https://example.com/selfie.jpg"
versionstring

Version of the makeup effect specification.

Default "1.0"
Example: "1.0"
effectsArray of SkinSmoothEffect (object) or BlushEffect (object) or BronzerEffect (object) or ConcealerEffect (object) or ContourEffect (object) or EyebrowsEffect (object) or EyelinerEffect (object) or EyeshadowEffect (object) or EyelashesEffect (object) or FoundationEffect (object) or HighlighterEffect (object) or LipColorEffect (object) or LipLinerEffect (object)required

Array of makeup effects to apply. Each effect object MUST specify a category and match the schema for that makeup type.

One of:
effects[].​categorystringrequired

Must always be "skin_smooth"

Value"skin_smooth"
effects[].​skinSmoothStrengthinteger[ 0 .. 100 ]

Strength of smoothing applied to overall skin texture

Default 50
effects[].​skinSmoothColorIntensityinteger[ 0 .. 100 ]

Intensity of color blending applied during smoothing

Default 50
curl -i -X POST \
  https://api.example.com/v2.0/task/makeup-vto \
  -H 'Content-Type: application/json' \
  -d '{
    "src_file_id": "pfNK5PuRe0MrwLHcGA3DOmB1ahwfXTbYHjv+KoBIxbE=",
    "version": "1.0",
    "effects": [
      {
        "category": "skin_smooth",
        "skinSmoothStrength": 50,
        "skinSmoothColorIntensity": 50
      }
    ]
  }'

Responses

Task created successfully

Bodyapplication/json
task_idstring

Unique identifier for the task

statusstring
Enum"pending""processing""completed""failed"
resultsobject
Response
application/json
{
  "task_id": "string",
  "status": "pending",
  "results": {
    "url": "string"
  }
}