Skip to main content
POST
/
faceswap
/
specific_video_swap
Specific face swap in video
curl --request POST \
  --url https://modelslab.com/api/v6/faceswap/specific_video_swap \
  --header 'Content-Type: application/json' \
  --data '
{
  "key": "<string>",
  "init_image": "<string>",
  "init_video": "<string>",
  "reference_image": "<string>",
  "output_format": "mp4",
  "watermark": true,
  "webhook": "<string>",
  "track_id": 123
}
'
{
  "generationTime": 123,
  "id": 123,
  "output": [
    "<string>"
  ],
  "proxy_links": [
    "<string>"
  ],
  "meta": {
    "file_prefix": "<string>",
    "outdir": "<string>",
    "output_format": "<string>",
    "reference_image": "<string>",
    "seed": 123,
    "source_image": "<string>",
    "target_video_url": "<string>",
    "watermark": "<string>",
    "watermark_image": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.modelslab.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Request

Make a POST request to below endpoint and pass the required parameters in the request body.
curl
--request POST 'https://modelslab.com/api/v6/faceswap/specific_video_swap' \

​
Body

json
{    "key": "your_api_key",    
     "init_video": "https://tawk.link/6332cd5154f06e12d8971855/vc/66d997a6a2bc5fe2b627a250/v/4239c555189b772d5ca1bd5aa4bf872c4c12a07e/sdfsdfsdf.mp4",    
     "init_image" :"https://images-ext-1.discordapp.net/external/rJOvGZHIWsIijkfvCn5dByZNh_RfZZxUIiyyo7yOFIY/https/images.hindustantimes.com/rf/image_size_630x354/HT/p2/2017/12/27/Pictures/_1e5bc084-ead1-11e7-ad70-11504944e689.jpg?format=webp&width=984&height=553",    
     "reference_image": "https://images-ext-1.discordapp.net/external/Z8sBOyxEy9tsqkd9gsNK2dHZh-Em6LDqrmyjcDeMXII/https/i.ibb.co/2PGZ3p7/lmao.png?format=webp&quality=lossless&width=412&height=662",    
     "output_format": "mp4",    
     "webhook": null,    
     "track_id": null
}

Body

application/json
​
key
string
required

Your unique API key used for authorization

​
init_image
string<uri>
required

The image containing multiple faces to be swapped

​
init_video
string<uri>
required

The video containing the face(s) to replace the faces in the image

​
reference_image
string<uri>
required

A reference image containing the specific face to swap from the initial image

​
output_format
string
default:mp4

The desired output format of the video

​
watermark
boolean
default:true

Indicates if the generated result should include a watermark

​
webhook
string<uri> | null

A URL to receive a POST API call once the video generation is complete

​
track_id
integer | null

An ID included in the webhook response to identify the request

Response

Specific video face swap response

​
status
enum<string>
Available options:
success
​
generationTime
number

Time taken to generate the video in seconds

​
id
integer

Unique identifier for the generation request

​
output
string<uri>[]

Array of URLs to the generated videos

​
proxy_links
string<uri>[]

Array of proxy URLs for the generated videos

​
meta
object

Metadata about the video generation process