v1

latestOpenAPI 3.1.02026-07-26590116.2 KB

Generate Video Face Swap

post/api/v1/videofaceswap/generate

Headers

Authorizationstring required

Request body

reference_videostring required

target video, Max 200M

reference_imgstring required

target image, Max 5M

upscaler1 | 2 required

Convert video resolution, 1 -> 720p, 2-> 1080p (1.5x price)

start_timenumber required

The start time of the conversion (in seconds)

end_timenumber required

Conversion end time (in seconds)

enhance_faceboolean

enable (1.5x price)

custom_callback_urlstring uri

Optional. A publicly accessible HTTPS URL. When the task status changes (processing / success / failed), GoEnhance sends a POST request to this URL. The request body is identical to the response of GET /api/v1/jobs/detail. If your server does not respond with HTTP 200, the notification is retried up to 3 times, with a 3-second timeout per attempt.

Example request

{
  "custom_callback_url": "https://your-server.com/goenhance/callback"
}

Response

codeinteger required
msgstring required