swapface

Name: swapface API
Brand: Insight Face

by Insight FaceImage

swapface is available through TTAPI. Insight Face SwapFace creates asynchronous face-swap tasks from a target image and a source face image.

View examples API reference

InputPrompttext

Models1available

FlowAsyncresult URL

Price2 quota/ task

Face swap workflowSource + target → result

Before / after

Source face for the primary SwapFace comparison — **Source face**Identity

Target portrait before the primary face swap — **Target photo**Pose & scene

Final portrait after the primary face swap — **Swap result**Final composite

Examples

Face swap results, side by side

Case 01Natural portrait swap

Before → after

Source face for SwapFace comparison one — **Source face**Identity

Target portrait before SwapFace comparison one — **Target photo**Pose & scene

Face-swap result for comparison one — **Swap result**Final composite

A clean identity replacement that preserves the target portrait's framing and tonal balance.

Case 02Pose-preserving composite

Before → after

Source face for SwapFace comparison two — **Source face**Identity

Target photo before SwapFace comparison two — **Target photo**Pose & scene

Face-swap result for comparison two — **Swap result**Final composite

The result keeps the target pose and scene while adapting the source facial identity.

Case 03Lighting-aware replacement

Before → after

Source face for SwapFace comparison three — **Source face**Identity

Target portrait before SwapFace comparison three — **Target photo**Pose & scene

Face-swap result for comparison three — **Swap result**Final composite

Facial features blend into the target image while retaining its direction of light and color mood.

Case 04Scene-consistent face swap

Before → after

Source face for SwapFace comparison four — **Source face**Identity

Target image before SwapFace comparison four — **Target photo**Pose & scene

Face-swap result for comparison four — **Swap result**Final composite

The composite changes identity without replacing the target image's surrounding scene or styling.

Capabilities

What you can build with swapface

Prompt driven generation

Submit a concise prompt and get production-ready image output through one TTAPI job.

Core controls only

Keep integration simple with prompt, model, output settings, and callback handling.

Async result flow

Use polling or webhook callbacks so long-running generations do not block your UI.

Ready for product UI

Return SwapFace results that can be displayed, stored, or passed into downstream workflows.

Pricing

Per-action, in quota

Usage is metered in quota by model, action, and output settings.

Face swapOfficial pricing

OperationCostUnit

Submit swap task2 quota/ task

Fetch resultFree/ request

API request

Headers and submit parameters

Use the endpoint below with your TTAPI key and the request fields shown.

SwapPOST

/insightFace/v1/swap

Submit an asynchronous face-swap task.

Official reference

FetchGET

/insightFace/v1/fetch

Retrieve a face-swap task result.

Official reference

POSThttps://api.ttapi.io/insightFace/v1/swap

Headers

TT-API-KEYstringrequired

Your TTAPI API key.

Content-Typestringrequired

Use application/json.

Body

targetImagestringrequired

URL of the image whose face will be replaced.

swapImagestringrequired

URL of the source face image.

hookUrlstringoptional

Callback URL for task completion.

Open the official TTAPI documentation

Integrate

From key to first result

Copy the resolved endpoint, authentication headers, and request body for this model.

curl --request POST \
  --url https://api.ttapi.io/insightFace/v1/swap \
  --header 'TT-API-KEY: $TTAPI_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"targetImage":"https://example.com/target.jpg","swapImage":"https://example.com/source.jpg","hookUrl":"https://example.com/callback"}'

swapface

Face swap results, side by side

What you can build with swapface

Prompt driven generation

Core controls only

Async result flow

Ready for product UI

Per-action, in quota

Headers and submit parameters

Headers

Body

From key to first result

You might also use

gpt-image-2

Nano Banana 2

Grok Image