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 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...
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.
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
Swap a head in three steps
Replace the head in an authorized portrait with a focused image-to-image workflow.
Provide the target image
Submit one publicly accessible photo whose head should be replaced. Only use portraits you own or have permission to edit.
Provide the head reference
Submit one publicly accessible photo of the head to use. You must have the pictured person’s consent.
Retrieve the result
Poll the asynchronous task or use callback delivery to receive the swapped image automatically.
Head Swap usage guidance
Notes
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.
Each task requires exactly 1 target image and 1 head reference image.
Image URLs must be public and directly accessible by the service.
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
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





