প্রোডাকশন API রেফারেন্স
DeepSwapAI: AI ফেস সোয়াপ API
একটি প্রোডাকশন ইন্টারফেসের মাধ্যমে ফটো, ফটো ব্যাচ, ম্যাপ করা গ্রুপ-ফটো, ভিডিও এবং GIF ফেস সোয়াপ যুক্ত করুন। কন্ট্র্যাক্ট, বিলিং ইউনিট, টাস্ক স্টেট এবং সীমাগুলো এখানে দেখে নিন; প্রতিটি ফিল্ড ও রেসপন্সের জন্য সম্পূর্ণ ইংরেজি API রেফারেন্স খুলুন।
একটি কন্ট্র্যাক্ট, পাঁচটি ওয়ার্কফ্লো
HTTPS, multipart আপলোড এবং JSON টাস্ক স্টেট
প্রকাশিত প্রতিটি জেনারেশন রুট একটি Bearer API কী ব্যবহার করে, একটি taskId ফেরত দেয় এবং সেই একই রুটে GET-এর মাধ্যমে টাস্কের স্টেট জানায়।
সরাসরি উত্তর
একটি API অ্যাকাউন্টেই পাঁচ ধরনের ফেস সোয়াপ ইনপুট কভার হয়
ফটো, ফটো ব্যাচ, গ্রুপ ফটোতে ম্যাপ করা মুখ, ভিডিও এবং GIF একই প্রোডাকশন ডোমেইন ও টাস্ক লাইফসাইকেল ব্যবহার করে। প্রতিটি রিকোয়েস্টের আগে ফরম্যাট, সাইজ, সময়কাল, টার্গেটের সংখ্যা এবং উপলব্ধ ক্রেডিট যাচাই করুন; সাবমিট করার পর taskId সংরক্ষণ করুন এবং সংশ্লিষ্ট GET রুটে পোল করুন।
বর্তমান পাবলিক কন্ট্র্যাক্ট
রুট, বিলিং ইউনিট এবং প্রধান সীমা
| ওয়ার্কফ্লো | POST রুট | বর্তমান ইউনিট | প্রধান সীমা |
|---|---|---|---|
| ফটো | POST /api/ai-tasks | ৬ ক্রেডিট / আউটপুট | One source face and one target image |
| ফটো ব্যাচ | POST /api/ai-tasks/batch-face-swap | 6 ক্রেডিট / আউটপুট | সর্বোচ্চ মোট ২০টি ইনপুট ছবি; মোট ৯৫ 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. টাস্কটি COMPLETED, FAILED অথবা CANCELLED স্টেটে না পৌঁছানো পর্যন্ত একই রুটে GET পোল করুন।
- 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 কি ওয়েবহুক সাপোর্ট করে?
বর্তমানে না। POST থেকে ফেরত আসা taskId রাখুন এবং চূড়ান্ত স্টেটে না পৌঁছানো পর্যন্ত একই ওয়ার্কফ্লো রুটে GET পোল করুন।
কোনো অফিশিয়াল SDK আছে কি?
বর্তমানে কোনো অফিশিয়াল ল্যাঙ্গুয়েজ SDK প্রকাশিত নেই। স্ট্যান্ডার্ড HTTPS, Bearer অথেনটিকেশন, multipart ডেটা এবং JSON রেসপন্স যেকোনো সার্ভার-সাইড HTTP ক্লায়েন্টের সাথে কাজ করে।
একটি ফটো টাস্কে কত ক্রেডিট লাগে?
একটি ফটো, একটি ব্যাচ আউটপুট বা গ্রুপ ফটোর একটি নির্বাচিত মুখে বর্তমানে 6 ক্রেডিট লাগে। ভিডিও ও GIF-এর হিসাব হয় উপরের দিকে রাউন্ড করা সেকেন্ডে, সঙ্গে একটি ন্যূনতম চার্জ থাকে।
আমি কি ফ্রন্টএন্ড কোডে API কী রাখতে পারি?
না। API কী সার্ভারে সংরক্ষণ করুন এবং কখনো ব্রাউজার বান্ডেল, মোবাইল বাইনারি, লগ, অ্যানালিটিক্স ইভেন্ট বা সাপোর্ট টিকিটে লিখবেন না।
একটি প্রতিনিধিত্বমূলক টাস্ক দিয়ে ইন্টিগ্রেশন যাচাই করুন
ব্যাচ বা দীর্ঘ ভিডিওতে স্কেল করার আগে সবচেয়ে ছোট অনুমোদিত মিডিয়া স্যাম্পল দিয়ে ফিল্ড, স্টেট, চার্জ এবং ফলাফল ডেলিভারি পরীক্ষা করুন।