Perfect Corp

Perfect Corp S2s API

The S2s API from Perfect Corp — 5 operation(s) for s2s.

GitHub OpenAPI

Operations 178

POST /s2s/v2.0/task/abs-shape Run an AI Abs Filter task #
GET /s2s/v2.0/task/abs-shape/{task_id} Check the status of a AI Abs Filter task #
POST /s2s/v2.0/task/aging Run a AI Aging Generator task #
GET /s2s/v2.0/task/aging/{task_id} Check the status of a AI Aging Generator task #
GET /s2s/v2.0/task/template/ai-avatar List predefined templates #
POST /s2s/v2.0/task/ai-avatar Run an AI Avatar task #
GET /s2s/v2.0/task/ai-avatar/{task_id} Check the status of the AI Avatar task #
POST /s2s/v2.0/task/sod Run an AI Photo Background Removal task #
GET /s2s/v2.0/task/sod/{task_id} Check an AI Photo Background Removal task status #
POST /s2s/v2.0/task/bag Run an AI Bag task #
GET /s2s/v2.0/task/bag/{task_id} Check the status of a AI Bag task #
GET /s2s/v2.0/task/template/hair-bang List predefined templates #
POST /s2s/v2.0/task/hair-bang Run an AI Hair Bang Generator task #
GET /s2s/v2.0/task/hair-bang/{task_id} Check the status of a AI Hair Bang Generator task #
GET /s2s/v2.0/task/template/beard-style List predefined templates #
POST /s2s/v2.0/task/beard-style Run an AI Beard Style Generator task #
GET /s2s/v2.0/task/beard-style/{task_id} Check the status of a AI Beard Style Generator task #
POST /s2s/v2.0/task/body-reshape/pre-process Run an AI Body Reshape detection task #
GET /s2s/v2.0/task/body-reshape/pre-process/{task_id} Check the status of a AI Body Reshape detection task #
POST /s2s/v2.0/task/body-reshape Run an AI Body Reshape task #
GET /s2s/v2.0/task/body-reshape/{task_id} Check the status of a AI Body Reshape task #
POST /s2s/v2.0/task/2d-vto/bracelet Run an AI 2D Virtual Try On Bracelet task #
GET /s2s/v2.0/task/2d-vto/bracelet/{task_id} Check the status of a AI 2D Virtual Try On Bracelet task #
POST /s2s/v2.0/task/breast-shape Run an AI Breast Augmentation Simulator task #
GET /s2s/v2.0/task/breast-shape/{task_id} Check the status of a AI Breast Augmentation Simulator task #
GET /s2s/v2.0/task/template/cloth List predefined templates #
POST /s2s/v2.0/task/cloth Run an AI Cloths task #
GET /s2s/v2.0/task/cloth/{task_id} Check the status of a AI Cloths task #
POST /s2s/v2.0/task/cloth-v3 Run an AI Cloth V3 task #
GET /s2s/v2.0/task/cloth-v3/{task_id} Check the status of a AI Cloth V3 task #
POST /s2s/v2.0/task/cloth-v4 Run an AI Cloth V4 task #
GET /s2s/v2.0/task/cloth-v4/{task_id} Check the status of a AI Cloth V4 task #
POST /s2s/v2.0/task/colorize/color-correct Run an AI Photo Color Correction task #
GET /s2s/v2.0/task/colorize/color-correct/{task_id} Check an AI Photo Color Correction task status #
POST /s2s/v2.0/task/2d-vto/earring Run an AI 2D Virtual Try On Earring task #
GET /s2s/v2.0/task/2d-vto/earring/{task_id} Check the status of a AI 2D Virtual Try On Earring task #
POST /s2s/v2.0/task/eye-color-vto Run an AI Eye Color Lens task #
GET /s2s/v2.0/task/eye-color-vto/{task_id} Check the status of a AI Eye Color Lens task #
GET /s2s/v2.0/task/template/fabric List predefined templates #
POST /s2s/v2.0/task/fabric Run an Fabric task #
GET /s2s/v2.0/task/fabric/{task_id} Check the status of the Fabric task #
POST /s2s/v2.0/task/face-attr-analysis Run an Face Attribute Analysis task #
GET /s2s/v2.0/task/face-attr-analysis/{task_id} Check an Face Attribute Analysis task status #
POST /s2s/v2.0/task/face-lift/pre-process Run an AI Face Lift detection task #
GET /s2s/v2.0/task/face-lift/pre-process/{task_id} Check the status of an AI Face Lift detection task #
POST /s2s/v2.0/task/face-lift Run an AI Face Lift task #
GET /s2s/v2.0/task/face-lift/{task_id} Check the status of a AI Face Lift task #
POST /s2s/v2.0/task/face-reshape/pre-process Run an AI Face Reshape detection task #
GET /s2s/v2.0/task/face-reshape/pre-process/{task_id} Check the status of an AI Face Reshape detection task #
POST /s2s/v2.0/task/face-reshape Run an AI Face Reshape task #
GET /s2s/v2.0/task/face-reshape/{task_id} Check the status of a AI Face Reshape task #
POST /s2s/v2.0/task/face-swap/pre-process Run an AI Face Swap face detection task #
GET /s2s/v2.0/task/face-swap/pre-process/{task_id} Check a AI Face Swap face detection task status #
POST /s2s/v2.0/task/face-swap Run an AI Face Swap task #
GET /s2s/v2.0/task/face-swap/{task_id} Check a AI Face Swap task status #
POST /s2s/v2.0/task/fitzpatrick-scale-analyzer/pre-process Run an AI Fitzpatrick Scale Analyzer detection task #
GET /s2s/v2.0/task/fitzpatrick-scale-analyzer/pre-process/{task_id} Check the status of a AI Fitzpatrick Scale Analyzer detection task #
POST /s2s/v2.0/task/fitzpatrick-scale-analyzer Run an AI Fitzpatrick Scale Analyzer task #
GET /s2s/v2.0/task/fitzpatrick-scale-analyzer/{task_id} Check the status of a AI Fitzpatrick Scale Analyzer task #
POST /s2s/v2.0/task/hair-color Run a Hair Color task #
GET /s2s/v2.0/task/hair-color/{task_id} Check a Hair Color task status #
POST /s2s/v2.0/task/hair-density-detection Run an AI Hair Density Detection task #
GET /s2s/v2.0/task/hair-density-detection/{task_id} Check the status of a AI Hair Density Detection task #
GET /s2s/v2.0/task/template/hair-ext List predefined templates #
POST /s2s/v2.0/task/hair-ext Run an AI Hair Extension task #
GET /s2s/v2.0/task/hair-ext/{task_id} Check the status of a AI Hair Extension task #
POST /s2s/v2.0/task/hair-frizziness-detection Run an Hair Frizziness Detection task #
GET /s2s/v2.0/task/hair-frizziness-detection/{task_id} Check an Hair Frizziness Detection task status #
POST /s2s/v2.0/task/hair-length-detection Run an Hair Length Detection task #
GET /s2s/v2.0/task/hair-length-detection/{task_id} Check an Hair Length Detection task status #
POST /s2s/v2.0/task/hair-type-detection Run an Hair Type Detection task #
GET /s2s/v2.0/task/hair-type-detection/{task_id} Check an Hair Type Detection task status #
GET /s2s/v2.0/task/template/hair-vol List predefined templates #
POST /s2s/v2.0/task/hair-vol Run an AI Hair Volume Generator task #
GET /s2s/v2.0/task/hair-vol/{task_id} Check the status of a AI Hair Volume Generator task #
GET /s2s/v2.0/task/template/hair-style List predefined templates #
POST /s2s/v2.0/task/hair-style Run an AI Hairstyle Generator task #
GET /s2s/v2.0/task/hair-style/{task_id} Check the status of a AI Hairstyle Generator task #
POST /s2s/v2.0/task/hair-transfer Run an AI Hairstyle Generator task with reference #
GET /s2s/v2.0/task/hair-transfer/{task_id} Check the status of a AI Hairstyle Generator task with reference #
GET /s2s/v2.1/task/template/hair-transfer List predefined templates v2.1 #
POST /s2s/v2.1/task/hair-transfer Run an AI Hairstyle Generator v2.1 task #
GET /s2s/v2.1/task/hair-transfer/{task_id} Check the status of a AI Hairstyle Generator v2.1 task #
POST /s2s/v2.0/task/hat Run an AI Hat task #
GET /s2s/v2.0/task/hat/{task_id} Check the status of a AI Hat task #
GET /s2s/v2.0/task/template/headshot List predefined templates #
POST /s2s/v2.0/task/headshot Run an AI Headshot Generator task #
GET /s2s/v2.0/task/headshot/{task_id} Check the status of the AI Headshot Generator task #
POST /s2s/v2.0/task/out-paint Run an AI Image Extender task #
GET /s2s/v2.0/task/out-paint/{task_id} Check an AI Image Extender task status #
GET /s2s/v2.0/task/template/text-to-image List predefined templates #
POST /s2s/v2.0/task/text-to-image Run an AI Image Generator task #
GET /s2s/v2.0/task/text-to-image/{task_id} Check a AI Image Generator task status #
POST /s2s/v2.0/task/text-to-image/youcam Run an AI Image Generator task V2 for text to image #
GET /s2s/v2.0/task/text-to-image/youcam/{task_id} Check the status of a AI Image Generator task V2 for text to image #
POST /s2s/v2.0/task/image-to-image/youcam Run an AI Image Generator task V2 for image to image #
GET /s2s/v2.0/task/image-to-image/youcam/{task_id} Check the status of a AI Image Generator task V2 for image to image #
GET /s2s/v2.0/task/template/look-vto List predefined templates #
POST /s2s/v2.0/task/look-vto Run an AI Look Virtual Try On task #
GET /s2s/v2.0/task/look-vto/{task_id} Check the status of a AI Look Virtual Try On task #
POST /s2s/v2.0/task/mu-transfer Run an AI Makeup Transfer task #
GET /s2s/v2.0/task/mu-transfer/{task_id} Check a AI Makeup Transfer task status #
POST /s2s/v2.0/task/ai-nail Run an AI Nail Transfer task #
GET /s2s/v2.0/task/ai-nail/{task_id} Check the status of a AI Nail Transfer task #
POST /s2s/v2.0/task/nail-vto Run an AI Nail Vto task #
GET /s2s/v2.0/task/nail-vto/{task_id} Check the status of a AI Nail Vto task #
POST /s2s/v2.0/task/2d-vto/necklace Run an AI 2D Virtual Try On Necklace task #
GET /s2s/v2.0/task/2d-vto/necklace/{task_id} Check the status of a AI 2D Virtual Try On Necklace task #
POST /s2s/v2.0/task/generative-fill Run an AI Object Removal Pro task #
GET /s2s/v2.0/task/generative-fill/{task_id} Check an AI Object Removal Pro task status #
POST /s2s/v2.0/task/bg-blur Run an AI Photo Background Blur task #
GET /s2s/v2.0/task/bg-blur/{task_id} Check an AI Photo Background Blur task status #
GET /s2s/v2.0/task/template/bg-replace List predefined AI photo Background Change V2 templates #
POST /s2s/v2.0/task/bg-replace Run an AI photo Background Change V2 task #
GET /s2s/v2.0/task/bg-replace/{task_id} Check an AI photo Background Change V2 task status #
POST /s2s/v2.0/task/colorize Run an AI Photo Colorize task #
GET /s2s/v2.0/task/colorize/{task_id} Check a AI Photo Colorize task status #
POST /s2s/v2.0/task/enhance Run an AI Photo Enhance task #
GET /s2s/v2.0/task/enhance/{task_id} Check an AI Photo Enhance task status #
POST /s2s/v2.0/task/lighting Run an AI Photo Lighting task #
GET /s2s/v2.0/task/lighting/{task_id} Check an AI Photo Lighting task status #
POST /s2s/v2.0/task/obj-replace Run an AI Replace task #
GET /s2s/v2.0/task/obj-replace/{task_id} Check an AI Replace task status #
POST /s2s/v2.0/task/scarf Run an AI Scarf task #
GET /s2s/v2.0/task/scarf/{task_id} Check the status of a AI Scarf task #
POST /s2s/v2.0/task/shoes Run an AI Shoes task #
GET /s2s/v2.0/task/shoes/{task_id} Check the status of a AI Shoes task #
POST /s2s/v2.0/task/skin-analysis Run a Skin Analysis task #
GET /s2s/v2.0/task/skin-analysis/{task_id} Check a Skin Analysis task status #
POST /s2s/v2.1/task/skin-analysis Run a Skin Analysis V2.1 task #
GET /s2s/v2.1/task/skin-analysis/{task_id} Check a Skin Analysis V2.1 task status #
POST /s2s/v2.0/task/skin-simulation Run an AI Skin Simulation task #
GET /s2s/v2.0/task/skin-simulation/{task_id} Check the status of a AI Skin Simulation task #
POST /s2s/v2.0/task/skin-tone-analysis Run an Skin Tone Analysis task #
GET /s2s/v2.0/task/skin-tone-analysis/{task_id} Check an Skin Tone Analysis task status #
POST /s2s/v2.0/task/ai-smile Run an AI Smile task #
GET /s2s/v2.0/task/ai-smile/{task_id} Check the status of a AI Smile task #
GET /s2s/v2.0/task/template/ai-studio List predefined templates #
POST /s2s/v2.0/task/ai-studio Run an AI Studio task #
GET /s2s/v2.0/task/ai-studio/{task_id} Check the status of the AI Studio task #
POST /s2s/v2.0/task/teeth-whiten/pre-process Run an AI Teeth Whiten detection task #
GET /s2s/v2.0/task/teeth-whiten/pre-process/{task_id} Check the status of a AI Teeth Whiten detection task #
POST /s2s/v2.0/task/teeth-whiten Run an AI Teeth Whiten task #
GET /s2s/v2.0/task/teeth-whiten/{task_id} Check the status of a AI Teeth Whiten task #
POST /s2s/v2.0/task/bg-replace-vid Run an AI Video Background Replace task #
GET /s2s/v2.0/task/bg-replace-vid/{task_id} Check the status of an AI Video Background Replace task #
POST /s2s/v2.0/task/video-sr Run an AI Video Enhance task #
GET /s2s/v2.0/task/video-sr/{task_id} Check a AI Video Enhance task status #
POST /s2s/v2.0/task/face-swap-vid Run an AI Face Swap (video) task #
GET /s2s/v2.0/task/face-swap-vid/{task_id} Check the status of the AI Face Swap (video) task #
GET /s2s/v2.0/task/template/image-to-video List predefined templates #
POST /s2s/v2.0/task/image-to-video Run an Image to Video task #
GET /s2s/v2.0/task/image-to-video/{task_id} Check the status of the Image to Video task #
POST /s2s/v2.0/task/image-to-video/youcam Run an AI Image to Video Generator V2 task #
GET /s2s/v2.0/task/image-to-video/youcam/{task_id} Check the status of a AI Image to Video Generator V2 task #
POST /s2s/v2.0/task/text-to-video/youcam Run an AI Text To Video task #
GET /s2s/v2.0/task/text-to-video/youcam/{task_id} Check the status of a AI Text To Video task #
POST /s2s/v2.0/file/obj-rem-vid Create a new file #
POST /s2s/v2.0/task/obj-rem-vid Run an AI Video Object Removal task #
GET /s2s/v2.0/task/obj-rem-vid/{task_id} Check the status of a AI Video Object Removal task #
GET /s2s/v2.0/task/template/video-trans List predefined templates #
POST /s2s/v2.0/task/video-trans Run an AI Style Transfer (video) task #
GET /s2s/v2.0/task/video-trans/{task_id} Check the status of the AI Style Transfer (video) task #
POST /s2s/v2.0/task/2d-vto/watch Run an AI 2D Virtual Try On Watch task #
GET /s2s/v2.0/task/2d-vto/watch/{task_id} Check the status of a AI 2D Virtual Try On Watch task #
GET /s2s/v2.0/task/template/hair-curl List predefined templates #
POST /s2s/v2.0/task/hair-curl Run an AI Wavy Hair task #
GET /s2s/v2.0/task/hair-curl/{task_id} Check the status of a AI Wavy Hair task #
POST /s2s/v2.0/file Create a new file #
POST /s2s/v2.0/task/makeup-vto Run an AI Makeup Virtual Try On task #
GET /s2s/v2.0/task/makeup-vto/{task_id} Check the status of a AI Makeup Virtual Try On task #
POST /s2s/v2.0/file/2d-vto/ring Create a new file #
POST /s2s/v2.0/task/2d-vto/ring Run an AI 2D Virtual Try On Ring task #
GET /s2s/v2.0/task/2d-vto/ring/{task_id} Check the status of a AI 2D Virtual Try On Ring task #
POST /s2s/v2.0/task/delete Delete a task and its files #
GET /s2s/v1.0/client/credit Get unit info #
GET /s2s/v1.0/client/credit/history View unit history #
GET /s2s/v2.0/credit/feature-cost Get feature cost #

