Snabbstart
Skapa en nyckel i ditt verifierade konto, skicka en flerdelad begäran från din server och fråga sedan den matchande GET-rutten med det returnerade uppgifts-ID:t. Behåll hemligheten utanför webbläsar- och mobilklientpaket.
- 1Skapa och kopiera en nyckel en gång
- 2Skicka in lokala medier med samtycke=true
- 3Fråga medan status är PENDING eller PROCESSING
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"Slutpunkter och exakt prissättning
| Metod | Slutpunkt | Syfte | Kreditformel |
|---|---|---|---|
| POST | /api/v1/face-swap/image | Bildansiktsbyte | 6 |
| POST | /api/v1/face-swap/video | Video ansiktsbyte | max(9, 3 × ceil(serverMeasuredInputSeconds)) |
| POST | /api/v1/face-swap/gif | GIF ansiktsbyte | max(9, 3 × ceil(serverMeasuredInputSeconds)) |
| POST | /api/v1/face-swap/multiple | Bildbyte med flera ansikten | 6 × selectedTargetFaces |
| GET | /api/v1/tasks | Uppgiftshistorik | 0 |
Arbetade meritexempel
66 poängmax(9, 3 × ceil(4))12 poängmax(9, 3 × ceil(8))24 poängmax(9, 3 × ceil(18))54 poängBegäran fält per slutpunkt
Välj rutten efter målmedia och skicka sedan de exakta flerdelade fälten nedan. Valfria återställningskontroller accepterar nummer från 0 till 1.
/api/v1/face-swap/imageBildansiktsbyte
Tillämpa en källidentitet på ett målfoto.
- Krävs
sourceImagetargetImageconsent=true- Tillval
faceRestoreVisibilityrestoreVisibility
/api/v1/face-swap/videoVideo ansiktsbyte
Tillämpa en källidentitet i en uppladdad målvideo.
- Krävs
sourceImagetargetVideoconsent=true- Tillval
faceRestoreVisibilityrestoreVisibility
/api/v1/face-swap/gifGIF ansiktsbyte
Tillämpa en källidentitet i ett uppladdat mål GIF.
- Krävs
sourceImagetargetGifconsent=true- Tillval
faceRestoreVisibilityrestoreVisibility
/api/v1/face-swap/multipleBildbyte med flera ansikten
Ersätt ett till tio valda ansikten i ett gruppfoto.
- Krävs
sourceImagetargetFace0consent=true- Tillval
targetFace1...targetFace9faceBox0...faceBox9
/api/v1/tasksUppgiftshistorik
Lista uppgifter som ägs av det autentiserade kontot.
- Tillval
pagepageSizestatustaskType
Undersök varje medieuppgift
När en media-POST har returnerat taskId skickar du GET till samma mediarutt med taskId som frågeparameter medan status är PENDING eller PROCESSING. COMPLETED, FAILED och CANCELLED är slutstatusar.
Bärarautentisering
Skicka nyckeln i varje begäran som auktorisering: Bärare YOUR_API_KEY. API-nycklar ärver det verifierade kontot och dess livesaldo. Den autentiserade gränsen på applikationsnivå är 300 förfrågningar per minut; produktionskapaciteten förblir köberoende.
Authorization: Bearer YOUR_API_KEYJavaScript- och Python-exempel
Dessa exempel på serversidan skickar två lokala filer, avvisar HTTP-fel, pollar den matchande uppgiftsvägen och skriver ut den tillfälliga resultat-URL:n. Varje fält kommer från det levande OpenAPI-kontraktet.
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"))Skicka in och omröstning
En lyckad POST reserverar nödvändiga krediter och returnerar taskId. Fråga samma mediarutt medan status är PENDING eller PROCESSING. COMPLETED, FAILED och CANCELLED är slutstatusar. Ett kö- eller leverantörsfel återbetalar en väntande reservation exakt en gång.
curl --get https://faceswapai.com/api/v1/face-swap/image \
--header "Authorization: Bearer $FACESWAPAI_API_KEY" \
--data-urlencode "taskId=YOUR_TASK_ID"- PENDING
- Godkänd och köad
- PROCESSING
- Kör
- COMPLETED
- Resultat är tillgängligt
- FAILED
- Slutade med ett offentligt fel
- CANCELLED
- Avbruten
Format och begränsningar
Bilder accepterar JPG, PNG, WebP, GIF, BMP, HEIC eller HEIF upp till 30 MB. Video accepterar MP4, MOV, WebM eller AVI upp till 100 MB och 600 sekunder. 100 MB motsvarar ungefär 1–2 minuter vanlig 1080p-mobilvideo, så komprimera eller korta längre klipp. GIF-mål är begränsade till 30 MB och 30 sekunder. Fleransiktsingångar är begränsade till 15 MB vardera och tio utvalda ansikten.
HTTP-fel och försök igen
Försök inte igen 400, 401, 402, 403 eller 413 svar utan att ändra begäran eller kontostatus. Backa på 429. En 500 eller 503 kan provas igen efter en fördröjning; kreditreservationer skyddas av uppgiftens återbetalningsväg.
Nuvarande produktionsgränser
Plan mot det offentliga v1-kontraktet som finns idag, inklusive vad det inte gör anspråk på.
- Medieuppgifter är asynkrona och använder polling. Det nuvarande offentliga v1-kontraktet exponerar inte en webhook.
- Det finns ingen offentlig batchrutt, idempotensnyckelfält, livekamerarutt, publicerad SLA eller garanterad slutförandetid.
- API-nycklar hör hemma på en skyddad server. Resultaten är tillfälliga, produktionskapaciteten är köberoende och accepterade fel använder den dokumenterade återbetalningsvägen.
Samtycke, integritet och vattenstämpel
Varje generation kräver samtycke=true, vilket betyder att du har tillstånd att använda alla uppladdade ansikten. Uppgiftsmediet är tillfälligt. Det finns ingen gratis provperiod: varje uppgift betalas med engångskrediter, och inget resultat innehåller vattenstämpel eller kontots e-postadress.
Ansiktsbyte API FAQ
Finns det en gratis Face Swap API-nyckel?
Det är gratis att skapa en API-nyckel. Generation använder kontosaldot. Det finns ingen gratis provperiod eller gratis API-nivå: varje uppgift betalas med engångskrediter, från 600 krediter för 19,99 US$.
Stöder API video och flera ansikten?
Ja. Versionerade rutter täcker bilder, video, GIF och bilduppgifter med flera ansikten. Prissättning för video och GIF beräknas från uppmätta mediametadata.
Hur vet jag när ett resultat är klart?
Läs taskId från POST-svaret och fråga motsvarande GET-rutt medan status är PENDING eller PROCESSING. COMPLETED innehåller den tillfälliga resultat-URL:en; FAILED och CANCELLED är också slutstatusar.
Kan jag ringa API direkt från en webbläsare?
Avslöja inte en hemlig nyckel i webbläsarkoden. Skicka förfrågningar från din egen server, serverlös funktion eller annan skyddad backend.