API docs are currently maintained in English. Navigation and route behavior remain available for this locale.

Developers

AI Face Swap API

A Resend-style developer surface for creating face-swap tasks, polling status, and receiving signed webhooks through a versioned REST API.

Get API keyView pricing
RESTBearer authJSON responses

First calls

GET /me
curl -sS https://aifacesswap.com/api/v1/me \
  -H "Authorization: Bearer $AIFACESWAP_API_KEY"
POST /swaps
curl -sS -X POST https://aifacesswap.com/api/v1/swaps \
  -H "Authorization: Bearer $AIFACESWAP_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "type": "image",
    "source_url": "https://example.com/face.jpg",
    "target_url": "https://example.com/target.jpg"
  }'

Server-side only. Keep API keys out of client bundles.

One API surface for automated face-swap workflows

Start with a key, create a task, then poll or listen for a signed webhook. Use the pages below when you need deeper implementation detail.

Create swaps from URLs

Submit public HTTPS source and target media. We fetch, scan, copy, and queue the work for you.

Poll or receive webhooks

Use task status polling for simple integrations, or signed webhooks for production automation.

Safe retries by default

Idempotency keys prevent duplicate tasks and duplicate charges when callers retry create requests.

Explore the docs

Quickstart

First request in three steps

Agent skill

Copy-paste instructions for AI agents

Authentication

Keys, lifecycle, and limits

API reference

Endpoint contracts

Webhooks

Callbacks and signatures

Errors

Error envelope and caller actions

Samples

curl, Node, and Python examples