প্রোডাকশন 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 বা ওয়েবহুক কলব্যাক প্রকাশিত নেই।

একটি API অ্যাকাউন্টেই পাঁচ ধরনের ফেস সোয়াপ ইনপুট কভার হয়

ফটো, ফটো ব্যাচ, গ্রুপ ফটোতে ম্যাপ করা মুখ, ভিডিও এবং GIF একই প্রোডাকশন ডোমেইন ও টাস্ক লাইফসাইকেল ব্যবহার করে। প্রতিটি রিকোয়েস্টের আগে ফরম্যাট, সাইজ, সময়কাল, টার্গেটের সংখ্যা এবং উপলব্ধ ক্রেডিট যাচাই করুন; সাবমিট করার পর taskId সংরক্ষণ করুন এবং সংশ্লিষ্ট GET রুটে পোল করুন।

রুট, বিলিং ইউনিট এবং প্রধান সীমা

ওয়ার্কফ্লোPOST রুটবর্তমান ইউনিটপ্রধান সীমা
ফটোPOST /api/ai-tasks৬ ক্রেডিট / আউটপুটএকটি সোর্স মুখ এবং একটি টার্গেট ছবি
ফটো ব্যাচPOST /api/ai-tasks/batch-face-swap6 ক্রেডিট / আউটপুটসর্বোচ্চ মোট ২০টি ইনপুট ছবি; মোট ৯৫ 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 স্তর
GIFPOST /api/ai-tasks/gif৩ ক্রেডিট / রাউন্ড করা সেকেন্ড; সর্বনিম্ন ১২GIF, MP4 বা WebM; ৩০ সেকেন্ড

জেনারেশন টাস্ক সাবমিট করার আগে রিকোয়েস্ট যাচাই করুন

  1. 1. API কী আপনার সার্ভারে রাখুন; কখনো ব্রাউজার, মোবাইল প্যাকেজ, লগ বা পাবলিক রিপোজিটরিতে নয়।
  2. 2. নির্বাচিত ওয়ার্কফ্লোর জন্য multipart ফিল্ড, ফাইল টাইপ, সাইজ, সংখ্যা, সময়কাল এবং ক্রেডিট যাচাই করুন।
  3. 3. POST রিকোয়েস্ট সাবমিট করুন এবং ফেরত আসা taskId প্রত্যাশিত চার্জসহ সংরক্ষণ করুন।
  4. 4. টাস্কটি COMPLETED, FAILED অথবা CANCELLED স্টেটে না পৌঁছানো পর্যন্ত একই রুটে GET পোল করুন।
  5. 5. ফলাফল শুধু সেই অ্যাকাউন্টকেই দিন যার মালিকানায় টাস্কটি রয়েছে, এবং প্রকাশিত রিটেনশন নিয়ম অনুযায়ী মিডিয়া মুছে ফেলুন।

পাবলিক কন্ট্রাক্টে কোনো idempotency-key ফিল্ড নথিভুক্ত নেই। কলিং সার্ভিসের ডুপ্লিকেট সাবমিশন নিষ্ক্রিয় করা উচিত, প্রথম taskId সংরক্ষণ করা উচিত এবং আরেকটি POST ইস্যু করার আগে একটি অনিশ্চিত নেটওয়ার্ক প্রতিক্রিয়া সমন্বয় করা উচিত।

taskId রাখুন এবং একটি টার্মিনাল অবস্থায় থামুন

ইভেন্টটাস্ক রেকর্ডক্রেডিট অ্যাকশনক্লায়েন্ট পদক্ষেপ
টাস্ক গৃহীতtaskId এবং প্রত্যাশিত খরচ সংরক্ষণ করুনসেটেলমেন্টকে সার্ভার-মালিকানাধীন বিবেচনা করুনপরিমাপিত পোলিং শুরু করুন
টাস্ক সম্পন্নটার্মিনাল ফলাফলসম্পন্ন কাজ সেটেল থাকেফলাফল পুনরুদ্ধার অনুমোদন করুন
প্রক্রিয়াকরণ ব্যর্থ হয়েছেটার্মিনাল ব্যর্থতাবর্তমান কন্ট্রাক্ট ব্যর্থ প্রক্রিয়াকরণ স্বয়ংক্রিয়ভাবে রিফান্ড করেপুনরায় জমা দেওয়ার সিদ্ধান্ত নেওয়ার আগে ব্যর্থতা পড়ুন
প্রতিক্রিয়া ফলাফল অনিশ্চিতআরেকটি POST-এর আগে সমন্বয় করুনকখনও টাইমআউট থেকে অনুমান করবেন নাসংরক্ষিত taskId বা অ্যাকাউন্ট ইতিহাস ব্যবহার করুন

