SwapFace

Name: SwapFace API
Brand: Insight Face

by Insight FaceImage

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 quotaper task

Editorial portrait face-swap example — crop 1

Portrait compositeCrop 1

Editorial portrait face-swap example — crop 2

Portrait compositeCrop 2

Editorial portrait face-swap example — crop 3

Portrait compositeCrop 3

Editorial portrait face-swap example — crop 4

Portrait compositeCrop 4

Examples

Prompt to image, in context

Example inputswapface

Target image

https://example.com/target.jpg

Source: Face image URL

Example resultExample output

Portrait composite

A natural-looking editorial portrait composite with consistent lighting and skin tone.

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"}'