مین مواد پر جائیں

تصویر سے عمر کی 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 key موجود نہیں — 401 Unauthorized​

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

غلط API key — 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 فہرست کامیاب نتیجہ ہے، خرابی نہیں۔
  • پیش گوئیاں ماڈل کے اندازے ہیں؛ انہیں تصدیق شدہ شناختی خصوصیات نہ سمجھیں۔