স্কিপ করে মূল কন্টেন্ট এ যান

ছবি থেকে বয়স API

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

মূল URL​

https://api.genderrecognition.com

এন্ডপয়েন্ট​

POST /v1/image-gender/api/age

হেডারসমূহ​

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

বডি​

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

উদাহরণ​

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

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

{
  "success": true,
  "detections": [
    {
      "age": 27.4,
      "probability": 99
    },
    {
      "age": 41.2,
      "probability": 94
    }
  ],
  "remainingRequests": 2999
}

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

ক্ষেত্রধরনবিবরণ
successbooleanছবি সফলভাবে প্রক্রিয়াকৃত হলে true।
detectionsarrayবয়সের পূর্বাভাসসহ শনাক্ত প্রতিটি মুখের জন্য একটি এন্ট্রি।
detections[].agenumberশনাক্তকরণের পূর্বাভাসকৃত বয়স; দশমিক থাকতে পারে।
detections[].probabilityintegerআত্মবিশ্বাসের শতাংশ, 0 থেকে 100। নিচের নোট দেখুন।
remainingRequestsintegerএই সফল অনুরোধের কোটা কেটে নেওয়ার পর অবশিষ্ট API অনুরোধ।

probability হলো ওই শনাক্তকরণের লিঙ্গ শ্রেণিবিন্যাসে মডেলের আত্মবিশ্বাস, যা এখানে প্রদর্শিত আত্মবিশ্বাসের মান হিসেবে ব্যবহৃত হয়েছে। বয়সের অনুমানের জন্য মডেল আলাদা আত্মবিশ্বাসের স্কোর দেয় না। বেশি probability মানে ব্যক্তির লিঙ্গ সম্পর্কে মডেলের আত্মবিশ্বাস বেশি, age-এর নির্ভুলতা নয়।

মডেল কেবল আত্মবিশ্বাসী লিঙ্গ শ্রেণিবিন্যাস করা শনাক্তকরণগুলো অন্তর্ভুক্ত করে। লিঙ্গের পূর্বাভাস অস্পষ্ট বা অমিল হলে দৃশ্যত মুখ বা ব্যক্তি শনাক্ত হলেও তা detections থেকে বাদ পড়ে। তাই detections-এর এন্ট্রির সংখ্যা ছবির মুখের সংখ্যার চেয়ে কম হতে পারে।

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

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

{
  "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 age prediction failed"
}

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

নোট​

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