Models

FaceSwap PRO

Stable

Premium head swap with a 4K finish. Upload a body/scene image and a face reference; the model swaps the face onto the body and runs a 4K upscale. Use this when the output needs to be print-ready.

Product id

kiara-face-studio-pro

Price

$0.05 / call

Output

image (jpeg)

Avg latency

~90s

Parameters

Inputs

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

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

POSTFaceSwap PRO/v1/generations

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