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>"
}

Documentation Index

Fetch the complete documentation index at: https://novita.ai/docs/llms.txt

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

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"
}