Skip to main content
POST
/
v3
/
async
/
video-merge-face
Video Merge Face
curl --request POST \
  --url https://api.novita.ai/v3/async/video-merge-face \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "extra": {
    "response_video_type": "<string>"
  },
  "request": {
    "video_assets_id": "<string>",
    "enable_restore": true,
    "face_image_base64": "<string>"
  }
}
'
{
  "task_id": "<string>"
}
This API endpoint seamlessly integrates a face image into a target video, allowing you to replace the face in the video with the face from the image.
Pricing: $0.0005 / Video Frame

​
Request Headers

​
Content-Type
string
required
Enum: application/json
​
Authorization
string
required
Bearer authentication format, for example: Bearer {{API Key}}.

​
Request Body

​
extra
object
Optional extra parameters for the request.
​
request
object
required

​
Response

​
task_id
string
Use the task_id to request the Task Result API to retrieve the generated outputs.

​
Example

​
1. Get Video Assets ID

Request: 
curl -X PUT -T "{{video file path}}" 'https://assets.novitai.com/video'
Response: 
{
    "assets_id": "cjIvbm92aXRhLWFpLWFzc2V0L3ZpZGVvL0NLd0N3aHJwS0ZyYVduNWVoejVFV0tleGlzN0toNmRq"
}
Last modified on June 10, 2026