Ontwikkelaars-API · v1

Gezichtswissel-API voor afbeeldingen, video, GIF's en groepsfoto's

Gebruik via stabiele routes met versienummer dezelfde productiepijplijn als de webstudio's van FaceSwapAI. Authenticatie, echte creditformules, bestandslimieten, taakstatussen en foutafhandeling zijn gedocumenteerd op basis van de actieve handlers.

Live productiecontract · OpenAPI 3.1 · Bijgewerkt op 30 augustus 2026

Snel aan de slag

Maak een sleutel aan in je geverifieerde account, stuur vanaf je server een multipart-verzoek en poll daarna de bijbehorende GET-route met de geretourneerde taskId. Houd de geheime sleutel buiten browser- en mobiele clientbundels.

  1. 1Maak een sleutel en kopieer hem direct
  2. 2Verstuur lokale media met consent=true
  3. 3Poll zolang de status PENDING of PROCESSING is
cURL
curl --request POST https://faceswapai.com/api/v1/face-swap/image \
  --header "Authorization: Bearer $FACESWAPAI_API_KEY" \
  --form "sourceImage=@./source.jpg" \
  --form "targetImage=@./target.jpg" \
  --form "consent=true"

Eindpunten en exacte prijzen

MethodeEindpuntDoelCreditformule
POST/api/v1/face-swap/imageGezichtswissel in afbeelding6
POST/api/v1/face-swap/videoVideo-gezichtswisselmax(9, 3 × ceil(serverMeasuredInputSeconds))
POST/api/v1/face-swap/gifGIF-gezichtswisselmax(9, 3 × ceil(serverMeasuredInputSeconds))
POST/api/v1/face-swap/multipleMeerdere gezichten wisselen in afbeelding6 × selectedTargetFaces
GET/api/v1/tasksTaakgeschiedenis0

Rekenvoorbeelden

Eén afbeeldingstaak66 credits
Video van vier secondenmax(9, 3 × ceil(4))12 credits
GIF van acht secondenmax(9, 3 × ceil(8))24 credits
GIF van achttien secondenmax(9, 3 × ceil(18))54 credits

Verzoekvelden per eindpunt

Kies de route op basis van het doelmedium en stuur daarna precies de multipart-velden hieronder. Optionele herstelinstellingen accepteren waarden van 0 tot 1.

POST/api/v1/face-swap/image

Gezichtswissel in afbeelding

Pas één bronidentiteit toe op één doelfoto.

Vereist
sourceImagetargetImageconsent=true
Optioneel
faceRestoreVisibilityrestoreVisibility
POST/api/v1/face-swap/video

Video-gezichtswissel

Pas één bronidentiteit toe op een geüploade doelvideo.

Vereist
sourceImagetargetVideoconsent=true
Optioneel
faceRestoreVisibilityrestoreVisibility
POST/api/v1/face-swap/gif

GIF-gezichtswissel

Pas één bronidentiteit toe op een geüploade doel-GIF.

Vereist
sourceImagetargetGifconsent=true
Optioneel
faceRestoreVisibilityrestoreVisibility
POST/api/v1/face-swap/multiple

Meerdere gezichten wisselen in afbeelding

Vervang één tot tien geselecteerde gezichten in één groepsfoto.

Vereist
sourceImagetargetFace0consent=true
Optioneel
targetFace1...targetFace9faceBox0...faceBox9
GET/api/v1/tasks

Taakgeschiedenis

Toont de taken van het geverifieerde account.

Optioneel
pagepageSizestatustaskType

Pollen bij elke mediataak

Nadat een media-POST taskId retourneert, stuur je GET naar dezelfde mediaroute met taskId als queryparameter zolang de status PENDING of PROCESSING is. COMPLETED, FAILED en CANCELLED zijn eindstatussen.

Bearer-authenticatie

Stuur de sleutel bij elk verzoek mee als Authorization: Bearer YOUR_API_KEY. API-sleutels gebruiken het geverifieerde account en het actuele creditsaldo daarvan. De limiet op applicatieniveau voor geverifieerde verzoeken is 300 per minuut; de verwerkingscapaciteit blijft afhankelijk van de wachtrij.

HTTP
Authorization: Bearer YOUR_API_KEY

JavaScript- en Python-voorbeelden

Deze voorbeelden voor de server versturen twee lokale bestanden, stoppen bij HTTP-fouten, pollen de bijbehorende taakroute en tonen de tijdelijke resultaat-URL. Elk veld komt uit het live OpenAPI-contract.

JavaScriptNode.js 18+
JavaScript · Node.js 18+
import { readFile } from 'node:fs/promises';

const apiUrl = 'https://faceswapai.com/api/v1/face-swap/image';
const headers = {
  Authorization: 'Bearer ' + process.env.FACESWAPAI_API_KEY,
};
const form = new FormData();
form.set('sourceImage', new Blob([await readFile('./source.jpg')]), 'source.jpg');
form.set('targetImage', new Blob([await readFile('./target.jpg')]), 'target.jpg');
form.set('consent', 'true');

const submitted = await fetch(apiUrl, { method: 'POST', headers, body: form });
if (!submitted.ok) throw new Error(submitted.status + ': ' + await submitted.text());
const { taskId } = await submitted.json();

