GoEnhance API
  1. ImageFaceSwap
GoEnhance API
  • GUIDES
    • Quickstart
    • Limits
    • Best Practices
    • Privacy Policy and Terms of Use
  • Basic
    • Get Job Detail
      GET
    • Get User Tokens
      GET
  • Video2Video
    • Generate Video
      POST
    • Model List
      GET
  • ImageFaceSwap
    • Generate Image Face Swap
      POST
  • VideoFaceSwap
    • Generate Video Face Swap
      POST
  • Video Effect
    • AI Video Effect
      POST
    • AI Video Effect List
      GET
  • Text To Image
    • Generate Image
      POST
  1. ImageFaceSwap

Generate Image Face Swap

POST
/api/v1/imagefaceswap/generate

Request

Header Params
Authorization
string 
required
Body Params application/json
args
object 
required
reference_img
string 
required
target image, Max 5M
source_img
string 
required
face image, Max 5M
type
string 
required
Example
{
  "args": {
    "reference_img": "https://cdn.goenhance.ai/user/goenhance/76115ad445ce26fbd5ad2c649a29e806.jpg",
    "source_img": "https://cdn.goenhance.ai/user/goenhance/72ca459817135553959ad72ade516802.jpg"
  },
  "type": "mx-image-face-swap"
}

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.goenhance.ai/api/v1/imagefaceswap/generate' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "args": {
        "reference_img": "https://cdn.goenhance.ai/user/goenhance/76115ad445ce26fbd5ad2c649a29e806.jpg",
        "source_img": "https://cdn.goenhance.ai/user/goenhance/72ca459817135553959ad72ade516802.jpg"
    },
    "type": "mx-image-face-swap"
}'

Responses

🟢200Success
application/json
Body
code
integer 
required
msg
string 
required
data
object 
required
img_uuid
string 
required
Example
{
  "code": 0,
  "msg": "Success",
  "data": {
    "img_uuid": "c12b656c-747a-44fd-9c80-add79b0c52d5"
  }
}
🟠401Unauthorized
🔴500Server Error
Modified at 2025-04-19 16:46:42
Previous
Model List
Next
Generate Video Face Swap
Built with