ImaginePro
HomeDocs
HomeDocs
  1. API Documentation
  • Introduction
  • System Design
  • Get Started
  • My Account
    • Credits
    • Generation Modes
  • API Documentation
    • Generate Image
      POST
    • Get Progress
      GET
    • Upscale
      POST
    • Variation
      POST
    • Zoom
      POST
    • Pan
      POST
    • Reroll
      POST
    • Make Square
      POST
    • Cancel Job
      POST
    • Inpainting
      POST
    • Image to Text (describe)
      POST
    • Image to Image
      POST
    • Face Swap
      POST
    • Blend
      POST
    • History
      GET
    • Generate Image Boost
      POST
    • Button Boost
      POST
    • Prompt Check
      POST
    • Account Info
      GET
    • Generate Image - Flux Model
      POST
    • Remove Background
      POST
  • FLUX API Documentation
    • Generate Image
      POST
    • Upscale Image
      POST
  • DIY Plan Endpoints
    • Queue Management
      • Count jobs in queue
      • Reboot the queue
      • Pause the queue
      • Resume the queue
    • Get Linked Discord Token Details
    • Toggle Linked Discord Token
    • Get Message Trace
    • Get Ban Words List
    • Update Ban Words List
    • Get Linked Account List
    • Get Linked Account queue status
    • Excute MJ commad
  • Guide
    • FAQ
    • Troubleshoot
  • HowTos
    • How to get Discord token, server and channel ID
    • How to use ImaginePro web app
    • How to make ImaginePro API request in Postman
    • How to use Midjourney V6
    • How to link your own Discord account
    • How to debug the ImaginePro web app
  • Web App
    • Credits
  1. API Documentation

Face Swap

POST
https://api.imaginepro.ai/api/v1/nova/faceswap
You can perform a face swap from one image to another. Both images must contain one face, otherwise it will only take the left most face as input.
Please make sure the image is not huge, file size less than 5MB is recommended.
For faceswap in group photo or video, you can check the specific ChangeFace service.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/json
source
string 
required
This is the URL for the face that you would like to use on the target. You cannot use URLS served by Midjourney (ie. cdn.midjourney) image.
target
string 
required
This is the URL for the image that you would like to swap the face on. You cannot use URLS served by Midjourney (ie. cdn.midjourney) image.
ref
string 
optional
The reference metadata which will return as part of the webhook.
webhookOverride
string 
optional
The webhook URL which the response will send to, the payload of this webhook is same as our Message endpoint.
Example
{
  "source": "https://pix2.tvzhe.com/thumb/star/0/121/260x346.jpg",
  "target": "https://pix2.tvzhe.com/thumb/star/0/202/260x346.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.imaginepro.ai/api/v1/nova/faceswap' \
--header 'Content-Type: application/json' \
--data-raw '{
  "source": "https://pix2.tvzhe.com/thumb/star/0/121/260x346.jpg",
  "target": "https://pix2.tvzhe.com/thumb/star/0/202/260x346.jpg"
}'

Responses

🟢200Success
application/json
Body
success
boolean 
required
The status of the request.
messageId
string 
required
The messageId of the request, which will be used for querying the progress, sending subsequential actions later, etc.
createdAt
string 
required
The timestamp of the job creation.
error
string 
optional
The error message, if any
Example
{
    "success": true,
    "messageId": "d15c1541-229a-442b-9873-d3494dede12a",
    "createdAt": "2023-08-01T14:03:01.817Z"
}
Previous
Image to Image
Next
Blend
Built with