MeduxMedux

Edit > Video Head Swap

Video Head Swap

Animate a swapped face image with a driving video to produce a head swap video.

POST/api/app/v1/process/video/animate_head_swap

Examples

curl -X POST https://api.medux.io/api/app/v1/process/video/animate_head_swap \
  -H 'Authorization: Bearer $MEDUX_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"edit_prompt":"人脸保持不变","face_image_file_id":"FILE_ID","height":832,"input_video_file_id":"FILE_ID","model_id":"animate-head-swap-default","positive_prompt":"一个角色在说话","width":480}'

Auth Requirements

Authentication is required via Authorization header.

Preconditions

Upload the source file and create a file reference before calling this endpoint.

Successful requests return a Medux task record immediately. Use the task query or sync endpoints to track completion.

All file inputs must be uploaded and persisted as file references before submission.

Request

Body

application/json
Authorizationstringrequired

Bearer token or API key.

Location: HEADER

face_image_file_idstringrequired

Face reference image file_id used for the head swap target.

Location: BODY

input_video_file_idstringrequired

Driving video file_id.

Location: BODY

widthintegeroptional

Target output width. Default: 480.

Location: BODY

heightintegeroptional

Target output height. Default: 832.

Location: BODY

positive_promptstringoptional

Positive prompt text for the animation workflow. Default: 一个角色在说话.

Location: BODY

negative_promptstringoptional

Negative prompt text.

Location: BODY

edit_promptstringoptional

Edit instruction for preserving the swapped face identity. Default: 人脸保持不变.

Location: BODY

model_idstringoptional

Animate head swap model id. Default: animate-head-swap-default.

Location: BODY

titlestringoptional

Optional task title.

Location: BODY

Response

Response

application/json
No response fields documented for this endpoint.

MCP Tool

This endpoint is also available through the Medux-hosted remote MCP service.

Video Head Swap

Animate a swapped face image with a driving video to produce a head swap video.

Invocation Example

Animate a swapped face image with a driving video to produce a head swap video.