MeduxMedux

Edit > Image Outfit Swap

Image Outfit Swap

Transfer the outfit from the reference image onto the target subject.

POST/api/app/v1/process/image/outfit_swap

Examples

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

Media Samples

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

Official image outfit swap sample

This example uses image-outfit-swap-default.

Sample request

Example input for this capability.

source_image_file_id{file_id}target_outfit_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_outfit_image_file_idstringrequired

Target outfit image file_id.

Location: BODY

model_idstringoptional

Outfit swap model id. Default: image-outfit-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 Outfit Swap

Transfer the outfit from the reference image onto the target subject.

Invocation Example

Transfer the outfit from the reference image onto the target subject.