پروڈکشن API حوالہ

DeepSwapAI: AI فیس سویپ API

فوٹو، فوٹو بیچ، میپ شدہ گروپ فوٹو، ویڈیو اور GIF فیس سوئپ کو ایک ہی پروڈکشن انٹرفیس کے ذریعے جوڑیں۔ یہاں معاہدہ، بلنگ یونٹس، ٹاسک اسٹیٹس اور حدود کا جائزہ لیں؛ ہر فیلڈ اور رسپانس کے لیے مکمل انگریزی API حوالہ کھولیں۔

DeepSwapAI Product Team2026-08-27API دستاویزات

HTTPS، multipart اپ لوڈز اور JSON ٹاسک اسٹیٹس

ہر شائع شدہ جنریشن روٹ Bearer API کلید استعمال کرتا ہے، ایک taskId واپس کرتا ہے، اور اسی روٹ پر GET کے ذریعے ٹاسک کی اسٹیٹس فراہم کرتا ہے۔

تصدیقBearer API کلیدکلید صرف بناتے وقت دکھائی جاتی ہے؛ سرور صرف اس کا SHA-256 ہیش محفوظ کرتا ہے۔
تکمیلtaskId کے ذریعے پول کریںحتمی اسٹیٹس COMPLETED، FAILED یا CANCELLED ہیں۔
بلنگیک وقتی اکاؤنٹ کریڈٹسGET کے ذریعے پولنگ سے جنریشن کا کوئی اضافی چارج نہیں لگتا۔
ڈیولپر وسائلOpenAPI 3.1 + Postmanفی الحال کوئی آفیشل لینگویج SDK یا webhook کال بیک شائع نہیں کیا گیا۔

ایک API اکاؤنٹ فیس سوئپ کی پانچ ان پٹ اقسام کا احاطہ کرتا ہے

فوٹوز، فوٹو بیچز، گروپ فوٹوز میں میپ شدہ چہرے، ویڈیوز اور GIF ایک ہی پروڈکشن ڈومین اور ٹاسک لائف سائیکل استعمال کرتے ہیں۔ ہر درخواست سے پہلے فارمیٹ، سائز، دورانیہ، ہدف کی تعداد اور دستیاب کریڈٹس کی توثیق کریں؛ جمع کرانے کے بعد taskId محفوظ کریں اور متعلقہ GET روٹ کو پول کریں۔

روٹس، بلنگ یونٹس اور بنیادی حدود

ورک فلوPOST روٹموجودہ یونٹبنیادی حد
فوٹوPOST /api/ai-tasks6 کریڈٹس / آؤٹ پٹایک سورس چہرہ اور ایک ٹارگٹ تصویر
فوٹو بیچPOST /api/ai-tasks/batch-face-swap6 کریڈٹس / آؤٹ پٹکل زیادہ سے زیادہ 20 اِن پُٹ تصاویر؛ مجموعی 95 MB
گروپ میپنگPOST /api/ai-tasks/multi-face-swap6 کریڈٹس / منتخب چہرہزیادہ سے زیادہ 10 میپ کیے گئے چہرے؛ مجموعی 95 MB
ویڈیوPOST /api/ai-tasks/video3 کریڈٹس / راؤنڈ اپ کیا گیا سیکنڈ؛ کم از کم 12MP4، MOV یا WebM؛ 600 سیکنڈ (ہر API درخواست 95 MB تک، عام 1080p فون ویڈیو میں تقریباً 1–1.5 منٹ)؛ مقررہ اعلیٰ ترین 1080p درجہ
GIFPOST /api/ai-tasks/gif3 کریڈٹس / راؤنڈ اپ کیا گیا سیکنڈ؛ کم از کم 12GIF، MP4 یا WebM؛ 30 سیکنڈ

جنریشن ٹاسک جمع کرانے سے پہلے درخواست کی توثیق کریں

  1. 1. API کلیدیں اپنے سرور پر رکھیں، کبھی بھی براؤزر، موبائل پیکیج، لاگ یا عوامی ریپوزٹری میں نہیں۔
  2. 2. منتخب ورک فلو کے لیے multipart فیلڈز، فائل کی اقسام، سائز، تعداد، دورانیہ اور کریڈٹس کی توثیق کریں۔
  3. 3. POST درخواست جمع کرائیں اور واپس ملنے والا taskId متوقع چارج کے ساتھ محفوظ کریں۔
  4. 4. اسی روٹ پر GET کو اس وقت تک پول کریں جب تک ٹاسک COMPLETED، FAILED یا CANCELLED تک نہ پہنچ جائے۔
  5. 5. نتائج صرف اسی اکاؤنٹ کو فراہم کریں جو ٹاسک کا مالک ہو، اور شائع شدہ ریٹینشن اصول کے مطابق میڈیا ہٹا دیں۔

