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.
- 1Maak een sleutel en kopieer hem direct
- 2Verstuur lokale media met consent=true
- 3Poll zolang de status PENDING of PROCESSING is
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
| Methode | Eindpunt | Doel | Creditformule |
|---|---|---|---|
| POST | /api/v1/face-swap/image | Gezichtswissel in afbeelding | 6 |
| POST | /api/v1/face-swap/video | Video-gezichtswissel | max(9, 3 × ceil(serverMeasuredInputSeconds)) |
| POST | /api/v1/face-swap/gif | GIF-gezichtswissel | max(9, 3 × ceil(serverMeasuredInputSeconds)) |
| POST | /api/v1/face-swap/multiple | Meerdere gezichten wisselen in afbeelding | 6 × selectedTargetFaces |
| GET | /api/v1/tasks | Taakgeschiedenis | 0 |
Rekenvoorbeelden
66 creditsmax(9, 3 × ceil(4))12 creditsmax(9, 3 × ceil(8))24 creditsmax(9, 3 × ceil(18))54 creditsVerzoekvelden 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.
/api/v1/face-swap/imageGezichtswissel in afbeelding
Pas één bronidentiteit toe op één doelfoto.
- Vereist
sourceImagetargetImageconsent=true- Optioneel
faceRestoreVisibilityrestoreVisibility
/api/v1/face-swap/videoVideo-gezichtswissel
Pas één bronidentiteit toe op een geüploade doelvideo.
- Vereist
sourceImagetargetVideoconsent=true- Optioneel
faceRestoreVisibilityrestoreVisibility
/api/v1/face-swap/gifGIF-gezichtswissel
Pas één bronidentiteit toe op een geüploade doel-GIF.
- Vereist
sourceImagetargetGifconsent=true- Optioneel
faceRestoreVisibilityrestoreVisibility
/api/v1/face-swap/multipleMeerdere gezichten wisselen in afbeelding
Vervang één tot tien geselecteerde gezichten in één groepsfoto.
- Vereist
sourceImagetargetFace0consent=true- Optioneel
targetFace1...targetFace9faceBox0...faceBox9
/api/v1/tasksTaakgeschiedenis
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.
Authorization: Bearer YOUR_API_KEYJavaScript- 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+
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
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 --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.