MeduxMedux

Edit > Image Head Swap

Image Head Swap

Replace the target head with the source head while keeping the target body and scene.

POST/api/app/v1/process/image/head_swap

Examples

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

Media Samples

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

Official image head swap sample

This example uses image-head-swap-default.

Sample request

Example input for this capability.

source_image_file_id{file_id}target_head_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_head_image_file_idstringrequired

Target head image file_id.

Location: BODY

model_idstringoptional

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

Image Head Swap

Replace the target head with the source head while keeping the target body and scene.

Invocation Example

Replace the target head with the source head while keeping the target body and scene.