let task;
do {
  await new Promise((resolve) => setTimeout(resolve, 2000));
  const polled = await fetch(apiUrl + '?taskId=' + encodeURIComponent(taskId), { headers });
  if (!polled.ok) throw new Error(polled.status + ': ' + await polled.text());
  task = await polled.json();
} while (task.status === 'PENDING' || task.status === 'PROCESSING');

console.log(task.status === 'COMPLETED' ? task.result?.url : task.result?.error);
Pythonrequests 2.x
Python · requests 2.x
import os
import time
import requests

api_url = "https://faceswapai.com/api/v1/face-swap/image"
headers = {"Authorization": "Bearer " + os.environ["FACESWAPAI_API_KEY"]}

with open("source.jpg", "rb") as source, open("target.jpg", "rb") as target:
    response = requests.post(
        api_url,
        headers=headers,
        files={"sourceImage": source, "targetImage": target},
        data={"consent": "true"},
        timeout=60,
    )
response.raise_for_status()
task_id = response.json()["taskId"]

while True:
    time.sleep(2)
    response = requests.get(api_url, headers=headers, params={"taskId": task_id}, timeout=30)
    response.raise_for_status()
    task = response.json()
    if task["status"] not in ("PENDING", "PROCESSING"):
        break

result = task.get("result") or {}
print(result.get("url") if task["status"] == "COMPLETED" else result.get("error"))

Verzenden en daarna pollen

Een geslaagde POST reserveert de vereiste credits en retourneert taskId. Poll dezelfde mediaroute zolang de status PENDING of PROCESSING is. COMPLETED, FAILED en CANCELLED zijn eindstatussen. Bij een wachtrij- of providerfout wordt een lopende reservering precies één keer terugbetaald.

cURL
curl --get https://faceswapai.com/api/v1/face-swap/image \
  --header "Authorization: Bearer $FACESWAPAI_API_KEY" \
  --data-urlencode "taskId=YOUR_TASK_ID"
PENDING
Geaccepteerd en in de wachtrij geplaatst
PROCESSING
Actief
COMPLETED
Resultaat is beschikbaar
FAILED
Gestopt met een openbare foutmelding
CANCELLED
Geannuleerd

Formaten en limieten

Afbeeldingen accepteren JPG, PNG, WebP, GIF, BMP, HEIC of HEIF tot 30 MB. Video accepteert MP4, MOV, WebM of AVI tot 100 MB en 600 seconden. 100 MB is ongeveer 1–2 minuten gewone 1080p-video van een telefoon, dus comprimeer of knip langere clips in. GIF-doelen zijn beperkt tot 30 MB en 30 seconden. Invoer met meerdere gezichten is beperkt tot 15 MB per stuk en tien geselecteerde gezichten.

HTTP-fouten en opnieuw proberen

Herhaal verzoeken met een 400-, 401-, 402-, 403- of 413-antwoord niet zonder eerst het verzoek of de accountstatus te wijzigen. Wacht bij een 429 steeds langer voordat je het opnieuw probeert. Een 500 of 503 kun je na een pauze opnieuw proberen; gereserveerde credits zijn beschermd via de terugbetaling bij mislukte taken.

Huidige productiegrenzen

Plan op basis van het openbare v1-contract zoals het nu is, inclusief wat het niet belooft.

  • Mediataken zijn asynchroon en werken met polling. Het huidige openbare v1-contract biedt geen webhook.
  • Er is geen openbare batchroute, idempotentiesleutelveld, live-cameraroute, gepubliceerde SLA of gegarandeerde voltooiingstijd.
  • API-sleutels horen op een beveiligde server. Resultaten zijn tijdelijk, de verwerkingscapaciteit hangt af van de wachtrij en voor geaccepteerde taken die mislukken geldt de gedocumenteerde terugbetaling.

Toestemming, privacy en watermerk

Voor elke taak is consent=true vereist, wat betekent dat je toestemming hebt om elk geüpload gezicht te gebruiken. Taakmedia zijn tijdelijk. Er is geen gratis proefversie: elke taak wordt betaald met eenmalige credits, en geen enkel resultaat bevat een watermerk of het e-mailadres van het account.

Veelgestelde vragen over de gezichtswissel-API

Is er een gratis API-sleutel voor face swap?

Het aanmaken van een API-sleutel is gratis. Voor het genereren wordt het creditsaldo van je account gebruikt. Er is geen gratis proefversie en geen gratis API-laag: elke taak wordt betaald met eenmalige credits, vanaf 600 credits voor US$ 19,99.

Ondersteunt de API video en meerdere gezichten?

Ja. De routes met versienummer ondersteunen taken voor afbeeldingen, video, GIF en afbeeldingen met meerdere gezichten. De prijs voor video en GIF wordt berekend op basis van gemeten mediametadata.

Hoe weet ik wanneer een resultaat klaar is?

Lees taskId uit het POST-antwoord en poll de bijbehorende GET-route zolang de status PENDING of PROCESSING is. COMPLETED bevat de tijdelijke resultaat-URL; FAILED en CANCELLED zijn ook eindstatussen.

Kan ik de API rechtstreeks vanuit een browser aanroepen?

Zet nooit een geheime sleutel in browsercode. Verstuur verzoeken vanaf je eigen server, een serverless functie of een andere beveiligde backend.