ڈویلپر API · v1

تصاویر، ویڈیو، GIFs اور گروپ فوٹوز کے لیے فیس سویپ API

اسی پروڈکشن ٹاسک پائپ لائن کا استعمال کریں جیسا کہ FaceSwapAI ویب اسٹوڈیوز مستحکم ورژن والے راستوں کے ذریعے۔ توثیق، حقیقی کریڈٹ فارمولے، فائل کی حدیں، کام کی حالتیں اور ناکامی کے رویے کو چلانے والے ہینڈلرز سے دستاویز کیا جاتا ہے۔

لائیو پروڈکشن کا معاہدہ · OpenAPI 3.1 · 30 اگست 2026 کو اپ ڈیٹ کیا گیا

فوری آغاز

اپنے تصدیق شدہ اکاؤنٹ میں ایک کلید بنائیں، اپنے سرور سے ملٹی پارٹ درخواست بھیجیں، پھر واپس کردہ ٹاسک آئی ڈی کے ساتھ مماثل GET روٹ کو پول کریں۔ براؤزر اور موبائل کلائنٹ بنڈلز کے باہر راز رکھیں۔

  1. 1ایک بار ایک کلید بنائیں اور کاپی کریں۔
  2. 2مقامی میڈیا کو رضامندی کے ساتھ جمع کروائیں=سچ
  3. 3اسٹیٹس PENDING یا 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"

اختتامی پوائنٹس اور عین مطابق قیمت

طریقہاینڈ پوائنٹمقصدکریڈٹ فارمولا
POST/api/v1/face-swap/imageتصویر کے چہرے کا تبادلہ6
POST/api/v1/face-swap/videoویڈیو کے چہرے کا تبادلہmax(9, 3 × ceil(serverMeasuredInputSeconds))
POST/api/v1/face-swap/gifGIF چہرے کا تبادلہmax(9, 3 × ceil(serverMeasuredInputSeconds))
POST/api/v1/face-swap/multipleایک سے زیادہ چہرے والی تصویر کا تبادلہ6 × selectedTargetFaces
GET/api/v1/tasksٹاسک کی سرگزشت0

کام کی کریڈٹ کی مثالیں۔

ایک تصویر کا کام66 کریڈٹس
چار سیکنڈ کی ویڈیوmax(9, 3 × ceil(4))12 کریڈٹس
آٹھ سیکنڈ کی GIFmax(9, 3 × ceil(8))24 کریڈٹس
اٹھارہ سیکنڈ کی GIFmax(9, 3 × ceil(18))54 کریڈٹس

اختتامی نقطہ کے ذریعہ فیلڈز کی درخواست کریں۔

ٹارگٹ میڈیا کے ذریعہ روٹ کا انتخاب کریں، پھر ذیل میں عین مطابق ملٹی پارٹ فیلڈز بھیجیں۔ اختیاری بحالی کنٹرولز 0 سے 1 تک نمبروں کو قبول کرتے ہیں۔

POST/api/v1/face-swap/image

تصویر کے چہرے کا تبادلہ

ایک ٹارگٹ فوٹو پر ایک ماخذ کی شناخت کا اطلاق کریں۔

درکار ہے۔
sourceImagetargetImageconsent=true
اختیاری
faceRestoreVisibilityrestoreVisibility
POST/api/v1/face-swap/video

ویڈیو کے چہرے کا تبادلہ

اپ لوڈ کردہ ٹارگٹ ویڈیو میں ایک ماخذ کی شناخت کا اطلاق کریں۔

درکار ہے۔
sourceImagetargetVideoconsent=true
اختیاری
faceRestoreVisibilityrestoreVisibility
POST/api/v1/face-swap/gif

GIF چہرے کا تبادلہ

اپ لوڈ کردہ ہدف GIF میں ایک ماخذ کی شناخت کا اطلاق کریں۔

درکار ہے۔
sourceImagetargetGifconsent=true
اختیاری
faceRestoreVisibilityrestoreVisibility
POST/api/v1/face-swap/multiple

ایک سے زیادہ چہرے والی تصویر کا تبادلہ

ایک گروپ فوٹو میں ایک سے دس منتخب چہروں کو تبدیل کریں۔

درکار ہے۔
sourceImagetargetFace0consent=true
اختیاری
targetFace1...targetFace9faceBox0...faceBox9
GET/api/v1/tasks

ٹاسک کی سرگزشت

تصدیق شدہ اکاؤنٹ کی ملکیت والے کاموں کی فہرست بنائیں۔

اختیاری
pagepageSizestatustaskType

میڈیا کے ہر کام کو پول کریں۔

میڈیا POST سے taskId ملنے کے بعد، اسٹیٹس PENDING یا PROCESSING رہنے تک taskId کو کوئری پیرامیٹر بنا کر اسی میڈیا روٹ پر GET بھیجیں۔ COMPLETED، FAILED اور CANCELLED آخری اسٹیٹس ہیں۔

بیئرر کی توثیق

ہر درخواست میں کلید بطور اجازت بھیجیں: بیئرر YOUR_API_KEY۔ API کیز تصدیق شدہ اکاؤنٹ اور اس کے لائیو کریڈٹ بیلنس کی وارث ہوتی ہیں۔ درخواست کی سطح کی توثیق شدہ حد 300 درخواستیں فی منٹ ہے۔ نسل کی صلاحیت قطار پر منحصر رہتی ہے۔

HTTP
Authorization: Bearer YOUR_API_KEY

JavaScript اور Python کی مثالیں۔

یہ سرور سائیڈ مثالیں دو مقامی فائلیں جمع کراتی ہیں، HTTP ناکامیوں کو مسترد کرتی ہیں، مماثل ٹاسک روٹ کو پول کرتی ہیں اور عارضی نتیجہ کا URL پرنٹ کرتی ہیں۔ ہر فیلڈ لائیو OpenAPI معاہدے سے آتا ہے۔

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

