ছবি থেকে লিঙ্গ API

ব্যক্তি ও মুখ শনাক্ত করতে ছবি আপলোড করুন এবং প্রতিটি শনাক্তকরণের জন্য আত্মবিশ্বাসের শতাংশসহ লিঙ্গের পূর্বাভাস পান।

মূল URL

https://api.genderrecognition.com

এন্ডপয়েন্ট

POST /v1/image-gender/api

হেডারসমূহ

apiKey: YOUR_API_KEY
Content-Type: multipart/form-data

বডি

ক্ষেত্র	ধরন	আবশ্যক	বিবরণ
file	file	হ্যাঁ	JPEG, PNG, WebP, BMP বা GIF ছবি। সর্বোচ্চ আকার: 10 MB।

উদাহরণ

curl -X POST "https://api.genderrecognition.com/v1/image-gender/api" \
  -H "apiKey: YOUR_API_KEY" \
  -F "file=@people.jpg"

সফল প্রতিক্রিয়া

{
  "success": true,
  "detections": [
    {
      "category": "face",
      "gender": "female",
      "probability": 99
    },
    {
      "category": "person",
      "gender": "male",
      "probability": 94
    }
  ],
  "remainingRequests": 2999
}

প্রতিক্রিয়ার ক্ষেত্রসমূহ

ক্ষেত্র	ধরন	বিবরণ
success	boolean	ছবি সফলভাবে প্রক্রিয়াকৃত হলে true।
detections	array	পূর্বাভাসসহ শনাক্ত প্রতিটি মুখ বা অমিল ব্যক্তির জন্য একটি এন্ট্রি।
detections[].category	face | person	মুখ ব্যক্তির সঙ্গে মিলে গেলে face; শুধু শরীর শনাক্ত হলে person।
detections[].gender	male | female	শনাক্তকরণের জন্য পূর্বাভাসকৃত লিঙ্গ।
detections[].probability	integer	আত্মবিশ্বাসের শতাংশ, 0 থেকে 100।
remainingRequests	integer	এই সফল অনুরোধের কোটা কেটে নেওয়ার পর অবশিষ্ট API অনুরোধ।

মুখ ও শরীর একই ব্যক্তির হলে প্রতিক্রিয়ায় আলাদা মুখ ও ব্যক্তির এন্ট্রির বদলে একটি face শনাক্তকরণ থাকে।

কিছু শনাক্ত হয়নি

ব্যবহারযোগ্য মুখ বা ব্যক্তি না পেলেও প্রক্রিয়াকরণ সফল হতে পারে। তবুও একটি অনুরোধের কোটা কাটা হয়:

{
  "success": true,
  "detections": [],
  "remainingRequests": 2999
}

ত্রুটির প্রতিক্রিয়া

API কী নেই — 401 Unauthorized

{
  "error": "API key is required"
}

অবৈধ API কী — 404 Not Found

{
  "error": "Invalid API key"
}

প্রমাণীকরণ সেবায় ত্রুটি — 500 Internal Server Error

{
  "error": "Internal server error"
}

ফাইল নেই — 400 Bad Request

multipart ক্ষেত্রটির নাম file হতে হবে।

{
  "error": "No file uploaded"
}

অপ্রত্যাশিত multipart ক্ষেত্র — 400 Bad Request

আপলোড করা ফাইলের ক্ষেত্রের নাম file না হলে বা একক-ফাইল ক্ষেত্রে একাধিক ফাইল পাঠালে এই প্রতিক্রিয়া আসে।

{
  "error": "Unexpected field"
}

ফাইলের ধরন অবৈধ — 400 Bad Request

{
  "error": "Invalid file type. Allowed formats: JPEG, PNG, WEBP, BMP, GIF"
}

ফাইল অনেক বড় — 400 Bad Request

{
  "error": "File too large"
}

ছবি ডিকোড করা যায়নি — 400 Bad Request

{
  "error": "Could not decode image"
}

আপলোড করা ছবি অবৈধ হলে পূর্বাভাস সেবা অন্য 400 যাচাইকরণ বার্তাও দিতে পারে। প্রতিক্রিয়ার গঠন একই { "error": "..." } থাকে।

পূর্বাভাস সেবা ফাইলের আকার প্রত্যাখ্যান করেছে — 413 Payload Too Large

{
  "error": "Uploaded file exceeds the 10MB size limit"
}

কোটা শেষ — 400 Bad Request

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "You have exceeded your free tier limit of 50 requests.",
    "detailedMessage": "Insufficient remaining requests. Required: 1, Available: 0",
    "details": {
      "limit": 50,
      "used": 50,
      "reset_date": "2026-07-01T00:00:00.000Z"
    },
    "suggested_action": "Please upgrade to a premium plan to continue using the API."
  }
}

পেইড প্ল্যানেও একই প্রতিক্রিয়ার গঠন থাকে, তবে সীমা, রিসেটের তারিখ ও আপগ্রেডের নির্দেশনা প্ল্যানভেদে আলাদা।

প্রক্রিয়াকরণের সময় কোটা পরিবর্তিত হয়েছে — 400 Bad Request

পূর্বাভাসের আগে কোটা পরীক্ষা করা হয় এবং সফল প্রক্রিয়াকরণের পর কাটা হয়। এই দুই ধাপের মধ্যে অন্য কোনো সমসাময়িক অনুরোধ অবশিষ্ট কোটা ব্যবহার করে ফেললে কোটা কাটার সময় এ প্রতিক্রিয়া আসতে পারে:

{
  "error": "Insufficient remaining requests. Required: 1, Available: 0"
}

প্রক্রিয়াকরণ ব্যর্থ — 500 Internal Server Error

{
  "error": "Image gender prediction failed"
}

উৎসের পূর্বাভাস সেবা আরও নির্দিষ্ট অভ্যন্তরীণ ত্রুটি দিলে একই গঠনের প্রতিক্রিয়ায় error ক্ষেত্রে সেই বার্তাটি আসতে পারে।

নোট

• file নামের multipart ক্ষেত্র ব্যবহার করে ঠিক একটি ছবি পাঠান।
• পূর্বাভাস সেবা সফল উত্তর দেওয়ার পরই একটি অনুরোধের কোটা কাটা হয়।
• probability পূর্ণসংখ্যার শতাংশ, 0 থেকে 1-এর মধ্যে দশমিক নয়।
• খালি detections array সফল ফল, ত্রুটি নয়।
• পূর্বাভাস মডেলের অনুমান; এগুলোকে যাচাইকৃত পরিচয়-সংক্রান্ত বৈশিষ্ট্য হিসেবে ধরবেন না।