Skip to content
AI Body Reshape/
/
Integration Guide

AI Body Reshape

Overview

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!

Integration Guide

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:

  1. Image Upload Preparation:

    • Prepare a selfie image for upload.
    • Call the File API /s2s/v2.0/file to obtain the upload URL and associated file_id.
    • Upload the selfie image using the provided upload URL.

  2. Optional Preprocessing For Group Photos:

    • Preprocess the selfie image if there are more than one person in the image.

  3. Body Reshape Effect Setup:

    • Begin by selecting suitable body reshape parameters.

  4. Initiate AI Task and Obtain Task ID:

    • Send the file_id along 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.

  5. Poll Task Status (Continuous Check):

    • Use the obtained task_id to 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.

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:

API Playground: http://yce.makeupar.com/api-console/en/api-playground/ai-body-reshape/

  • 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/.

    1. 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/file

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

    1. 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
 }
}
    1. 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}

File Specs & Errors

  • AI Body Reshape Specification

Supported Selfie View Full body shot with clear facial expression and body posture visible.

Visibility & Pose Requirements

RegionWhat must be true in the source image
NeckThe neck must be visible in the source image.
ArmBoth arms – upper arm, forearm and hand – have to be fully shown.
LegThe whole leg must appear in the picture.
HipHips need to be in view.
Hip‑LiftHips 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.
BellyThe belly is required to be visible.
WaistWaist 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.
SlimShoulders 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

CategoryParameterFunctionMin Value (-100 / 0)Max Value (100)
ArmsIntensityAdjusts the thickness of the armsThinThick
BellyIntensityAdjusts abdominal projectionFlatProtruding
ChestIntensity (Left / Right)Adjusts chest volume on each sideFlatFull
Hip LiftIntensityAdjusts the curvature and lift of the hips (adds a butt‑lifting effect)Sculpted (lifted and tightened)Rounded (lifted with fuller volume)
Hip SizeIntensityAdjusts the overall width of the hipsNarrowWide
LegsIntensityAdjusts the thickness of the legsThinThick
NeckIntensity (Left / Right)Adjusts neck contour and slimming per sideOriginal (0)Tucked in
Shoulder WidthIntensity (Left / Right)Adjusts the span of each shoulderNarrowBroad
Shoulder ShapeIntensity (Left / Right)Adjusts the angle and slope of each shoulderSlopedSquared
SlimIntensityAdjusts overall body curvatureSlimCurvy
TallIntensityAdjusts the overall character heightOriginal (0)Taller
WaistIntensityAdjusts the width of the waistlineNarrowWide

Note: “Left” and “Right” refer to the character's perspective, not the viewer's side of the screen.

  • Supported Formats & Dimensions
AI FeatureSupported DimensionsSupported File SizeSupported Formats
AI Body Reshapelong side <= 2048, short side >= 320< 10MBjpg/jpeg/png
  • Error Codes
Error CodeDescription
RUNTIME_ERRORAn unexpected error occurred dubody reshape runtime
PHOTO_DETECTION_FAILThe user photo could not be processed correctly, for example no hand detected
PHOTO_CHECK_INVALIDThe pose or size of the user photo is invalid
INPUT_ERRORThe input file format is incorrect
INPUT_MAIN_IMAGE_EMPTYA user image is required
  • Environment & Dependency
Sample Code Language / ToolRecommended 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
PHPPHP >= 7.4 (for modern TLS/compat), ext-curl (recommended) or allow_url_fopen=On + ext-openssl, ext-json
PythonPython >= 3.10 (for f-strings), requests >= 2.20.0
JavaJava 11+ (for HttpClient), Jackson Databind >= 2.12.0

Unit Consumption

AI FeatureUnit Consumed
AI Body Reshape V1.01
Download OpenAPI description
ai_body_reshape.json
ai_body_reshape.yaml
Overview
E-mail
YouCamOnlineEditor_API@perfectcorp.com
License
Privacy policy
Terms of Service
Languages
Servers
https://yce-api-01.makeupar.com