প্রতিক্রিয়া ফলাফল অনিশ্চিত পাবলিক কন্ট্রাক্টে কোনো idempotency-key ফিল্ড নথিভুক্ত নেই। কলিং সার্ভিসের ডুপ্লিকেট সাবমিশন নিষ্ক্রিয় করা উচিত, প্রথম taskId সংরক্ষণ করা উচিত এবং আরেকটি POST ইস্যু করার আগে একটি অনিশ্চিত নেটওয়ার্ক প্রতিক্রিয়া সমন্বয় করা উচিত।

আপনার ইন্টিগ্রেশনে যাচাইযোগ্য সীমা তৈরি করুন

API ব্যবহারের জন্য যাচাই করা ইমেল এবং PAID বা COMPLETED অবস্থার অন্তত একটি ক্রেডিট অর্ডার প্রয়োজন। প্রতিটি অ্যাকাউন্ট সর্বোচ্চ ৩টি API কী তৈরি করতে পারে, এবং প্রতিটি কী দিয়ে প্রতি মিনিটে সর্বোচ্চ ৬টি জেনারেশন অনুরোধ পাঠানো যায়। ব্যর্থ টাস্কের ক্রেডিট বর্তমান নিয়ম অনুযায়ী ফেরত দেওয়া হয়, এবং মিডিয়া ২৪ ঘণ্টার মধ্যে মুছে ফেলা হয়।

সম্পূর্ণ ইংরেজি API রেফারেন্স খুলুন: সম্পূর্ণ ইংরেজি API রেফারেন্স খুলুন। পণ্যের নির্দিষ্ট শর্তগুলো গোপনীয়তা নীতি এবং মূল্য পাতায় দেওয়া আছে।

লঞ্চের আগে এই বিষয়গুলো নিশ্চিত করুন

API কি ওয়েবহুক সাপোর্ট করে?

বর্তমানে না। POST থেকে ফেরত আসা taskId রাখুন এবং চূড়ান্ত স্টেটে না পৌঁছানো পর্যন্ত একই ওয়ার্কফ্লো রুটে GET পোল করুন।

কোনো অফিশিয়াল SDK আছে কি?

বর্তমানে কোনো অফিশিয়াল ল্যাঙ্গুয়েজ SDK প্রকাশিত নেই। স্ট্যান্ডার্ড HTTPS, Bearer অথেনটিকেশন, multipart ডেটা এবং JSON রেসপন্স যেকোনো সার্ভার-সাইড HTTP ক্লায়েন্টের সাথে কাজ করে।

একটি ফটো টাস্কে কত ক্রেডিট লাগে?

একটি ফটো, একটি ব্যাচ আউটপুট বা গ্রুপ ফটোর একটি নির্বাচিত মুখে বর্তমানে 6 ক্রেডিট লাগে। ভিডিও ও GIF-এর হিসাব হয় উপরের দিকে রাউন্ড করা সেকেন্ডে, সঙ্গে একটি ন্যূনতম চার্জ থাকে।

আমি কি ফ্রন্টএন্ড কোডে API কী রাখতে পারি?

না। API কী সার্ভারে সংরক্ষণ করুন এবং কখনো ব্রাউজার বান্ডেল, মোবাইল বাইনারি, লগ, অ্যানালিটিক্স ইভেন্ট বা সাপোর্ট টিকিটে লিখবেন না।

একটি প্রতিনিধিত্বমূলক টাস্ক দিয়ে ইন্টিগ্রেশন যাচাই করুন

ব্যাচ বা দীর্ঘ ভিডিওতে স্কেল করার আগে সবচেয়ে ছোট অনুমোদিত মিডিয়া স্যাম্পল দিয়ে ফিল্ড, স্টেট, চার্জ এবং ফলাফল ডেলিভারি পরীক্ষা করুন।

সম্পূর্ণ API ডকুমেন্টেশন খুলুন