Fotor OpenAPI
  1. Reference
Fotor OpenAPI
  • Getting Started
    • Introduction
    • Access and Authentication
    • For Serverless Clients
    • Token Consumption
  • Reference
    • AI Upscaler
      POST
    • AI Skin Retouch
      POST
    • Text to Image
      POST
    • Image to Image (AI Art Effects)
      POST
    • Background Remover
      POST
    • AI Headshot
      POST
    • Photo Colorize
      POST
    • Photo Restoration
      POST
    • Face Swap
      POST
    • AI Replace
      POST
    • Query Task Details
      GET
  • Webhook
    • Webhook
  • AI Editor SDK
    • Getting Started
    • Get Sdk Temporary Token
      GET
  1. Reference

Face Swap

POST
/v1/aiart/faceswap
Enhance your photos with our Face Swap API, seamlessly swapping faces between images for entertaining and realistic transformations. Whether you’re looking to swap faces with friends, family, or even celebrities, the possibilities are limitless. Our advanced AI ensures natural blending for high-quality results. Plus, explore a variety of templates to create fun and unique edits effortlessly.

Request

Header Params
Authorization
string 
required
Example:
Bearer <your api key>
Body Params application/json
userImageUrl
string 
required
The URL or BASE64 encoded image of the face image provided by the user.
templateImageUrl
string 
required
The URL or BASE64 encoded image of the target to Swap Face in This Image.
Example
{
  "userImageUrl": "https://pub-static.fotor.com/assets/goart-effects/examples/mini-figure-after.jpg",
  "templateImageUrl": "https://pub-static.fotor.com/assets/goart-effects/examples/mini-figure-after.jpg"
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api-b.fotor.com/v1/aiart/faceswap' \
--header 'Authorization: Bearer <your api key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "userImageUrl": "https://pub-static.fotor.com/assets/goart-effects/examples/mini-figure-after.jpg",
    "templateImageUrl": "https://pub-static.fotor.com/assets/goart-effects/examples/mini-figure-after.jpg"
}'

Responses

🟢200success
application/json
Body
code
string 
required
000: Success,999: Unknown error
Example:
000
msg
string 
required
Example:
success
data
object 
required
taskId
string 
required
Task ID, used to query task information.
Example:
e0dc194703174b6eafeacb4ee8e02850
Example
{
  "code": "000",
  "msg": "success",
  "data": {
    "taskId": "e0dc194703174b6eafeacb4ee8e02850"
  }
}
Previous
Photo Restoration
Next
AI Replace
Built with