Documentation

📖
Documentation
https://docs.perfectcorp.com/develop/introduction
📖
APIReference
https://docs.perfectcorp.com/reference/ai_skin_analysis
📖
GettingStarted
https://docs.perfectcorp.com/develop/quick_start_guide
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/perfect-corp/refs/heads/main/authentication/perfect-corp-authentication.yml
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/perfect-corp/refs/heads/main/rate-limits/perfect-corp-rate-limits.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/perfect-corp/refs/heads/main/openapi/perfect-corp-s2s-api-openapi.yml

Other Resources

🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/perfect-corp/refs/heads/main/conventions/perfect-corp-conventions.yml
🔗
Idempotency
https://raw.githubusercontent.com/api-evangelist/perfect-corp/refs/heads/main/conventions/perfect-corp-conventions.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/perfect-corp/refs/heads/main/errors/perfect-corp-problem-types.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/perfect-corp/refs/heads/main/data-model/perfect-corp-data-model.yml
🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/perfect-corp/refs/heads/main/asyncapi/perfect-corp-webhooks.yml
🔗
Sandbox
https://raw.githubusercontent.com/api-evangelist/perfect-corp/refs/heads/main/sandbox/perfect-corp-sandbox.yml
🔗
OAuthScopes
https://raw.githubusercontent.com/api-evangelist/perfect-corp/refs/heads/main/scopes/perfect-corp-scopes.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/perfect-corp-s2s-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

perfect-corp-s2s-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Perfect Corp S2s API
  version: ''
  contact:
    email: YouCamOnlineEditor_API@perfectcorp.com
  license:
    name: Privacy policy
    url: https://www.makeupar.com/perfectbeauty/youcam/privacy-policy-api
  termsOfService: https://www.makeupar.com/perfectbeauty/youcam/terms-of-service-api
  description: 'Operations tagged S2s across 65 of this provider''s published API definitions: perfect-corp-ai_abs_filter-openapi.yml, perfect-corp-ai_aging_simulation-openapi.yml, perfect-corp-ai_avatar_generator-openapi.yml, perfect-corp-ai_background_removal-openapi.yml, perfect-corp-ai_bag-openapi.yml, perfect-corp-ai_bangs-openapi.yml, perfect-corp-ai_beard_style-openapi.yml, perfect-corp-ai_body_reshape-openapi.yml, perfect-corp-ai_bracelet-openapi.yml, perfect-corp-ai_breast_augmentation-openapi.yml…'
servers:
- url: https://yce-api-01.makeupar.com
tags:


# --- truncated at 32 KB (546 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/perfect-corp/refs/heads/main/openapi/perfect-corp-s2s-api-openapi.yml