AI Breast Augmentation Simulator

Integration Guide

This guide walks you through:

Workflow for AI Breast Augmentation Simulator API:

Endpoint: /s2s/v2.0/task/breast-shape

Authentication Required: Authorization: Bearer YOUR_API_KEY

Workflow Steps:

1. Image Upload Preparation:

   • The process begins with preparing a bust shot selfie.

2. AI Breast Augmentation Simulator Settings For AI Breast Augmentation Simulator, control the degree of enhancement by adjusting the intensity level, which ranges from 1 (subtle) to 3 (pronounced). Start with a lower setting and incrementally increase it to achieve a natural-looking result that aligns with your aesthetic preference. Gradual adjustment helps ensure realistic and proportionate outcomes.

3. Initiate AI Task and Obtain Task ID:

   • Send the uploaded image along with the parameter configuration via an HTTP POST request to /s2s/v2.0/file.
   • Await a unique task ID in the response, which identifies this interaction.

4. Poll Task Status (Continuous Check):

   • Use the obtained task_id to periodically poll the task status using an HTTP GET request (e.g., GET /task/${task_id}).
   • Continuously monitor for:
     • Task_status = "success" (process completed).
     • Task_status = "error" (resolve or retry if applicable).
   • Update the workflow accordingly once the status transitions to success.

This structured workflow ensures efficient integration with user inputs, automated monitoring of tasks, and seamless retrieval of results.

• Authentication

• Include your API key in the request header using Bearer Token:
  Authorization: Bearer YOUR_API_KEY

You can find your API Key at https://yce.makeupar.com/api-console/en/api-keys/.

• Upload an Image

You may upload a file directly to the server or provide a valid image URL in the AI task payload.

• Upload Endpoint

Alternatively, skip this step if you already have a public image URL.

• Adjust AI Breast Augmentation Simulator Intensity AI Breast Augmentation Simulator Settings

For AI Breast Augmentation Simulator, control the degree of modification by setting the intensity level between 1 and 3, where:

• Level 1 provides subtle, natural-looking adjustments ideal for minor refinement.
• Level 2 offers moderate enhancement, balancing realism with noticeable improvement.
• Level 3 delivers the most pronounced effect, suitable for significant reshaping while preserving anatomical plausibility.

Select the intensity level that best aligns with your aesthetic goals and desired look.

• Create a AI Breast Augmentation Simulator AI Task and Poll for Results

After uploading an image and selecting your preferred intensity level, you may proceed to start the enhancement task. The API processes the request asynchronously. You must poll the task status until it reaches success or error.

• Create Task Endpoint

• Polling Endpoint

File Specs & Errors

• AI Breast Augmentation Simulator Specification Image Requirements and Recommendations for Optimal Results

• Resolution Guidelines: The longest side of the input image must not exceed 4096 pixels. For best performance, ensure that the upper body region—defined as the area from the top of the head down to and including the chest—is rendered at a resolution of at least 1024 × 768 pixels.

• Subject Requirements:

  • The image must contain at least one fully detectable person. Both shoulders should be clearly visible in-frame.
  • The chest area must be visible. This includes both clothed and unclothed scenarios, provided the subject is facing primarily forward (i.e., yaw angle between −90° and +90°). A frontal view is strongly preferred over angled or profile poses.

• Recommended Practices for Enhanced Outcomes:

  • Prioritize upper-body composition: the image should either focus specifically on the upper body, or—if the full figure is included—the upper body region should occupy a substantial portion of the frame and exceed 1024 pixels in its longest dimension.
  • Use frontal poses exclusively; avoid side-facing or significantly rotated positions, as these reduce detection accuracy and result quality.
  • For the most natural-looking enhancement of the chest contour, select attire that exposes some skin around the bust area—such as swimwear, low-cut tops, or V-neck garments. These styles allow the AI to better infer underlying structure and produce subtle, realistic cleavage effects.
  • The system supports only single-subject images. In cases where multiple people appear in the frame, processing will automatically target the individual with the largest visible shoulder span (i.e., the person closest to or most centrally aligned with the camera).
  • Avoid occlusions over the chest region. Objects such as bags, backpack straps, scarves, necklaces, or other accessories may be incorrectly removed or cause artifacts during editing.
  • Clothing appearance may differ from the original image. The degree of modification depends on the intensity setting: higher enhancement levels produce more pronounced changes, including visible alterations to garment shape, fit, and drape around the chest area.

Following these guidelines ensures optimal input quality and maximizes the fidelity, realism, and consistency of the AI-generated enhancements.

• Supported Formats & Dimensions

• Error Codes

• Environment & Dependency