Utvecklar-API · v1

API för ansiktsbyte i bilder, video, GIF och gruppfoton

Använd samma produktionsuppgiftspipeline som FaceSwapAI webbstudior genom stabila versioner av rutter. Autentisering, riktiga kreditformler, filgränser, uppgiftstillstånd och felbeteende dokumenteras från de körande hanterarna.

Live produktionskontrakt · OpenAPI 3.1 · Uppdaterad 30 augusti 2026

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.

  1. 1Skapa och kopiera en nyckel en gång
  2. 2Skicka in lokala medier med samtycke=true
  3. 3Fråga medan status är PENDING eller PROCESSING
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"

Slutpunkter och exakt prissättning

MetodSlutpunktSyfteKreditformel
POST/api/v1/face-swap/imageBildansiktsbyte6
POST/api/v1/face-swap/videoVideo ansiktsbytemax(9, 3 × ceil(serverMeasuredInputSeconds))
POST/api/v1/face-swap/gifGIF ansiktsbytemax(9, 3 × ceil(serverMeasuredInputSeconds))
POST/api/v1/face-swap/multipleBildbyte med flera ansikten6 × selectedTargetFaces
GET/api/v1/tasksUppgiftshistorik0

Arbetade meritexempel

En bilduppgift66 poäng
Fyra sekunders videomax(9, 3 × ceil(4))12 poäng
Åtta sekunders GIFmax(9, 3 × ceil(8))24 poäng
Arton sekunders GIFmax(9, 3 × ceil(18))54 poäng

Begä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.

POST/api/v1/face-swap/image

Bildansiktsbyte

Tillämpa en källidentitet på ett målfoto.

Krävs
sourceImagetargetImageconsent=true
Tillval
faceRestoreVisibilityrestoreVisibility
POST/api/v1/face-swap/video

Video ansiktsbyte

Tillämpa en källidentitet i en uppladdad målvideo.

Krävs
sourceImagetargetVideoconsent=true
Tillval
faceRestoreVisibilityrestoreVisibility
POST/api/v1/face-swap/gif

GIF ansiktsbyte

Tillämpa en källidentitet i ett uppladdat mål GIF.

Krävs
sourceImagetargetGifconsent=true
Tillval
faceRestoreVisibilityrestoreVisibility
POST/api/v1/face-swap/multiple

Bildbyte med flera ansikten

Ersätt ett till tio valda ansikten i ett gruppfoto.

Krävs
sourceImagetargetFace0consent=true
Tillval
targetFace1...targetFace9faceBox0...faceBox9
GET/api/v1/tasks

Uppgiftshistorik

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.

HTTP
Authorization: Bearer YOUR_API_KEY

JavaScript- 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+
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"))

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
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.