This API puts FazeSwap’s face and video models behind an HTTP call. You post an image, a clip or a live stream; you get back the same thing with a different face on it. Seven features, one key, nothing to install.

Two shapes of call. Most features are asynchronous: you submit a job, poll it, and collect a signed URL when it finishes. Full Live Swap is a session — you open it, stream through it, and close it, charged by the second you actually use.

Every call is authenticated with a bearer key and paid for from a balance you top up in advance. Nothing recurring, no floor to clear, and a failed job costs nothing.

Three steps to your first render: upload an asset, submit a job, poll for the result.

# 1 · Upload an asset → get a file_key
FILE_KEY=$(curl -s https://api.fazeswap.com/api/v1/uploads \
  -H "Authorization: Bearer $FAZESWAP_API_KEY" \
  -F "file=@base.png" | jq -r .file_key)

# 2 · Submit the job
JOB=$(curl -s https://api.fazeswap.com/api/v1/face-swap-image \
  -H "Authorization: Bearer $FAZESWAP_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"image_key\":\"$FILE_KEY\",\"face_key\":\"$FACE_KEY\"}")

# 3 · Poll until it is terminal
curl -s https://api.fazeswap.com/api/v1/jobs/$(echo "$JOB" | jq -r .id) \
  -H "Authorization: Bearer $FAZESWAP_API_KEY"

Send your key as a bearer token on every request.

Authorization: Bearer fzs_live_xxxxxxxxxxxxxxxxxxxxxxxx

Capability calls reference inputs by file_key, not by URL. Upload each asset first and pass back the key you get. We host the upload — there is no CORS or presign dance, and no external URLs are fetched.

{
  "file_key": "api/images/9f8c…/base.png",
  "url": "https://…"
}

Images and audio up to 45 MB, video up to 500 MB.

Every capability except Full Live Swap is asynchronous: a submit returns immediately with an id, and you poll its status URL until it reaches a terminal state.

{
  "id": "…",
  "status": "queued | processing | succeeded | failed",
  "output_url": "https://…",
  "charged_usd": 0.06,
  "error": { "code": "face_not_detected", "message": "…" }
}

You are billed when a job completes. A job that fails is refunded in full — you are never charged for a result you did not get.

Send an Idempotency-Key header on any submit. A retry carrying the same key returns the original job — no second charge, no duplicate render. A network timeout costs you nothing.

-H "Idempotency-Key: your-own-unique-id"

60 requests per minute by default. Exceeding it returns 429 with code rate_limited.

Errors carry a stable code you can branch on and a message meant for a human. Branch on the code — the prose may change, the codes will not.

Put your character into a reference video, keeping its motion.

Swap a face into a video.

Swap a face into a single image.

curl https://api.fazeswap.com/api/v1/face-swap-image \
  -H "Authorization: Bearer $FAZESWAP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image_key":"api/images/…","face_key":"api/images/…"}'

Animate a still character image to match a reference video’s motion.

A talking avatar from one portrait and a script.

Match a video’s mouth movement to your audio.

Real-time face swap over a live stream. Unlike the others this is a session, not a job: create one, connect over WebSocket, and stream.

{
  "session_id": "…",
  "stream_url": "wss://api.fazeswap.com/realtime",
  "session_token": "rt_…",
  "max_duration_sec": 600,
  "max_cost_usd": 25.00
}

Real-time voice conversion. Like Full Live Swap this is a session rather than a job: open one, stream audio frames over the socket, and receive converted audio back on the same connection.

Pick a target voice first. The reference clip stays on our side — you never handle it.

[
  {
    "id": "8f2c…",
    "name": "Narrator",
    "description": "Warm, measured.",
    "preview_url": "https://…/preview.mp3"
  }
]

{
  "session_id": "…",
  "stream_url": "wss://api.fazeswap.com/realtime",
  "session_token": "rt_…",
  "max_duration_sec": 600,
  "max_cost_usd": 3.60
}

On connect we hand the engine your chosen voice, then send you one JSON frame with the audio format to use in both directions:

{ "sample_rate": 22050, "chunk_frames": 4096 }

After that it is audio both ways: send raw mono PCM (int16, little-endian, at the sample_rate above) as binary frames, and converted audio comes back in the same format. Send roughly chunk_frames per message — much smaller wastes round-trips, much larger adds latency.

Check your prepaid balance and spend from your own system.

{
  "balance_usd": 84.20,
  "total_spent_usd": 15.80,
  "spent_this_week_usd": 4.10,
  "spent_this_month_usd": 15.80,
  "spent_this_year_usd": 15.80
}

Use /usage/summary for totals — it is computed from your full history. The /usage log is capped at 500 rows, so summing it under-reports once you are busy.

Live rates, read from the API itself — this table cannot go stale. Public, no authentication required.