GoEnhance API

Generate Video Face Swap

POST

/api/v1/videofaceswap/generate

Request

Header Params

Authorization

string

required

Body Params application/json

args

object

required

reference_video

string

required

target video, Max 200M

reference_img

string

required

target image, Max 5M

upscaler

enum<integer>

required

Convert video resolution

Allowed values:

start_time

number

required

The start time of the conversion (in seconds)

>= 0<= 120

end_time

number

required

Conversion end time (in seconds)

>= 0<= 120

enhance_face

boolean

optional

type

enum<string>

required

mx-video

Allowed value:

mx-video-face-swap

Example

{
  "args": {
    "reference_video": "https://cdn.goenhance.ai/user/goenhance/a3f2b22dcab9f6d53144bef89d5dae5c.mp4",
    "reference_img": "https://cdn.goenhance.ai/user/goenhance/72ca459817135553959ad72ade516802.jpg",
    "upscaler": 1,
    "start_time": 0,
    "end_time": 5,
    "enhance_face": false
  },
  "type": "mx-video-face-swap"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.goenhance.ai/api/v1/videofaceswap/generate' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "args": {
        "reference_video": "https://cdn.goenhance.ai/user/goenhance/a3f2b22dcab9f6d53144bef89d5dae5c.mp4",
        "reference_img": "https://cdn.goenhance.ai/user/goenhance/72ca459817135553959ad72ade516802.jpg",
        "upscaler": 1,
        "start_time": 0,
        "end_time": 5,
        "enhance_face": false
    },
    "type": "mx-video-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-01-30 08:15:00

Generate Image Face Swap

AI Video Effect