فوری آغاز
اپنے تصدیق شدہ اکاؤنٹ میں ایک کلید بنائیں، اپنے سرور سے ملٹی پارٹ درخواست بھیجیں، پھر واپس کردہ ٹاسک آئی ڈی کے ساتھ مماثل GET روٹ کو پول کریں۔ براؤزر اور موبائل کلائنٹ بنڈلز کے باہر راز رکھیں۔
- 1ایک بار ایک کلید بنائیں اور کاپی کریں۔
- 2مقامی میڈیا کو رضامندی کے ساتھ جمع کروائیں=سچ
- 3اسٹیٹس PENDING یا 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"اختتامی پوائنٹس اور عین مطابق قیمت
| طریقہ | اینڈ پوائنٹ | مقصد | کریڈٹ فارمولا |
|---|---|---|---|
| POST | /api/v1/face-swap/image | تصویر کے چہرے کا تبادلہ | 6 |
| POST | /api/v1/face-swap/video | ویڈیو کے چہرے کا تبادلہ | max(9, 3 × ceil(serverMeasuredInputSeconds)) |
| POST | /api/v1/face-swap/gif | GIF چہرے کا تبادلہ | 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 کریڈٹسmax(9, 3 × ceil(8))24 کریڈٹسmax(9, 3 × ceil(18))54 کریڈٹساختتامی نقطہ کے ذریعہ فیلڈز کی درخواست کریں۔
ٹارگٹ میڈیا کے ذریعہ روٹ کا انتخاب کریں، پھر ذیل میں عین مطابق ملٹی پارٹ فیلڈز بھیجیں۔ اختیاری بحالی کنٹرولز 0 سے 1 تک نمبروں کو قبول کرتے ہیں۔
/api/v1/face-swap/imageتصویر کے چہرے کا تبادلہ
ایک ٹارگٹ فوٹو پر ایک ماخذ کی شناخت کا اطلاق کریں۔
- درکار ہے۔
sourceImagetargetImageconsent=true- اختیاری
faceRestoreVisibilityrestoreVisibility
/api/v1/face-swap/videoویڈیو کے چہرے کا تبادلہ
اپ لوڈ کردہ ٹارگٹ ویڈیو میں ایک ماخذ کی شناخت کا اطلاق کریں۔
- درکار ہے۔
sourceImagetargetVideoconsent=true- اختیاری
faceRestoreVisibilityrestoreVisibility
/api/v1/face-swap/gifGIF چہرے کا تبادلہ
اپ لوڈ کردہ ہدف GIF میں ایک ماخذ کی شناخت کا اطلاق کریں۔
- درکار ہے۔
sourceImagetargetGifconsent=true- اختیاری
faceRestoreVisibilityrestoreVisibility
/api/v1/face-swap/multipleایک سے زیادہ چہرے والی تصویر کا تبادلہ
ایک گروپ فوٹو میں ایک سے دس منتخب چہروں کو تبدیل کریں۔
- درکار ہے۔
sourceImagetargetFace0consent=true- اختیاری
targetFace1...targetFace9faceBox0...faceBox9
/api/v1/tasksٹاسک کی سرگزشت
تصدیق شدہ اکاؤنٹ کی ملکیت والے کاموں کی فہرست بنائیں۔
- اختیاری
pagepageSizestatustaskType
میڈیا کے ہر کام کو پول کریں۔
میڈیا POST سے taskId ملنے کے بعد، اسٹیٹس PENDING یا PROCESSING رہنے تک taskId کو کوئری پیرامیٹر بنا کر اسی میڈیا روٹ پر GET بھیجیں۔ COMPLETED، FAILED اور CANCELLED آخری اسٹیٹس ہیں۔
بیئرر کی توثیق
ہر درخواست میں کلید بطور اجازت بھیجیں: بیئرر YOUR_API_KEY۔ API کیز تصدیق شدہ اکاؤنٹ اور اس کے لائیو کریڈٹ بیلنس کی وارث ہوتی ہیں۔ درخواست کی سطح کی توثیق شدہ حد 300 درخواستیں فی منٹ ہے۔ نسل کی صلاحیت قطار پر منحصر رہتی ہے۔
Authorization: Bearer YOUR_API_KEYJavaScript اور Python کی مثالیں۔
یہ سرور سائیڈ مثالیں دو مقامی فائلیں جمع کراتی ہیں، HTTP ناکامیوں کو مسترد کرتی ہیں، مماثل ٹاسک روٹ کو پول کرتی ہیں اور عارضی نتیجہ کا URL پرنٹ کرتی ہیں۔ ہر فیلڈ لائیو OpenAPI معاہدے سے آتا ہے۔
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"))جمع کروائیں، پھر پول کریں۔
کامیاب POST مطلوبہ کریڈٹس محفوظ کرتا اور taskId واپس کرتا ہے۔ اسٹیٹس PENDING یا PROCESSING رہنے تک اسی میڈیا روٹ کو پول کریں۔ COMPLETED، FAILED اور CANCELLED آخری اسٹیٹس ہیں۔ قطار یا فراہم کنندہ کی ناکامی زیر التوا ریزرویشن ٹھیک ایک بار واپس کرتی ہے۔
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 کو کال کرسکتا ہوں؟
براؤزر کوڈ میں خفیہ کلید کو ظاہر نہ کریں۔ اپنے سرور، سرور لیس فنکشن یا دوسرے محفوظ پسدید سے درخواستیں بھیجیں۔