AI Body Reshape
AI Body Reshape API for Body Reshape & Slimming Feel confident in photos with an AI body editor! Slim, reshape, and enhance your body for natural, stunning proportions. Effortlessly reshape any area — waist, arms, thighs, chest, and more. Get natural, stunning results in just a tap!
This guide walks you through:
Workflow for AI Body Reshape API:
Endpoint: /s2s/v2.0/task/body-reshape
Authentication Required: Authorization: Bearer YOUR_API_KEY
Workflow Steps:
Image Upload Preparation:
- Prepare a selfie image for upload.
- Call the File API
/s2s/v2.0/fileto obtain the upload URL and associatedfile_id. - Upload the selfie image using the provided upload URL.
Optional Preprocessing For Group Photos:
- Preprocess the selfie image if there are more than one person in the image.
Body Reshape Effect Setup:
- Begin by selecting suitable body reshape parameters.
Initiate AI Task and Obtain Task ID:
- Send the
file_idalong with the chosen effect configuration via an HTTP POST request to/s2s/v2.0/task/body-reshape. - Await a unique task ID in the response, which identifies this interaction.
- Send the
Poll Task Status (Continuous Check):
- Use the obtained
task_idto periodically poll the task status using an HTTP GET request (e.g.,GET /s2s/v2.0/task/body-reshape/${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.
- Use the obtained
This structured workflow ensures efficient integration with user inputs, automated monitoring of tasks, and seamless retrieval of results.
- API Playground
Interactively explore and test the API using our official playground:
- Authentication
- Include your API key in the request header using Bearer Token:
Authorization: Bearer YOUR_API_KEYYou 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
POST /s2s/v2.0/fileAlternatively, skip this step if you already have a public image URL.
- Prepare an effect template
Preprocessing Output detected bounding boxes in pixel coordinate. Use the index of result to create a Body Reshape AI task later.
{
"timed": number,
"result": [
{
"left": number,
"top": number,
"width": number,
"height": number
}
]
}- Effect Template JSON Schemas
{
"version": "1.0",
"index": 0,
"features": {
"arm": 0, // -100~100
"breast_left": 0, // -100~100
"breast_right": 0, // -100~100
"hip": 0, // -100~100
"hip_lift": 0, // -100~100
"leg": 0, // -100~100
"neck_left": 0, // 0~100
"neck_right": 0, // 0~100
"shoulder_left": 0, // -100~100
"shoulder_right": 0, // -100~100
"squared_shoulder_left": 0, // -100~100
"squared_shoulder_right": 0, // -100~100
"slim": 0, // -100~100
"taller": 0, // 0~100
"waist": 0, // -100~100
"belly": 0 // -100~100
}
}index: index of detected body from preprocessing. optional, default 0. features: required at least 1, non-zero body reshape parameter, cannot be all zero.
- Example Payload (ready to send)
{
"src_file_url": "https://plugins-media.makeupar.com/strapi/assets/body_reshape_02_7777218379.jpg",
"version": "1.0",
"index": 0,
"features": {
"arm": 0,
"waist": -20,
"taller": 80,
"squared_shoulder_left": 10,
"squared_shoulder_right": 10,
"neck_left": 0,
"neck_right": 0,
"hip": 10,
"breast_left": 30,
"breast_right": 30,
"slim": -70,
"shoulder_left": 30,
"shoulder_right": 30,
"leg": -30,
"hip_lift": 0,
"belly": -50
}
}- Create a Body Reshape AI Task and Poll for Results
Once you have an image and a complete effect payload, create a task. The API processes the request asynchronously. You must poll the task status until it reaches success or error.
- Create Task Endpoint
POST /s2s/v2.0/task/body-reshape- Polling Endpoint
GET /s2s/v2.0/task/body-reshape/{task_id}- AI Body Reshape Specification
Supported Selfie View Full body shot with clear facial expression and body posture visible.
Visibility & Pose Requirements
| Region | What must be true in the source image |
|---|---|
| Neck | The neck must be visible in the source image. |
| Arm | Both arms – upper arm, forearm and hand – have to be fully shown. |
| Leg | The whole leg must appear in the picture. |
| Hip | Hips need to be in view. |
| Hip‑Lift | Hips need to be in view. |
| Shoulder | • Shoulders are required to be seen. • Raising a hand is not allowed. • A 90° side pose is not allowed. |
| Belly | The belly is required to be visible. |
| Waist | Waist must be visible. |
| Breast | • Breast area must appear in the picture. • The shot should include the hips (i.e., not a “half‑body without hips”). • The middle of the breast must be shown. |
| Slim | Shoulders need to be in the frame. |
| Taller | • Hips must appear. • A half‑body view should include the legs (i.e., legs are visible). |
Body Reshape Customization Parameters Guide
| Category | Parameter | Function | Min Value (-100 / 0) | Max Value (100) |
|---|---|---|---|---|
| Arms | Intensity | Adjusts the thickness of the arms | Thin | Thick |
| Belly | Intensity | Adjusts abdominal projection | Flat | Protruding |
| Chest | Intensity (Left / Right) | Adjusts chest volume on each side | Flat | Full |
| Hip Lift | Intensity | Adjusts the curvature and lift of the hips (adds a butt‑lifting effect) | Sculpted (lifted and tightened) | Rounded (lifted with fuller volume) |
| Hip Size | Intensity | Adjusts the overall width of the hips | Narrow | Wide |
| Legs | Intensity | Adjusts the thickness of the legs | Thin | Thick |
| Neck | Intensity (Left / Right) | Adjusts neck contour and slimming per side | Original (0) | Tucked in |
| Shoulder Width | Intensity (Left / Right) | Adjusts the span of each shoulder | Narrow | Broad |
| Shoulder Shape | Intensity (Left / Right) | Adjusts the angle and slope of each shoulder | Sloped | Squared |
| Slim | Intensity | Adjusts overall body curvature | Slim | Curvy |
| Tall | Intensity | Adjusts the overall character height | Original (0) | Taller |
| Waist | Intensity | Adjusts the width of the waistline | Narrow | Wide |
Note: “Left” and “Right” refer to the character's perspective, not the viewer's side of the screen.
- Supported Formats & Dimensions
| AI Feature | Supported Dimensions | Supported File Size | Supported Formats |
|---|---|---|---|
| AI Body Reshape | long side <= 2048, short side >= 320 | < 10MB | jpg/jpeg/png |
- Error Codes
| Error Code | Description |
|---|---|
| RUNTIME_ERROR | An unexpected error occurred dubody reshape runtime |
| PHOTO_DETECTION_FAIL | The user photo could not be processed correctly, for example no hand detected |
| PHOTO_CHECK_INVALID | The pose or size of the user photo is invalid |
| INPUT_ERROR | The input file format is incorrect |
| INPUT_MAIN_IMAGE_EMPTY | A user image is required |
- Environment & Dependency
| Sample Code Language / Tool | Recommended Runtime Versions |
|---|---|
| cURL | - bash >= 3.2 - curl >= 7.58 (modern TLS/HTTP support) - jq >= 1.6 (robust JSON parsing) |
| Node.js (JavaScript) | Node >= 18 (for global fetch) |
| JavaScript | - Chrome / Edge >= 80 - Firefox >= 74 - Safari >= 13.1 |
| PHP | PHP >= 7.4 (for modern TLS/compat), ext-curl (recommended) or allow_url_fopen=On + ext-openssl, ext-json |
| Python | Python >= 3.10 (for f-strings), requests >= 2.20.0 |
| Java | Java 11+ (for HttpClient), Jackson Databind >= 2.12.0 |