বিকাশকারী API · v1

ছবি, ভিডিও, GIF এবং গ্রুপ ফটোগুলির জন্য ফেস সোয়াপ API

স্থিতিশীল সংস্করণের রুটের মাধ্যমে FaceSwapAI ওয়েব স্টুডিওগুলির মতো একই উত্পাদন টাস্ক পাইপলাইন ব্যবহার করুন৷ প্রমাণীকরণ, আসল ক্রেডিট সূত্র, ফাইলের সীমা, টাস্ক স্টেট এবং ব্যর্থতার আচরণ চলমান হ্যান্ডলারদের থেকে নথিভুক্ত করা হয়।

লাইভ উৎপাদন চুক্তি · OpenAPI 3.1 · 30 আগস্ট, 2026 আপডেট করা হয়েছে

দ্রুত শুরু

আপনার যাচাইকৃত অ্যাকাউন্টে একটি কী তৈরি করুন, আপনার সার্ভার থেকে একটি মাল্টিপার্ট অনুরোধ পাঠান, তারপরে ফিরে আসা টাস্কআইডির সাথে মিলিত GET রুটে পোল করুন। ব্রাউজার এবং মোবাইল ক্লায়েন্ট বান্ডিলের বাইরে গোপন রাখুন।

  1. 1একবার একটি কী তৈরি করুন এবং অনুলিপি করুন
  2. 2সম্মতি সহ স্থানীয় মিডিয়া জমা দিন=সত্য
  3. 3স্ট্যাটাস PENDING বা PROCESSING থাকা পর্যন্ত পোল করুন
cURL
curl --request POST https://faceswapai.com/api/v1/face-swap/image \
  --header "Authorization: Bearer $FACESWAPAI_API_KEY" \
  --form "sourceImage=@./source.jpg" \
  --form "targetImage=@./target.jpg" \
  --form "consent=true"

এন্ডপয়েন্ট এবং সঠিক মূল্য

পদ্ধতিএন্ডপয়েন্টউদ্দেশ্যক্রেডিট সূত্র
POST/api/v1/face-swap/imageছবি ফেস সোয়াপ6
POST/api/v1/face-swap/videoভিডিও ফেস সোয়াপmax(9, 3 × ceil(serverMeasuredInputSeconds))
POST/api/v1/face-swap/gifGIF মুখ অদলবদলmax(9, 3 × ceil(serverMeasuredInputSeconds))
POST/api/v1/face-swap/multipleএকাধিক মুখের ছবি অদলবদল6 × selectedTargetFaces
GET/api/v1/tasksটাস্ক ইতিহাস0

কাজের ক্রেডিট উদাহরণ

একটি ছবির কাজ66 ক্রেডিট
চার সেকেন্ডের ভিডিওmax(9, 3 × ceil(4))12 ক্রেডিট
আট সেকেন্ডের GIFmax(9, 3 × ceil(8))24 ক্রেডিট
আঠারো সেকেন্ডের GIFmax(9, 3 × ceil(18))54 ক্রেডিট

এন্ডপয়েন্ট দ্বারা ক্ষেত্র অনুরোধ করুন

টার্গেট মিডিয়ার মাধ্যমে রুটটি বেছে নিন, তারপর নিচের সঠিক মাল্টিপার্ট ক্ষেত্রগুলি পাঠান। ঐচ্ছিক পুনরুদ্ধার নিয়ন্ত্রণ 0 থেকে 1 পর্যন্ত সংখ্যা গ্রহণ করে।

POST/api/v1/face-swap/image

ছবি ফেস সোয়াপ

একটি টার্গেট ফটোতে একটি উৎস পরিচয় প্রয়োগ করুন৷

আবশ্যক
sourceImagetargetImageconsent=true
ঐচ্ছিক
faceRestoreVisibilityrestoreVisibility
POST/api/v1/face-swap/video

ভিডিও ফেস সোয়াপ

আপলোড করা টার্গেট ভিডিও জুড়ে একটি উৎস পরিচয় প্রয়োগ করুন।

আবশ্যক
sourceImagetargetVideoconsent=true
ঐচ্ছিক
faceRestoreVisibilityrestoreVisibility
POST/api/v1/face-swap/gif

GIF মুখ অদলবদল

একটি আপলোড করা টার্গেট GIF জুড়ে একটি উৎস পরিচয় প্রয়োগ করুন৷

আবশ্যক
sourceImagetargetGifconsent=true
ঐচ্ছিক
faceRestoreVisibilityrestoreVisibility
POST/api/v1/face-swap/multiple

একাধিক মুখের ছবি অদলবদল

একটি গ্রুপ ফটোতে এক থেকে দশটি নির্বাচিত মুখ প্রতিস্থাপন করুন।

আবশ্যক
sourceImagetargetFace0consent=true
ঐচ্ছিক
targetFace1...targetFace9faceBox0...faceBox9
GET/api/v1/tasks

টাস্ক ইতিহাস

