MeduxMedux

Edit > Image Face Swap

Image Face Swap

Swap a face from one image onto another while keeping the target pose and lighting.

POST/api/app/v1/process/image/face_swap

Examples

curl -X POST https://api.medux.io/api/app/v1/process/image/face_swap \
  -H 'Authorization: Bearer $MEDUX_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"model_id":"image-face-swap-default","source_image_file_id":"FILE_ID","target_face_image_file_id":"FILE_ID"}'

Media Samples

Approved examples for understanding request inputs, response shape, and official example output.

Official image face swap sample

This example uses image-face-swap-default.

Sample request

Example input for this capability.

source_image_file_id{file_id}target_face_image_file_id{file_id}

Sample response

Official example output for preview only. It is not a user Media Result.

Example output

Official example output

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

source_image_file_idstringrequired

Source image file_id.

Location: BODY

target_face_image_file_idstringrequired

Target face image file_id.

Location: BODY

model_idstringoptional

Face swap model id. Default: image-face-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.

Image Face Swap

Swap a face from one image onto another while keeping the target pose and lighting.

Invocation Example

Swap a face from one image onto another while keeping the target pose and lighting.