Head swap vs face swap: which one do I need?

A face swap changes the facial features and keeps the target's hair and head shape. A head swap replaces the whole head, so the source's hairstyle and outline come along. Use Face Swap when the hair should stay; use Head Swap when the person should look like the source from the neck up.

What photos work best with a head swap AI?

A source head that is fully visible, hair included, facing roughly the same way as the target, in even light. A target photo where the head is easy to see and not tiny. Both images are sent as public http(s) URLs.

Can I run a head swap on video or on several people?

No. Head Swap works on one still image and returns one image per request. Video is not supported on this model.

Can I use Head Swap in the playground?

Yes. The playground on this page runs the same model as the API, so you can do a head swap online: sign in, paste a target photo URL and a source head URL, and run it. For batches and your own product, call the endpoint with an API key.

Does Head Swap have a content filter?

No. There is no content-filter parameter on Head Swap, and sending content_filter returns a 400 error instead of being ignored. Use it on people whose likeness you have the right to use. Platform terms apply to everything you generate.

How do I get the same head swap result again?

Set the seed, any integer from 0 to 2147483647. The same target photo, source head and seed return the same image. Omit the seed or set it to 0 to draw a new result each time.

Is Head Swap free or paid?

Paid. Completed swaps are charged at the flat per-image rate in the pricing table above. Eligible new accounts may receive promotional test credits, shown at signup or in the dashboard. Failed and rejected requests are refunded automatically.

Does Head Swap require a monthly subscription?

No. Pricing is pay-as-you-go: $1 buys 1,000 credits and credits never expire. You pay per Head Swap image generated, not per month.

How do I get a Head Swap API key?

Sign up and create a key in the dashboard, no card required. Pass it as a Bearer token in the Authorization header. The key is for calling Head Swap from your own code; the playground on this page only needs a signed-in account.

Head Swap — Move the Whole Head, Hair Included, in One Call

Head Swap replaces the entire head in a target photo with the head from a source photo: face, hair, ears and outline. Pose, lighting and background stay put. Try it below or call it with an API key, flat price per image.

Highlights: Full head swap · hair, face and outline move together · seed control
Best for: Photos where the hair and head shape must change along with the face
Input: Target photo + source head
Output: One swapped image per request

Input

Target photo*

playground-target.webp

Replace

✓ 1 file added

https://file.deepytb.com/landing/head-swap/playground-target.webp

1/1 file

Required · public http(s) URL

Source head*

playground-head.webp

Replace

✓ 1 file added

https://file.deepytb.com/landing/head-swap/playground-head.webp

1/1 file

Required · public http(s) URL

Seed

0–2147483647 · 0 or empty = random

Estimated cost~$0.01313 credits

Result

What is Head Swap?

Head Swap is an image-to-image model exposed on reAPI as one async endpoint with three parameters: the target photo, the source head, and an optional seed. It replaces the whole head in the target photo, hair and outline included, and keeps the target's body, pose, lighting and background. One image per request at a flat rate, in the playground on this page or through the API.

What you can build with this model

Real-world workflows and production use cases you can build and ship with this model.

Head Swap before and after — a park portrait on the left, the same photo with a different head on the right

Head swap for characters and avatars

When the hair is part of the identity, a face swap is not enough. Head Swap carries the whole head across, so a character keeps their look on any body, in any scene, from one API call.

Read the API docs

Head Swap before and after — an office portrait with the whole head replaced, suit and lobby unchanged

Reuse a shoot with a different person in it

Keep the outfit, the pose and the set; change who is wearing it. Head Swap keeps the target's body and background and replaces the head with the source, hair and all.

Head Swap batch — the same market-stall portrait swapped with three different source heads, side by side

Batch head swap with repeatable results

Pin a seed and the same two photos give the same result every time. Run one scene against a set of source heads overnight and keep the ones that work.

Pricing

Credit-based — 1 credit = $0.001 USD. Pay only for completed generations.

First test cost

$0.01313 credits

One sample at the cheapest tier (1 image).

Testing budget guide

Add credits

$10

≈ 769 tests

$50

≈ 3846 tests

$100

≈ 7692 tests

Model	Category	Price
head-swap	Per image	$0.013 13 credits · 1 image

Why reAPI

The whole head, hair included

A face swap keeps the target's hair and head shape. Head Swap brings the source's hair, contour and ears along, so the likeness is much stronger.

No content filter, one route

There is no content-filter switch on this model because there is no filtered route to switch to. Run it on this page or call it with an API key. Platform terms still apply.

Flat price, async, refunded on failure

1 credit equals $0.001 USD. Head Swap bills one flat rate per image whatever the photo size. POST, get a task_id, poll. Failed swaps are refunded.

Head Swap on reAPI vs a manual head swap in an editor

Both put a different head on a photo. Head Swap on reAPI is one HTTP call with two image URLs; a manual head swap is a masking and blending job in an image editor, redone by hand for every picture.

Capability

Head Swap on reAPI

Manual head swap in an editor

Setup

None. An API key and one POST.

An editor licence, a mask, and someone who knows how to blend skin tones and edges.

Inputs

Two public image URLs: the target photo and the source head.

Layered files; the source head is cut out, scaled and rotated by hand.

What is transferred

Face, hair, ears and head outline from the source; the target's body, pose, light and background stay.

Whatever you mask; matching light and the neck edge is manual work.

Effort per image

Seconds of API time, no manual step.

Minutes to an hour per image, depending on hair and lighting.

Pricing structure

Flat rate per image; failed swaps are refunded.

Editor licence plus the editor's time, per image.

Reproducibility

Seed parameter: the same inputs and seed return the same image.

Every edit is unique; repeating a result means redoing it.

Comparison reflects publicly documented behavior at the time of writing. Model behavior and pricing can change; check the pricing card above and the API docs for current values.

Integrate Head Swap in three steps

step 01
Create an API key
Try Head Swap in the playground on this page first. For your own code, sign up, create a key in the dashboard, and pass it as a Bearer token.
Open
step 02
Submit the two photos
POST to /api/v1/images/generations with model: head-swap, image_url for the target photo and head_image_url for the source head. You get a task_id at once.
Open
step 03
Poll the result
GET /api/v1/tasks/:id until status is completed. The Head Swap image URL stays valid for 30 days; copy it to your own storage if you need it longer.
Open

docs/api/head-swap

API reference

Drop-in code and the full parameter table.

View full reference

curl -X POST https://reapi.ai/api/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "head-swap",
    "image_url": "https://example.com/target-photo.jpg",
    "head_image_url": "https://example.com/source-head.jpg"
  }'

Parameter validation failed

Rejected synchronously with the failing field named. Check enum values, ranges, and URL fields — nothing is charged.

Authentication or balance issue

401 means a missing or invalid Bearer key; 402 means the reserve exceeds your balance. Manage keys and credits in the console.

Content or material rejected

Reference material and outputs pass automated moderation. Rejected tasks fail with a clear error and a full refund.

Task failed or timed out

A task that reaches a failed state is never charged — the reserve refunds automatically. Keep the task id and retry when ready.

Frequently asked questions

Common questions about this model.

Head Swap is an AI head swap model on reAPI that replaces the entire head in one photo with the head from another: face, hair, ears and outline. Send a target photo and a source head, get one finished image back with the target's body, pose, lighting and background kept. The model id is head-swap on /api/v1/images/generations.