প্রমাণীকৃত অ্যাকাউন্টের মালিকানাধীন কাজের তালিকা করুন।

ঐচ্ছিক
pagepageSizestatustaskType

প্রতিটি মিডিয়া টাস্ক পোল করুন

মিডিয়া POST taskId ফেরত দেওয়ার পর, স্ট্যাটাস PENDING বা PROCESSING থাকা পর্যন্ত taskId-কে ক্যোয়ারি প্যারামিটার করে একই মিডিয়া রুটে GET পাঠান। COMPLETED, FAILED ও CANCELLED টার্মিনাল স্ট্যাটাস।

বহনকারী প্রমাণীকরণ

অনুমোদন হিসাবে প্রতিটি অনুরোধে কী পাঠান: বহনকারী YOUR_API_KEY। API কীগুলি যাচাইকৃত অ্যাকাউন্ট এবং এর লাইভ ক্রেডিট ব্যালেন্সের উত্তরাধিকারী হয়। আবেদন-স্তরের প্রমাণীকৃত সীমা প্রতি মিনিটে 300টি অনুরোধ; উৎপাদন ক্ষমতা সারি-নির্ভর থাকে।

HTTP
Authorization: Bearer YOUR_API_KEY

জাভাস্ক্রিপ্ট এবং পাইথন উদাহরণ

এই সার্ভার-সাইড উদাহরণ দুটি স্থানীয় ফাইল জমা দেয়, HTTP ব্যর্থতা প্রত্যাখ্যান করে, ম্যাচিং টাস্ক রুট পোল করে এবং অস্থায়ী ফলাফল URL প্রিন্ট করে। প্রতিটি ক্ষেত্র লাইভ OpenAPI চুক্তি থেকে আসে।

JavaScriptNode.js 18+
JavaScript · Node.js 18+
import { readFile } from 'node:fs/promises';

const apiUrl = 'https://faceswapai.com/api/v1/face-swap/image';
const headers = {
  Authorization: 'Bearer ' + process.env.FACESWAPAI_API_KEY,
};
const form = new FormData();
form.set('sourceImage', new Blob([await readFile('./source.jpg')]), 'source.jpg');
form.set('targetImage', new Blob([await readFile('./target.jpg')]), 'target.jpg');
form.set('consent', 'true');

const submitted = await fetch(apiUrl, { method: 'POST', headers, body: form });
if (!submitted.ok) throw new Error(submitted.status + ': ' + await submitted.text());
const { taskId } = await submitted.json();

let task;
do {
  await new Promise((resolve) => setTimeout(resolve, 2000));
  const polled = await fetch(apiUrl + '?taskId=' + encodeURIComponent(taskId), { headers });
  if (!polled.ok) throw new Error(polled.status + ': ' + await polled.text());
  task = await polled.json();
} while (task.status === 'PENDING' || task.status === 'PROCESSING');

console.log(task.status === 'COMPLETED' ? task.result?.url : task.result?.error);
Pythonrequests 2.x
Python · requests 2.x
import os
import time
import requests

api_url = "https://faceswapai.com/api/v1/face-swap/image"
headers = {"Authorization": "Bearer " + os.environ["FACESWAPAI_API_KEY"]}

with open("source.jpg", "rb") as source, open("target.jpg", "rb") as target:
    response = requests.post(
        api_url,
        headers=headers,
        files={"sourceImage": source, "targetImage": target},
        data={"consent": "true"},
        timeout=60,
    )
response.raise_for_status()
task_id = response.json()["taskId"]

while True:
    time.sleep(2)
    response = requests.get(api_url, headers=headers, params={"taskId": task_id}, timeout=30)
    response.raise_for_status()
    task = response.json()
    if task["status"] not in ("PENDING", "PROCESSING"):
        break

result = task.get("result") or {}
print(result.get("url") if task["status"] == "COMPLETED" else result.get("error"))

জমা দিন, তারপর ভোট দিন

সফল POST প্রয়োজনীয় ক্রেডিট সংরক্ষণ করে এবং taskId ফেরত দেয়। স্ট্যাটাস PENDING বা PROCESSING থাকা পর্যন্ত একই মিডিয়া রুট পোল করুন। COMPLETED, FAILED ও CANCELLED টার্মিনাল স্ট্যাটাস। কিউ বা প্রদানকারী ব্যর্থ হলে মুলতুবি সংরক্ষণ ঠিক একবার ফেরত দেওয়া হয়।

cURL
curl --get https://faceswapai.com/api/v1/face-swap/image \
  --header "Authorization: Bearer $FACESWAPAI_API_KEY" \
  --data-urlencode "taskId=YOUR_TASK_ID"
PENDING
গৃহীত এবং সারিবদ্ধ
PROCESSING
চলছে
COMPLETED
ফলাফল পাওয়া যাচ্ছে
FAILED
একটি সর্বজনীন ত্রুটির সাথে থামানো হয়েছে৷
CANCELLED
বাতিল করা হয়েছে

