پروڈکشن API حوالہ
DeepSwapAI: AI فیس سویپ API
فوٹو، فوٹو بیچ، میپ شدہ گروپ فوٹو، ویڈیو اور GIF فیس سوئپ کو ایک ہی پروڈکشن انٹرفیس کے ذریعے جوڑیں۔ یہاں معاہدہ، بلنگ یونٹس، ٹاسک اسٹیٹس اور حدود کا جائزہ لیں؛ ہر فیلڈ اور رسپانس کے لیے مکمل انگریزی API حوالہ کھولیں۔
ایک معاہدہ، پانچ ورک فلوز
HTTPS، multipart اپ لوڈز اور JSON ٹاسک اسٹیٹس
ہر شائع شدہ جنریشن روٹ Bearer API کلید استعمال کرتا ہے، ایک taskId واپس کرتا ہے، اور اسی روٹ پر GET کے ذریعے ٹاسک کی اسٹیٹس فراہم کرتا ہے۔
براہِ راست جواب
ایک API اکاؤنٹ فیس سوئپ کی پانچ ان پٹ اقسام کا احاطہ کرتا ہے
فوٹوز، فوٹو بیچز، گروپ فوٹوز میں میپ شدہ چہرے، ویڈیوز اور GIF ایک ہی پروڈکشن ڈومین اور ٹاسک لائف سائیکل استعمال کرتے ہیں۔ ہر درخواست سے پہلے فارمیٹ، سائز، دورانیہ، ہدف کی تعداد اور دستیاب کریڈٹس کی توثیق کریں؛ جمع کرانے کے بعد taskId محفوظ کریں اور متعلقہ GET روٹ کو پول کریں۔
موجودہ عوامی معاہدہ
روٹس، بلنگ یونٹس اور بنیادی حدود
| ورک فلو | POST روٹ | موجودہ یونٹ | بنیادی حد |
|---|---|---|---|
| فوٹو | POST /api/ai-tasks | 6 کریڈٹس / آؤٹ پٹ | One source face and one target image |
| فوٹو بیچ | POST /api/ai-tasks/batch-face-swap | 6 کریڈٹس / آؤٹ پٹ | کل زیادہ سے زیادہ 20 اِن پُٹ تصاویر؛ مجموعی 95 MB |
| گروپ میپنگ | POST /api/ai-tasks/multi-face-swap | 6 credits / selected face | Up to 10 mapped faces; 95 MB combined |
| ویڈیو | POST /api/ai-tasks/video | 3 credits / rounded second; 12 minimum | MP4, MOV, or WebM; 600 seconds; fixed highest 1080p tier |
| GIF | POST /api/ai-tasks/gif | 3 credits / rounded second; 12 minimum | GIF, MP4, or WebM; 30 seconds |
کم از کم انٹیگریشن فلو
جنریشن ٹاسک جمع کرانے سے پہلے درخواست کی توثیق کریں
- 1. API کلیدیں اپنے سرور پر رکھیں، کبھی بھی براؤزر، موبائل پیکیج، لاگ یا عوامی ریپوزٹری میں نہیں۔
- 2. منتخب ورک فلو کے لیے multipart فیلڈز، فائل کی اقسام، سائز، تعداد، دورانیہ اور کریڈٹس کی توثیق کریں۔
- 3. POST درخواست جمع کرائیں اور واپس ملنے والا taskId متوقع چارج کے ساتھ محفوظ کریں۔
- 4. اسی روٹ پر GET کو اس وقت تک پول کریں جب تک ٹاسک COMPLETED، FAILED یا CANCELLED تک نہ پہنچ جائے۔
- 5. نتائج صرف اسی اکاؤنٹ کو فراہم کریں جو ٹاسک کا مالک ہو، اور شائع شدہ ریٹینشن اصول کے مطابق میڈیا ہٹا دیں۔
عوامی معاہدے میں کوئی idempotency-key فیلڈ دستاویزی نہیں ہے۔ کالنگ سروس کو ڈپلیکیٹ جمع کرانے کو غیر فعال کرنا چاہیے، پہلے taskId کو برقرار رکھنا چاہیے، اور دوسرا POST جاری کرنے سے پہلے غیر یقینی نیٹ ورک جواب کو مصالحت کرنا چاہیے۔
ٹاسک لائف سائیکل
taskId کو رکھیں اور ٹرمینل حالت پر رکیں
| واقعہ | ٹاسک ریکارڈ | کریڈٹ ایکشن | کلائنٹ کی کارروائی |
|---|---|---|---|
| ٹاسک قبول | taskId اور متوقع لاگت برقرار رکھیں | سیٹلمنٹ کو سرور کی ملکیت سمجھیں | مقررہ پولنگ شروع کریں |
| ٹاسک مکمل | ٹرمینل نتیجہ | مکمل کام طے شدہ رہتا ہے | نتیجہ کی بازیافت کی اجازت دیں |
| پروسیسنگ ناکام ہو گئی | ٹرمینل ناکامی | موجودہ معاہدہ ناکام پروسیسنگ کو خود بخود ریفنڈ کرتا ہے | دوبارہ جمع کرانے سے پہلے ناکامی پڑھیں |
| جواب کا نتیجہ غیر یقینی | دوسرے POST سے پہلے مصالحت کریں | ٹائم آؤٹ سے کبھی اندازہ نہ لگائیں | ذخیرہ شدہ taskId یا اکاؤنٹ کی تاریخ استعمال کریں |
جواب کا نتیجہ غیر یقینی عوامی معاہدے میں کوئی idempotency-key فیلڈ دستاویزی نہیں ہے۔ کالنگ سروس کو ڈپلیکیٹ جمع کرانے کو غیر فعال کرنا چاہیے، پہلے taskId کو برقرار رکھنا چاہیے، اور دوسرا POST جاری کرنے سے پہلے غیر یقینی نیٹ ورک جواب کو مصالحت کرنا چاہیے۔
بلنگ، رازداری اور ایکسپورٹ
اپنی انٹیگریشن میں قابلِ تصدیق حدود شامل کریں
API access requires a verified email and at least one PAID or COMPLETED credit order. Reward and trial credits are limited to the signed-in web workflow and cannot be automated through the API. Each account can create up to 3 API keys, with up to 6 generation requests per minute per key. Failed tasks are refunded under the current rules, and media is deleted within 24 hours.
ڈیولپر سوالات
لانچ سے پہلے ان نکات کی تصدیق کریں
کیا API میں webhooks کی سپورٹ ہے؟
فی الحال نہیں۔ POST سے واپس ملنے والا taskId محفوظ رکھیں اور اسی ورک فلو روٹ پر GET کو حتمی اسٹیٹ تک پول کریں۔
کیا کوئی آفیشل SDK موجود ہے؟
فی الحال کوئی آفیشل لینگویج SDK شائع نہیں کیا گیا۔ معیاری HTTPS، Bearer تصدیق، multipart ڈیٹا اور JSON رسپانسز کسی بھی سرور سائیڈ HTTP کلائنٹ کے ساتھ کام کرتے ہیں۔
ایک فوٹو ٹاسک کتنے کریڈٹس استعمال کرتا ہے؟
ایک فوٹو، ایک بیچ آؤٹ پٹ، یا گروپ فوٹو میں ایک منتخب چہرہ فی الحال 6 کریڈٹس استعمال کرتا ہے۔ ویڈیو اور GIF میں سیکنڈز اوپر کی طرف راؤنڈ کیے جاتے ہیں اور کم از کم چارج لاگو ہوتا ہے۔
کیا میں API کلید فرنٹ اینڈ کوڈ میں رکھ سکتا ہوں؟
نہیں۔ API کلیدیں سرور پر محفوظ کریں اور انہیں کبھی بھی براؤزر بنڈلز، موبائل بائنریز، لاگز، اینالیٹکس ایونٹس یا سپورٹ ٹکٹس میں نہ لکھیں۔
ایک نمائندہ ٹاسک کے ساتھ انٹیگریشن کی توثیق کریں
بیچز یا طویل ویڈیوز تک توسیع دینے سے پہلے، سب سے چھوٹے مجاز میڈیا نمونے کے ساتھ فیلڈز، اسٹیٹس، چارجز اور نتائج کی فراہمی کی جانچ کریں۔