প্রোডাকশন API রেফারেন্স
DeepSwapAI: AI ফেস সোয়াপ API
একটি প্রোডাকশন ইন্টারফেসের মাধ্যমে ফটো, ফটো ব্যাচ, ম্যাপ করা গ্রুপ-ফটো, ভিডিও এবং GIF ফেস সোয়াপ যুক্ত করুন। কন্ট্র্যাক্ট, বিলিং ইউনিট, টাস্ক স্টেট এবং সীমাগুলো এখানে দেখে নিন; প্রতিটি ফিল্ড ও রেসপন্সের জন্য সম্পূর্ণ ইংরেজি API রেফারেন্স খুলুন।
একটি কন্ট্র্যাক্ট, পাঁচটি ওয়ার্কফ্লো
HTTPS, multipart আপলোড এবং JSON টাস্ক স্টেট
প্রকাশিত প্রতিটি জেনারেশন রুট একটি Bearer API কী ব্যবহার করে, একটি taskId ফেরত দেয় এবং সেই একই রুটে GET-এর মাধ্যমে টাস্কের স্টেট জানায়।
সরাসরি উত্তর
একটি API অ্যাকাউন্টেই পাঁচ ধরনের ফেস সোয়াপ ইনপুট কভার হয়
ফটো, ফটো ব্যাচ, গ্রুপ ফটোতে ম্যাপ করা মুখ, ভিডিও এবং GIF একই প্রোডাকশন ডোমেইন ও টাস্ক লাইফসাইকেল ব্যবহার করে। প্রতিটি রিকোয়েস্টের আগে ফরম্যাট, সাইজ, সময়কাল, টার্গেটের সংখ্যা এবং উপলব্ধ ক্রেডিট যাচাই করুন; সাবমিট করার পর taskId সংরক্ষণ করুন এবং সংশ্লিষ্ট GET রুটে পোল করুন।
বর্তমান পাবলিক কন্ট্র্যাক্ট
রুট, বিলিং ইউনিট এবং প্রধান সীমা
| ওয়ার্কফ্লো | POST রুট | বর্তমান ইউনিট | প্রধান সীমা |
|---|---|---|---|
| ফটো | POST /api/ai-tasks | ৬ ক্রেডিট / আউটপুট | একটি সোর্স মুখ এবং একটি টার্গেট ছবি |
| ফটো ব্যাচ | POST /api/ai-tasks/batch-face-swap | 6 ক্রেডিট / আউটপুট | সর্বোচ্চ মোট ২০টি ইনপুট ছবি; মোট ৯৫ MB |
| গ্রুপ ম্যাপিং | POST /api/ai-tasks/multi-face-swap | ৬ ক্রেডিট / নির্বাচিত মুখ | সর্বোচ্চ ১০টি ম্যাপ করা মুখ; মোট ৯৫ MB |
| ভিডিও | POST /api/ai-tasks/video | ৩ ক্রেডিট / রাউন্ড করা সেকেন্ড; সর্বনিম্ন ১২ | MP4, MOV বা WebM; ৬০০ সেকেন্ড (প্রতি API অনুরোধে 95 MB, সাধারণ 1080p ফোন ভিডিওতে প্রায় 1–1.5 মিনিট); নির্ধারিত সর্বোচ্চ 1080p স্তর |
| GIF | POST /api/ai-tasks/gif | ৩ ক্রেডিট / রাউন্ড করা সেকেন্ড; সর্বনিম্ন ১২ | GIF, MP4 বা WebM; ৩০ সেকেন্ড |
ন্যূনতম ইন্টিগ্রেশন ফ্লো
জেনারেশন টাস্ক সাবমিট করার আগে রিকোয়েস্ট যাচাই করুন
- 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 ব্যবহারের জন্য যাচাই করা ইমেল এবং PAID বা COMPLETED অবস্থার অন্তত একটি ক্রেডিট অর্ডার প্রয়োজন। প্রতিটি অ্যাকাউন্ট সর্বোচ্চ ৩টি API কী তৈরি করতে পারে, এবং প্রতিটি কী দিয়ে প্রতি মিনিটে সর্বোচ্চ ৬টি জেনারেশন অনুরোধ পাঠানো যায়। ব্যর্থ টাস্কের ক্রেডিট বর্তমান নিয়ম অনুযায়ী ফেরত দেওয়া হয়, এবং মিডিয়া ২৪ ঘণ্টার মধ্যে মুছে ফেলা হয়।
ডেভেলপারদের প্রশ্ন
লঞ্চের আগে এই বিষয়গুলো নিশ্চিত করুন
API কি ওয়েবহুক সাপোর্ট করে?
বর্তমানে না। POST থেকে ফেরত আসা taskId রাখুন এবং চূড়ান্ত স্টেটে না পৌঁছানো পর্যন্ত একই ওয়ার্কফ্লো রুটে GET পোল করুন।
কোনো অফিশিয়াল SDK আছে কি?
বর্তমানে কোনো অফিশিয়াল ল্যাঙ্গুয়েজ SDK প্রকাশিত নেই। স্ট্যান্ডার্ড HTTPS, Bearer অথেনটিকেশন, multipart ডেটা এবং JSON রেসপন্স যেকোনো সার্ভার-সাইড HTTP ক্লায়েন্টের সাথে কাজ করে।
একটি ফটো টাস্কে কত ক্রেডিট লাগে?
একটি ফটো, একটি ব্যাচ আউটপুট বা গ্রুপ ফটোর একটি নির্বাচিত মুখে বর্তমানে 6 ক্রেডিট লাগে। ভিডিও ও GIF-এর হিসাব হয় উপরের দিকে রাউন্ড করা সেকেন্ডে, সঙ্গে একটি ন্যূনতম চার্জ থাকে।
আমি কি ফ্রন্টএন্ড কোডে API কী রাখতে পারি?
না। API কী সার্ভারে সংরক্ষণ করুন এবং কখনো ব্রাউজার বান্ডেল, মোবাইল বাইনারি, লগ, অ্যানালিটিক্স ইভেন্ট বা সাপোর্ট টিকিটে লিখবেন না।
একটি প্রতিনিধিত্বমূলক টাস্ক দিয়ে ইন্টিগ্রেশন যাচাই করুন
ব্যাচ বা দীর্ঘ ভিডিওতে স্কেল করার আগে সবচেয়ে ছোট অনুমোদিত মিডিয়া স্যাম্পল দিয়ে ফিল্ড, স্টেট, চার্জ এবং ফলাফল ডেলিভারি পরীক্ষা করুন।
