দ্রুত শুরু
আপনার যাচাইকৃত অ্যাকাউন্টে একটি কী তৈরি করুন, আপনার সার্ভার থেকে একটি মাল্টিপার্ট অনুরোধ পাঠান, তারপরে ফিরে আসা টাস্কআইডির সাথে মিলিত GET রুটে পোল করুন। ব্রাউজার এবং মোবাইল ক্লায়েন্ট বান্ডিলের বাইরে গোপন রাখুন।
- 1একবার একটি কী তৈরি করুন এবং অনুলিপি করুন
- 2সম্মতি সহ স্থানীয় মিডিয়া জমা দিন=সত্য
- 3স্ট্যাটাস PENDING বা PROCESSING থাকা পর্যন্ত পোল করুন
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/gif | GIF মুখ অদলবদল | 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 ক্রেডিটmax(9, 3 × ceil(8))24 ক্রেডিটmax(9, 3 × ceil(18))54 ক্রেডিটএন্ডপয়েন্ট দ্বারা ক্ষেত্র অনুরোধ করুন
টার্গেট মিডিয়ার মাধ্যমে রুটটি বেছে নিন, তারপর নিচের সঠিক মাল্টিপার্ট ক্ষেত্রগুলি পাঠান। ঐচ্ছিক পুনরুদ্ধার নিয়ন্ত্রণ 0 থেকে 1 পর্যন্ত সংখ্যা গ্রহণ করে।
/api/v1/face-swap/imageছবি ফেস সোয়াপ
একটি টার্গেট ফটোতে একটি উৎস পরিচয় প্রয়োগ করুন৷
- আবশ্যক
sourceImagetargetImageconsent=true- ঐচ্ছিক
faceRestoreVisibilityrestoreVisibility
/api/v1/face-swap/videoভিডিও ফেস সোয়াপ
আপলোড করা টার্গেট ভিডিও জুড়ে একটি উৎস পরিচয় প্রয়োগ করুন।
- আবশ্যক
sourceImagetargetVideoconsent=true- ঐচ্ছিক
faceRestoreVisibilityrestoreVisibility
/api/v1/face-swap/gifGIF মুখ অদলবদল
একটি আপলোড করা টার্গেট GIF জুড়ে একটি উৎস পরিচয় প্রয়োগ করুন৷
- আবশ্যক
sourceImagetargetGifconsent=true- ঐচ্ছিক
faceRestoreVisibilityrestoreVisibility
/api/v1/face-swap/multipleএকাধিক মুখের ছবি অদলবদল
একটি গ্রুপ ফটোতে এক থেকে দশটি নির্বাচিত মুখ প্রতিস্থাপন করুন।
- আবশ্যক
sourceImagetargetFace0consent=true- ঐচ্ছিক
targetFace1...targetFace9faceBox0...faceBox9
/api/v1/tasksটাস্ক ইতিহাস
প্রমাণীকৃত অ্যাকাউন্টের মালিকানাধীন কাজের তালিকা করুন।
- ঐচ্ছিক
pagepageSizestatustaskType
প্রতিটি মিডিয়া টাস্ক পোল করুন
মিডিয়া POST taskId ফেরত দেওয়ার পর, স্ট্যাটাস PENDING বা PROCESSING থাকা পর্যন্ত taskId-কে ক্যোয়ারি প্যারামিটার করে একই মিডিয়া রুটে GET পাঠান। COMPLETED, FAILED ও CANCELLED টার্মিনাল স্ট্যাটাস।
বহনকারী প্রমাণীকরণ
অনুমোদন হিসাবে প্রতিটি অনুরোধে কী পাঠান: বহনকারী YOUR_API_KEY। API কীগুলি যাচাইকৃত অ্যাকাউন্ট এবং এর লাইভ ক্রেডিট ব্যালেন্সের উত্তরাধিকারী হয়। আবেদন-স্তরের প্রমাণীকৃত সীমা প্রতি মিনিটে 300টি অনুরোধ; উৎপাদন ক্ষমতা সারি-নির্ভর থাকে।
Authorization: Bearer YOUR_API_KEYজাভাস্ক্রিপ্ট এবং পাইথন উদাহরণ
এই সার্ভার-সাইড উদাহরণ দুটি স্থানীয় ফাইল জমা দেয়, HTTP ব্যর্থতা প্রত্যাখ্যান করে, ম্যাচিং টাস্ক রুট পোল করে এবং অস্থায়ী ফলাফল URL প্রিন্ট করে। প্রতিটি ক্ষেত্র লাইভ OpenAPI চুক্তি থেকে আসে।
JavaScriptNode.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
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 --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 কল করতে পারি?
ব্রাউজার কোডে একটি গোপন কী প্রকাশ করবেন না। আপনার নিজস্ব সার্ভার, সার্ভারহীন ফাংশন বা অন্যান্য সুরক্ষিত ব্যাকএন্ড থেকে অনুরোধ পাঠান।