Models

Face Swap Base

Stable

Fast face swap. Upload a body/scene image and a face image; the model places the face onto the body. Output matches the body image dimensions. For a 4K finish use FaceSwap PRO.

Product id

kiara-head-swap

Price

$0.05 / call

Output

image (jpeg)

Avg latency

~40s

Parameters

Inputs

Send these in the JSON body of a POST /v1/generations request alongside "product": "kiara-head-swap".

source_image_urlurlRequired

HTTPS URL to the primary input image this model transforms. Must be publicly reachable for the duration of the job.

second_image_urlurlRequired

HTTPS URL to the face image placed onto the body image.

promptstringRequired

Text prompt that describes what to generate. 1–4000 characters. Be specific — subject, lighting, lens, mood, action.

seedintegerOptional0 – 4,294,967,295

Deterministic seed. Same seed + same prompt = same image. Omit for a random seed.

webhook_urlurlOptional

HTTPS callback fired when the job reaches a terminal state. HMAC-SHA256 signed. See the Webhooks guide.

metadataobjectOptional

Arbitrary JSON object echoed back on retrieval and in the webhook. Useful for correlating jobs to your records. ≤ 4 KB.

POST /v1/generations — full reference for the create endpoint.
Playground — try this model inline with your key.

Quick call

POSTFace Swap Base/v1/generations

curl https://api.kiara-api.com/v1/generations \
  -H "Authorization: Bearer $KIARA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
       "product": "kiara-head-swap",
       "source_image_url": "https://example.com/source.jpg",
       "prompt": "your prompt here"
     }'