APIXO
Head SwapImage-to-ImageConsent Required

Head Swap is APIXO’s image-to-image API for replacing the whole head in a target photo with the head from a reference photo, while keeping the target’s body, pose, clothing, and background. Use it only with portraits you own or have explicit permission to use.

Input

1 Target + 1 Head

APIXO Price

$0.0156 / Image

Workflow

Image-to-Image

Delivery

Async / Callback

Create with Head Swap

Loading workspace...

Focused Portrait Editing

Swap one head into one target photo

Submit a target image and a head reference image to a fixed image-to-image workflow. Head Swap replaces the whole head in the target while aiming to keep the original body, pose, lighting, clothing, and background as close as possible.

Capabilities

Purpose-built head replacement for authorized portraits

Head Replacement

Place the head from your reference photo onto the person in the target photo in a single task.

Two Clear Inputs

Each task takes one target image and one head reference image, so it is always clear which photo supplies the head and which one keeps the scene.

Scene Preservation

The target photo’s pose, clothing, and background are kept as the base of the result, while very different angles or lighting may reduce how natural the swap looks.

Seed Control

Pass an optional seed to keep results closer between runs with the same inputs, or leave it empty for a random seed.

Async Processing

Submit swap jobs asynchronously. APIXO recommends the first status poll about 10 seconds after task creation, then every 5–10 seconds.

Callback Delivery

Provide a public HTTPS callback URL to receive the result automatically when the swap task completes.

Details

Head Swap API specifications

Core controls currently exposed through APIXO.

1 Target Image URL

Target Input

1 Head Image URL

Head Input

Image-to-Image

Workflow

Optional

Seed

10 Seconds

First Poll

Quick Start

Swap a head in three steps

Replace the head in an authorized portrait with a focused image-to-image workflow.

01

Provide the target image

Submit one publicly accessible photo whose head should be replaced. Only use portraits you own or have permission to edit.

02

Provide the head reference

Submit one publicly accessible photo of the head to use. You must have the pictured person’s consent.

03

Retrieve the result

Poll the asynchronous task or use callback delivery to receive the swapped image automatically.

Notes & FAQ

Head Swap usage guidance

Notes

01

Only process portraits you own or have explicit permission to use. Do not use Head Swap to impersonate anyone, to commit fraud, or to create sexually explicit content without the pictured person’s consent.

02

Each task requires exactly 1 target image and 1 head reference image.

03

Image URLs must be public and directly accessible by the service.

04

Clear, well-lit reference photos with the whole head visible usually give more natural results; strong angle, lighting, or occlusion differences between the two photos may leave visible artifacts.

Frequently Asked Questions

It replaces the head of the person in the target image with the head from your reference image, and keeps the rest of the target photo as the base of the result.

Head Swap takes a head reference and replaces the whole head in the target photo. Face Swap takes a face reference and replaces only the face instead.

Each completed swap is billed at $0.0156 per output image. The seed setting does not change the price.

Only if you have that person’s permission. Use Head Swap solely with portraits you own or are authorized to use, and never to impersonate someone, commit fraud, or create sexually explicit content without consent.

Not necessarily. Large differences in head angle, lighting, resolution, or head coverage between the two photos can reduce realism or leave visible artifacts.

Explore Other Models

Discover more AI models for your next creative workflow