عوامی معاہدے میں کوئی idempotency-key فیلڈ دستاویزی نہیں ہے۔ کالنگ سروس کو ڈپلیکیٹ جمع کرانے کو غیر فعال کرنا چاہیے، پہلے taskId کو برقرار رکھنا چاہیے، اور دوسرا POST جاری کرنے سے پہلے غیر یقینی نیٹ ورک جواب کو مصالحت کرنا چاہیے۔

taskId کو رکھیں اور ٹرمینل حالت پر رکیں

واقعہٹاسک ریکارڈکریڈٹ ایکشنکلائنٹ کی کارروائی
ٹاسک قبولtaskId اور متوقع لاگت برقرار رکھیںسیٹلمنٹ کو سرور کی ملکیت سمجھیںمقررہ پولنگ شروع کریں
ٹاسک مکملٹرمینل نتیجہمکمل کام طے شدہ رہتا ہےنتیجہ کی بازیافت کی اجازت دیں
پروسیسنگ ناکام ہو گئیٹرمینل ناکامیموجودہ معاہدہ ناکام پروسیسنگ کو خود بخود ریفنڈ کرتا ہےدوبارہ جمع کرانے سے پہلے ناکامی پڑھیں
جواب کا نتیجہ غیر یقینیدوسرے POST سے پہلے مصالحت کریںٹائم آؤٹ سے کبھی اندازہ نہ لگائیںذخیرہ شدہ taskId یا اکاؤنٹ کی تاریخ استعمال کریں

جواب کا نتیجہ غیر یقینی عوامی معاہدے میں کوئی idempotency-key فیلڈ دستاویزی نہیں ہے۔ کالنگ سروس کو ڈپلیکیٹ جمع کرانے کو غیر فعال کرنا چاہیے، پہلے taskId کو برقرار رکھنا چاہیے، اور دوسرا POST جاری کرنے سے پہلے غیر یقینی نیٹ ورک جواب کو مصالحت کرنا چاہیے۔

اپنی انٹیگریشن میں قابلِ تصدیق حدود شامل کریں

API تک رسائی کے لیے تصدیق شدہ ای میل اور PAID یا COMPLETED حالت والا کم از کم ایک کریڈٹ آرڈر ضروری ہے۔ ہر اکاؤنٹ زیادہ سے زیادہ 3 API کلیدیں بنا سکتا ہے، اور ہر کلید سے فی منٹ زیادہ سے زیادہ 6 جنریشن درخواستیں بھیجی جا سکتی ہیں۔ ناکام ٹاسک کے کریڈٹس موجودہ قواعد کے مطابق واپس کیے جاتے ہیں، اور میڈیا 24 گھنٹوں کے اندر حذف کر دیا جاتا ہے۔

مکمل انگریزی API حوالہ کھولیں: مکمل انگریزی API حوالہ کھولیں۔ پروڈکٹ سے متعلق مخصوص شرائط رازداری کی پالیسی اور قیمتیں میں درج ہیں۔

لانچ سے پہلے ان نکات کی تصدیق کریں

کیا API میں webhooks کی سپورٹ ہے؟

فی الحال نہیں۔ POST سے واپس ملنے والا taskId محفوظ رکھیں اور اسی ورک فلو روٹ پر GET کو حتمی اسٹیٹ تک پول کریں۔

کیا کوئی آفیشل SDK موجود ہے؟

فی الحال کوئی آفیشل لینگویج SDK شائع نہیں کیا گیا۔ معیاری HTTPS، Bearer تصدیق، multipart ڈیٹا اور JSON رسپانسز کسی بھی سرور سائیڈ HTTP کلائنٹ کے ساتھ کام کرتے ہیں۔

ایک فوٹو ٹاسک کتنے کریڈٹس استعمال کرتا ہے؟

ایک فوٹو، ایک بیچ آؤٹ پٹ، یا گروپ فوٹو میں ایک منتخب چہرہ فی الحال 6 کریڈٹس استعمال کرتا ہے۔ ویڈیو اور GIF میں سیکنڈز اوپر کی طرف راؤنڈ کیے جاتے ہیں اور کم از کم چارج لاگو ہوتا ہے۔

کیا میں API کلید فرنٹ اینڈ کوڈ میں رکھ سکتا ہوں؟

نہیں۔ API کلیدیں سرور پر محفوظ کریں اور انہیں کبھی بھی براؤزر بنڈلز، موبائل بائنریز، لاگز، اینالیٹکس ایونٹس یا سپورٹ ٹکٹس میں نہ لکھیں۔

ایک نمائندہ ٹاسک کے ساتھ انٹیگریشن کی توثیق کریں

بیچز یا طویل ویڈیوز تک توسیع دینے سے پہلے، سب سے چھوٹے مجاز میڈیا نمونے کے ساتھ فیلڈز، اسٹیٹس، چارجز اور نتائج کی فراہمی کی جانچ کریں۔

مکمل API دستاویزات کھولیں