swapface

Name: swapface API
Brand: Insight Face

by Insight FaceImage

SwapFace is an Insight Face image editing API on TTAPI. Submit a target image and a source face image as an async face-swap job, then fetch the result.

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

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