বিন্যাস এবং সীমা

ছবিগুলি JPG, PNG, WebP, GIF, BMP, HEIC বা HEIF 30 MB পর্যন্ত গ্রহণ করে৷ ভিডিও MP4, MOV, WebM বা AVI 100 MB এবং 600 সেকেন্ড পর্যন্ত গ্রহণ করে৷ GIF লক্ষ্যগুলি 30 MB এবং 30 সেকেন্ডের মধ্যে সীমাবদ্ধ৷ একাধিক মুখের ইনপুট প্রতিটি 15 MB এবং দশটি নির্বাচিত মুখের মধ্যে সীমাবদ্ধ। 100 MB মানে সাধারণ ফোনের 1080p ভিডিওর প্রায় 1–2 মিনিট, তাই এর চেয়ে লম্বা ক্লিপ কমপ্রেস বা ছোট করে নিন।

HTTP ত্রুটি এবং পুনরায় চেষ্টা

অনুরোধ বা অ্যাকাউন্টের অবস্থা পরিবর্তন না করে 400, 401, 402, 403 বা 413 প্রতিক্রিয়া পুনরায় চেষ্টা করবেন না। 429 এ ফিরে যান। বিলম্বের পরে একটি 500 বা 503 পুনরায় চেষ্টা করা যেতে পারে; ক্রেডিট রিজার্ভেশন টাস্ক রিফান্ড পাথ দ্বারা সুরক্ষিত হয়.

বর্তমান উৎপাদন সীমানা

পাবলিক v1 চুক্তির বিরুদ্ধে পরিকল্পনা করুন যা আজ বিদ্যমান, যা দাবি করে না তা সহ।

  • মিডিয়া কাজগুলি অ্যাসিঙ্ক্রোনাস এবং পোলিং ব্যবহার করে৷ বর্তমান পাবলিক v1 চুক্তি একটি ওয়েবহুক প্রকাশ করে না।
  • কোন পাবলিক ব্যাচ রুট, idempotency-কী ক্ষেত্র, লাইভ-ক্যামেরা রুট, প্রকাশিত SLA বা গ্যারান্টিযুক্ত সমাপ্তির সময় নেই।
  • API কীগুলি একটি সুরক্ষিত সার্ভারের অন্তর্গত। ফলাফল অস্থায়ী, উৎপাদন ক্ষমতা সারি-নির্ভর এবং স্বীকৃত ব্যর্থতা নথিভুক্ত ফেরত পথ ব্যবহার করে।

সম্মতি, গোপনীয়তা এবং ওয়াটারমার্ক

প্রতিটি প্রজন্মের জন্য সম্মতি প্রয়োজন=সত্য, মানে আপনার কাছে প্রতিটি আপলোড করা মুখ ব্যবহার করার অনুমতি আছে৷ টাস্ক মিডিয়া অস্থায়ী। কোনো বিনামূল্যের ট্রায়াল নেই: প্রতিটি কাজ এককালীন ক্রেডিট দিয়ে পরিশোধ করা হয়, এবং কোনো ফলাফলে ওয়াটারমার্ক বা অ্যাকাউন্ট ইমেল থাকে না।

ফেস সোয়াপ API FAQ

একটি বিনামূল্যের ফেস সোয়াপ API কী আছে?

একটি API কী তৈরি করা বিনামূল্যে। জেনারেশন অ্যাকাউন্ট ক্রেডিট ব্যালেন্স ব্যবহার করে। কোনো বিনামূল্যের ট্রায়াল বা বিনামূল্যের API স্তর নেই: প্রতিটি কাজ এককালীন ক্রেডিট দিয়ে পরিশোধ করা হয়, 600 ক্রেডিট $19.99 থেকে শুরু।

API কি ভিডিও এবং একাধিক মুখ সমর্থন করে?

হ্যাঁ। সংস্করণযুক্ত রুটগুলি ছবি, ভিডিও, GIF এবং বহুমুখী ছবির কাজগুলি কভার করে। ভিডিও এবং GIF মূল্য পরিমাপ করা মিডিয়া মেটাডেটা থেকে গণনা করা হয়।

ফলাফল প্রস্তুত হলে আমি কিভাবে জানব?

POST প্রতিক্রিয়া থেকে taskId পড়ে স্ট্যাটাস PENDING বা PROCESSING থাকা পর্যন্ত সংশ্লিষ্ট GET রুট পোল করুন। COMPLETED-এ অস্থায়ী ফলাফলের URL থাকে; FAILED ও CANCELLED-ও টার্মিনাল স্ট্যাটাস।

আমি কি সরাসরি ব্রাউজার থেকে API কল করতে পারি?

ব্রাউজার কোডে একটি গোপন কী প্রকাশ করবেন না। আপনার নিজস্ব সার্ভার, সার্ভারহীন ফাংশন বা অন্যান্য সুরক্ষিত ব্যাকএন্ড থেকে অনুরোধ পাঠান।