ثبوت کی حد
ایک عوامی معاہدہ حوالہ، نجی انفراسٹرکچر ڈایاگرام نہیں
اسے استعمال کریں تاکہ یہ فیصلہ کیا جا سکے کہ آپ کے اپنے انٹیگریشن میں ملکیت، تصدیق، کام کی حالت، دوبارہ کوشش، تصفیہ، ترسیل، حذف کرنا، اور ثبوت کہاں رہنا چاہیے۔ عین ملٹی پارٹ فیلڈز اور جوابات کے لیے، API دستاویزات اور OpenAPI 3.1 معاہدہاستعمال کریں۔ چہرے کی لوکلائزیشن، شناخت کی منتقلی، ترکیب، ملاوٹ، اور ویڈیو مستقل مزاجی کے اندر تحقیق کے تصورات کے لیے، AI چہرے کی تبدیلی کیسے کام کرتا ہے.
پڑھیں۔ تصدیق شدہ عوامی معاہدہ
پانچ غیر متوازی ورک فلو ایک کنٹرول شکل کا اشتراک کرتے ہیں
ہر موجودہ نسل کا ورک فلو ایک Bearer API کلید کے ساتھ تصدیق کرتا ہے، ملٹی پارٹ میڈیا قبول کرتا ہے، ایک taskIdلوٹاتا ہے، اور اسی راستے پر GET کے ذریعے مالک کے دائرے کی حیثیت کو ظاہر کرتا ہے۔ تکمیل پولنگ کا استعمال کرتی ہے؛ ویب ہک کال بیکس اور سرکاری زبان SDKs فی الحال شائع نہیں ہیں۔
| ورک فلو | POST اور پولنگ GET | لاگت یونٹ | بنیادی پابندی |
|---|---|---|---|
| تصویر | /api/ai-tasks | 6 کریڈٹس فی کام | 30 MB فی تصویر |
| بیچ فوٹو | /api/ai-tasks/batch-face-swap | 6 کریڈٹس فی آؤٹ پٹ | 20 تصاویر، 95 MB مشترکہ |
| میپڈ گروپ تصویر | /api/ai-tasks/multi-face-swap | 6 کریڈٹس فی تبدیل شدہ چہرہ | 10 نقش شدہ چہرے، 95 MB مشترکہ |
| ویڈیو | /api/ai-tasks/video | صرف چہرہ منظر کے تحفظ کے ساتھ: 3/s، کم از کم 12 1080p پر | 600 سیکنڈ، 95 MB مشترکہ اپ لوڈ |
| GIF / مختصر کلپ | /api/ai-tasks/gif | 3 کریڈٹ فی سیکنڈ، کم از کم 12 | 30 سیکنڈ، 95 MB ہدف |
درست فارمیٹس، کم از کم چارجز اور درخواست کے فیلڈز کے لیے لائیو ورک اسپیس اور API دستاویزات ہی معتبر ہیں۔ اکاؤنٹ اور API ٹاسکس کے لیے تصدیق شدہ ای میل درکار ہے، ہر اکاؤنٹ میں ایک وقت میں ایک جنریشن فعال ہو سکتی ہے، اور حدیں ختم ہونے پر دوبارہ کوشش کی معلومات کے ساتھ HTTP 429 واپس آ سکتا ہے۔
حوالہ آرکیٹیکچر
ہر ناقابل واپسی فیصلے کو ایک مالک دیں
انگریس اور شناخت
TLS ختم کریں، سرور کے پاس موجود کلید کی تصدیق کریں، ایک درخواست ارتباطی ID تفویض کریں، اور ہر کام کو ایک اکاؤنٹ سے باندھیں۔
پالیسی اور توثیق
اجازت کی حالت، ورک فلو فیلڈز، شناخت شدہ میڈیا کی قسم، بائٹ سائز، تعداد، دورانیہ، نقشہ سازی، اکاؤنٹ کی تیاری، اور کریڈٹ کی دستیابی چیک کریں۔
ٹاسک لیجر
کنٹرول واپس کرنے سے پہلے taskId، مالک، ورک فلو، متوقع چارج، حالت کی منتقلی، ٹائم اسٹیمپس، اور تصفیہ کے نتائج کو محفوظ کریں۔
محدود پروسیسنگ
درخواست کی قبولیت کو نسل سے الگ کریں، فعال کام کو محدود کریں، اور دوبارہ قابل کوشش نقل و حمل کی ناکامیوں کو غلط ان پٹ سے ممتاز کریں۔
تصفیہ
ریزرو، تکمیل، اور ناکام کام کی واپسی کے فیصلوں کے لیے ایک جوہری اتھارٹی استعمال کریں تاکہ دوبارہ کوشش دو بار چارج یا واپسی نہ کر سکے۔
ترسیل اور حذف کرنا
ٹاسک مالک کے ذریعے نتیجہ تک رسائی کو اختیار دیں، تصویر برآمد کرنے کی اہلیت کا اطلاق کریں، اور دستاویزی 24 گھنٹے کے شیڈول پر میڈیا کو حذف کریں۔
آٹھ مرحلے کی درخواست کی ترتیب
درخواست کے معاہدے سے ثبوت پر مبنی حذف کرنے تک
- عوامی درخواست کے معاہدے کو منجمد کریں۔ عین ورک فلو اور ریکارڈ فیلڈز، میڈیا کی حدود، لاگت یونٹ، اور ٹرمینل اسٹیٹس کا انتخاب کریں۔
- اجازت، رضامندی، اور اکاؤنٹ کی تیاری کو روکیں۔ API کلید کو سرور سائیڈ رکھیں اور میڈیا قبول کرنے سے پہلے اجازت کے فیصلے کی ضرورت ہو۔
- قطار میں لگانے سے پہلے میڈیا کی توثیق کریں اور لاگت کا حساب لگائیں۔ مہنگے کام سے پہلے شناخت شدہ قسم، سائز، تعداد، دورانیہ، نقشہ سازی، اور دستیاب کریڈٹس کا معائنہ کریں۔
- ایک پائیدار ٹاسک آئی ڈی بنائیں۔ ملکیت، ورک فلو، متوقع چارج، ان پٹ ریفرنسز، حالت، اور taskId کو برقرار رکھیں۔
- محدود قطار کے پیچھے غیر متوازی طور پر عمل کریں۔ متصاعدہ کارروائی کو محدود کریں اور عارضی بمقابلہ مستقل ناکامیوں کی درجہ بندی کریں۔
- کریڈٹ کو صرف ایک بار طے کریں۔ مکمل کام کو کمٹ کریں اور دستاویزی ناکام پروسیسنگ ریفنڈ راستے کو بغیر ڈبل سیٹلمنٹ کے لاگو کریں۔
- مالک کے دائرے میں حالت اور نتیجہ تک رسائی فراہم کریں۔ مقررہ وقفے پر پول کریں اور COMPLETED، FAILED، یا CANCELLED پر رک جائیں۔
- حذف کرنے کو نافذ کریں اور آپریشنل ثبوت برقرار رکھیں۔ میڈیا کو شیڈول کے مطابق ہٹائیں جبکہ صرف کم سے کم اجازت یافتہ ٹاسک، بلنگ، سیکیورٹی، اور سپورٹ ریکارڈ برقرار رکھیں۔
حالت اور تصفیہ
پروسیسنگ کی حالت کو رقم کی حالت سے الگ رکھیں
| واقعہ | ٹاسک ریکارڈ | کریڈٹ ایکشن | کلائنٹ کی کارروائی |
|---|---|---|---|
| ٹاسک بنانے سے پہلے درخواست مسترد | کوئی قبول شدہ ٹاسک نہیں | چارج کا اندازہ نہ لگائیں | درخواست یا اکاؤنٹ کی حالت درست کریں |
| ٹاسک قبول | taskId اور متوقع لاگت برقرار رکھیں | سیٹلمنٹ کو سرور کی ملکیت سمجھیں | مقررہ پولنگ شروع کریں |
| ٹاسک مکمل | ٹرمینل نتیجہ | مکمل کام طے شدہ رہتا ہے | نتیجہ کی بازیافت کی اجازت دیں |
| پروسیسنگ ناکام ہو گئی | ٹرمینل ناکامی | موجودہ معاہدہ ناکام پروسیسنگ کو خود بخود ریفنڈ کرتا ہے | دوبارہ جمع کرانے سے پہلے ناکامی پڑھیں |
| جواب کا نتیجہ غیر یقینی | دوسرے POST سے پہلے مصالحت کریں | ٹائم آؤٹ سے کبھی اندازہ نہ لگائیں | ذخیرہ شدہ taskId یا اکاؤنٹ کی تاریخ استعمال کریں |
عوامی معاہدے میں کوئی idempotency-key فیلڈ دستاویزی نہیں ہے۔ کالنگ سروس کو ڈپلیکیٹ جمع کرانے کو غیر فعال کرنا چاہیے، پہلے taskId کو برقرار رکھنا چاہیے، اور دوسرا POST جاری کرنے سے پہلے غیر یقینی نیٹ ورک جواب کو مصالحت کرنا چاہیے۔
ناکامی کی پالیسی
صرف اس وقت دوبارہ کوشش کریں جب ناکامی کا طبقہ اس کی اجازت دے
| حیثیت | ناکامی کا طبقہ | آرکیٹیکچر کا جواب |
|---|---|---|
| 400 | غلط درخواست یا میڈیا | مستقل طور پر مسترد کریں جب تک کہ فیلڈز یا میڈیا تبدیل نہ ہوں۔ |
| 401 / 403 | کلید یا اکاؤنٹ کی تیاری | کلید کو گھمائیں یا تصدیق مکمل کریں؛ لوپ نہ کریں۔ |
| 402 | ناکافی کریڈٹس | صرف تصدیق کے بعد کریڈٹ شامل کریں اور نیا ٹاسک جمع کروائیں۔ |
| 404 | غلط مالک، راستہ، یا taskId | شناخت اور ذخیرہ شدہ ٹاسک میٹا ڈیٹا کو ہم آہنگ کریں۔ |
| 429 | شرح یا فعال جنریشن کی حد | جب فراہم کیا جائے تو Retry-After کا احترام کریں، جیٹر شامل کریں، اور دوبارہ کوششوں کو محدود کریں۔ |
| 500 | عارضی قبولیت یا پڑھنے میں ناکامی | محدود بیک آف کا استعمال کریں اور ڈپلیکیٹ جمع کروانے سے پہلے ہم آہنگ کریں۔ |
مشاہدہ پذیری اور سلامتی
لاگز میں حساس میڈیا کاپی کیے بغیر کنٹرول فیصلوں کو ٹریس کریں
تجویز کردہ ٹاسک ٹیلی میٹری میں ایک ارتباطی ID، taskId، اکاؤنٹ شناخت کنندہ، ورک فلو، صاف شدہ میڈیا حقائق، متوقع کریڈٹ رقم، حالت کی منتقلی، دوبارہ کوشش کی گنتی، غلطی کی کلاس، تصفیہ کا واقعہ، اور حذف کرنے کا ٹائم سٹیمپ شامل ہے۔ API کیز، چہرے کی تصاویر، مکمل اپ لوڈ کردہ فائل نام، دستخط شدہ نتیجہ URLs، یا ملٹی پارٹ باڈیز لاگ نہ کریں۔ W3C Trace Context سفارش انٹرآپریبل درخواست سیاق و سباق کی وضاحت کرتی ہے؛ یہ ایک ڈیزائن آپشن ہے، DeepSwapAI کے نجی نفاذ کے بارے میں دعویٰ نہیں۔
اپ لوڈ دفاع کے لیے، ڈی کوڈ شدہ فائل ناموں، پائے گئے مواد، اجازت یافتہ فارمیٹس، شمار، اور سائز کی توثیق کریں؛ براؤزر کے فراہم کردہ Content-Type پر اکیلے بھروسہ نہ کریں۔ OWASP File Upload Cheat Sheet بیرونی سیکیورٹی حوالہ ہے۔ استعمال کریں رضامندی اور انکشاف کا منصوبہ ساز انسانی اجازت کے دروازے کے لیے اور ٹرسٹ سینٹر موجودہ عوامی سروس کی حدود کے لیے۔
ملکیت کی کل لاگت
ایک ہی ماپا ورک لوڈ پر منظم، خود میزبان، اور ہائبرڈ کا موازنہ کریں
API چارج کا خام GPU کرایہ سے اکیلے موازنہ نہ کریں۔ پہلے ایک ورک لوڈ ونڈو طے کریں: ورک فلو مکس، میڈیا کی مدت اور ریزولوشن، چوٹی ہم آہنگی، دوبارہ کوشش کی شرح، برقرار رکھنے، جائزہ لینے کا حجم، اور مطلوبہ دستیابی۔ پھر ہر بار بار آنے والی اور ناکامی سے متعلق لاگت کو اسی ونڈو میں تفویض کریں۔
| Cost dimension | Managed API | Self-hosted | Hybrid | ثبوت جمع کرنے کے لیے |
|---|---|---|---|---|
| Processing capacity | شائع شدہ ٹاسک یا مدت کا چارج | GPU لیز یا خرید، بیکار ہیڈ روم، اسکیلنگ، اور ماڈل رن ٹائم | اندرونی بیس لائن کے علاوہ بیرونی اوور فلو یا ماہر پروسیسنگ | مکمل یونٹس، مدت، ریزولوشن، ہم آہنگی، اور استعمال |
| انجینئرنگ اور آپریشنز | انٹیگریشن، ٹاسک پرسسٹینس، پولنگ، جائزہ، اور وینڈر تبدیلی ہینڈلنگ | ماڈل سروِنگ، قطار، اپ گریڈ، صلاحیت کی منصوبہ بندی، تعیناتی، اور آن کال رسپانس | آرکیسٹریشن، فراہم کنندہ کا خلاصہ، اور اندرونی پلیٹ فارم کی ملکیت | ماپے گئے انجینئر گھنٹے، ریلیز کیڈینس، اور آن کال بوجھ |
| حفاظت اور گورننس | ایپلیکیشن رضامندی کا دروازہ، اکاؤنٹ پالیسی، جائزہ، اور ثبوت | تمام اعتدال، اسٹوریج، حذف کرنا، رسائی کنٹرول، اور آڈٹ کنٹرولز | ہر فیصلے کے لیے واضح مالک کے ساتھ مشترکہ کنٹرولز | جائزہ منٹ، اضافے کی شرح، برقرار رکھنے کا دائرہ، اور کنٹرول کے مالکان |
| ذخیرہ اور ترسیل | ایپلیکیشن سائیڈ ان پٹ، نتیجہ، اور نیٹ ورک ہینڈلنگ | ان پٹ، انٹرمیڈیٹ، نتیجہ، بیک اپ، ایگریس، اور حذف کرنے کے آپریشنز | اندرونی ریکارڈز کے علاوہ محدود فراہم کنندہ کی منتقلی | برقرار رکھے گئے بائٹس، منتقلی کا حجم، برقرار رکھنے کا وقت، اور حذف کرنے کا کام |
| ناکامی اور بھروسے کی قابلیت | دوبارہ کوشش، مفاہمت، فراہم کنندہ کی بندش ہینڈلنگ، اور سوئچنگ لاگت | فالتو پن، واقعے کا جواب، ناکام کام، بحالی، اور غیر استعمال شدہ صلاحیت | انحصار کی ناکامی اور اندرونی آرکیسٹریشن کی ناکامی دونوں | ناکامی کی شرح، بحالی کا وقت، نقل کام، اور سپورٹ کا بوجھ |
یہ فریم ورک کوئی خود میزبان قیمت کا معیار شائع نہیں کرتا اور یہ دعویٰ نہیں کرتا کہ منظم، خود میزبان، یا ہائبرڈ عالمی طور پر سستا ہے۔ فیصلہ ورک لوڈ اور ان کنٹرولز پر منحصر ہے جن کا اسی مدت کے لیے ثبوت دیا جا سکتا ہے۔
تعمیر کا فیصلہ
منظم، خود میزبان، یا ہائبرڈ کا انتخاب ان کنٹرولز کی بنیاد پر کریں جن کے آپ خود مالک ہونا چاہتے ہیں
| Model | You own | External dependency | Best fit |
|---|---|---|---|
| Managed API | رضامندی کا دروازہ، ایپلیکیشن UX، کام کی مستقل مزاجی، پولنگ، جائزہ، اور کاروباری پالیسی | شائع شدہ API، حدود، قیمتوں کا تعین، اور پروسیسنگ کا رویہ | وہ ٹیمیں جو انضمام کی رفتار کو انفراسٹرکچر کنٹرول پر ترجیح دیتی ہیں |
| Self-hosted | ماڈل، GPU صلاحیت، قطار، اعتدال، اسٹوریج، سیکیورٹی، تصفیہ، حذف کرنا، اور واقعے کا جواب | ماڈل اور انفراسٹرکچر سپلائی چین | وہ ٹیمیں جن کے پاس جائز کنٹرول یا تعیناتی کی ضرورت اور آپریشنز کی صلاحیت ہے |
| Hybrid | داخلی پالیسی، آرکیسٹریشن، آڈٹ ریکارڈ، جائزہ، اور فراہم کنندہ کا خلاصہ | ایک یا زیادہ باؤنڈڈ جنریشن سروسز | وہ ٹیمیں جنہیں ماڈل کے ہر جزو کو چلائے بغیر ایپلیکیشن سطح پر کنٹرول کی ضرورت ہے |
Sources and method
موجودہ مصنوعات کے حقائق کے علاوہ بنیادی بیرونی معیارات
DeepSwapAI پروڈکٹ ٹیم نے 22 جولائی 2026 کو پانچ عوامی راستوں، بیئرر تصدیق، ملٹی پارٹ درخواستوں، کام کی حالتیں، پولنگ کا بہاؤ، خرابی کے جوابات، ہم آہنگی کی حد، کریڈٹ تصفیہ، آزمائشی تصویر کا استحقاق، اور 24 گھنٹے میڈیا حذف کرنے کی جانچ کی۔ تجویز کردہ کنٹرولز اس بات سے آگاہ ہیں کہ OpenAPI تصریح 3.1.2, OWASP اپ لوڈ رہنمائی, NIST AI RMF 1.0، اور W3C Trace Context. دیکھیں claim verification methodology موجودہ مصنوعات کے بیانات کو عمومی ڈیزائن رہنمائی سے کیسے الگ کیا جاتا ہے۔
Architecture questions
جانئے کہ عوامی معاہدہ کیا ثابت کرتا ہے اور کیا نہیں
کیا یہ DeepSwapAI کا نجی پروڈکشن آرکیٹیکچر ہے؟
نہیں۔ یہ ایک عوامی معاہدہ ڈیزائن حوالہ ہے اور فراہم کنندہ کی ٹوپولوجی، قطار کی ٹیکنالوجی، ماڈل کی جگہ، کارکنوں کی تعداد، اندرونی نیٹ ورک، یا سروس لیول کے اہداف کو ظاہر نہیں کرتا۔
کلائنٹ کو کیسے پتہ چلے گا کہ کوئی کام ختم ہوا؟
POST کے ذریعے واپس کردہ taskId کو رکھیں اور اسی ورک فلو روٹ پر GET کو پول کریں جب تک COMPLETED، FAILED، یا CANCELLED نہ ہو جائے۔ ویب ہک کال بیکس فی الحال شائع نہیں ہیں۔
کیا API کلید کلائنٹ کوڈ میں رکھی جا سکتی ہے؟
نہیں۔ اسے سرور سائیڈ راز سمجھیں اور اسے براؤزر بنڈلز، موبائل بائنریز، ریپوزٹریز، تجزیات، لاگز، اور سپورٹ پیغامات سے دور رکھیں۔
کیا API ایک idempotency کلید شائع کرتا ہے؟
کوئی idempotency-key فیلڈ دستاویزی نہیں ہے۔ ڈپلیکیٹ جمع کرانے سے روکیں، پہلے taskId کو برقرار رکھیں، اور دوسرے POST سے پہلے غیر یقینی جوابات کو حل کریں۔
کیا یہ ڈیزائن تھرو پٹ یا معیار کی ضمانت دیتا ہے؟
نہیں۔ یہ کوئی بینچ مارک، SLA، درستگی کا اسکور، یا معیار کی ضمانت نہیں ہے۔