جمع کروائیں، پھر پول کریں۔

کامیاب POST مطلوبہ کریڈٹس محفوظ کرتا اور taskId واپس کرتا ہے۔ اسٹیٹس PENDING یا PROCESSING رہنے تک اسی میڈیا روٹ کو پول کریں۔ COMPLETED، FAILED اور CANCELLED آخری اسٹیٹس ہیں۔ قطار یا فراہم کنندہ کی ناکامی زیر التوا ریزرویشن ٹھیک ایک بار واپس کرتی ہے۔

cURL
curl --get https://faceswapai.com/api/v1/face-swap/image \
  --header "Authorization: Bearer $FACESWAPAI_API_KEY" \
  --data-urlencode "taskId=YOUR_TASK_ID"
PENDING
قبول اور قطار میں
PROCESSING
چل رہا ہے۔
COMPLETED
نتیجہ دستیاب ہے۔
FAILED
عوامی غلطی کے ساتھ روک دیا گیا۔
CANCELLED
منسوخ کر دیا گیا۔

فارمیٹس اور حدود

تصاویر JPG, PNG, WebP, GIF, BMP, HEIC یا HEIF کو 30 MB تک قبول کرتی ہیں۔ ویڈیو MP4، MOV، WebM یا AVI کو 100 MB اور 600 سیکنڈ تک قبول کرتی ہے۔ 100 MB عام فون کی 1080p ویڈیو کے تقریباً 1–2 منٹ کے برابر ہے، اس لیے لمبے کلپس کو کمپریس یا چھوٹا کر لیں۔ GIF اہداف 30 MB اور 30 ​​سیکنڈ تک محدود ہیں۔ ایک سے زیادہ چہرے والے ان پٹ ہر ایک اور دس منتخب چہروں تک 15 MB تک محدود ہیں۔

HTTP غلطیاں اور دوبارہ کوششیں۔

درخواست یا اکاؤنٹ کی حالت کو تبدیل کیے بغیر 400، 401، 402، 403 یا 413 جوابات کی دوبارہ کوشش نہ کریں۔ 429 پر واپس آنا۔ تاخیر کے بعد 500 یا 503 کی دوبارہ کوشش کی جا سکتی ہے۔ کریڈٹ ریزرویشنز ٹاسک ریفنڈ پاتھ سے محفوظ ہیں۔

موجودہ پیداواری حدود

عوامی v1 معاہدے کے خلاف منصوبہ بنائیں جو آج موجود ہے، بشمول وہ جس کا دعویٰ نہیں کرتا ہے۔

  • میڈیا کے کام غیر مطابقت پذیر ہیں اور پولنگ کا استعمال کرتے ہیں۔ موجودہ عوامی v1 معاہدہ کسی ویب ہک کو بے نقاب نہیں کرتا ہے۔
  • کوئی عوامی بیچ روٹ، آئیڈیمپوٹینسی کلیدی فیلڈ، لائیو کیمرہ روٹ، شائع شدہ SLA یا تکمیلی وقت کی ضمانت نہیں ہے۔
  • API کیز ایک محفوظ سرور سے تعلق رکھتی ہیں۔ نتائج عارضی ہیں، پیداواری صلاحیت قطار پر منحصر ہے اور قبول شدہ ناکامیاں دستاویزی رقم کی واپسی کا راستہ استعمال کرتی ہیں۔

رضامندی، رازداری اور واٹر مارک

ہر نسل کو consent=true کی ضرورت ہوتی ہے، یعنی آپ کو ہر اپ لوڈ کردہ چہرہ استعمال کرنے کی اجازت ہے۔ ٹاسک میڈیا عارضی ہے۔ کوئی مفت ٹرائل نہیں ہے: ہر کام ایک وقتی کریڈٹس سے ادا ہوتا ہے، اور کسی نتیجے میں نہ واٹر مارک ہوتا ہے اور نہ اکاؤنٹ ای میل۔

فیس سویپ API کے عام سوالات

کیا کوئی مفت فیس سویپ API کلید ہے؟

API کلید بنانا مفت ہے۔ جنریشن اکاؤنٹ کریڈٹ بیلنس استعمال کرتی ہے۔ کوئی مفت ٹرائل یا مفت API درجہ نہیں ہے: ہر کام ایک وقتی کریڈٹس سے ادا ہوتا ہے، 600 کریڈٹس $19.99 سے شروع۔

کیا API ویڈیو اور متعدد چہروں کو سپورٹ کرتا ہے؟

ہاں۔ ورژن شدہ راستے تصویر، ویڈیو، GIF اور ایک سے زیادہ چہرے والی تصویر کے کاموں کا احاطہ کرتے ہیں۔ ویڈیو اور GIF قیمتوں کا حساب ماپا میڈیا میٹا ڈیٹا سے کیا جاتا ہے۔

مجھے کیسے پتہ چلے گا کہ نتیجہ کب تیار ہے؟

POST جواب سے taskId پڑھیں اور اسٹیٹس PENDING یا PROCESSING رہنے تک متعلقہ GET روٹ پول کریں۔ COMPLETED میں عارضی نتیجہ URL شامل ہے؛ FAILED اور CANCELLED بھی آخری اسٹیٹس ہیں۔

کیا میں براہ راست براؤزر سے API کو کال کرسکتا ہوں؟

براؤزر کوڈ میں خفیہ کلید کو ظاہر نہ کریں۔ اپنے سرور، سرور لیس فنکشن یا دوسرے محفوظ پسدید سے درخواستیں بھیجیں۔