मुख्य कंटेंट तक स्किप करें

इमेज से आयु अनुमान API

व्यक्ति और चेहरे पहचानने के लिए इमेज अपलोड करें। हर पहचान के लिए आयु का अनुमान और विश्वास प्रतिशत लौटाया जाएगा।

बेस URL​

https://api.genderrecognition.com

एंडपॉइंट​

POST /v1/image-gender/api/age

हेडर​

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

अनुरोध बॉडी​

फ़ील्डप्रकारज़रूरीविवरण
fileफ़ाइलहाँ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
}

प्रतिक्रिया फ़ील्ड​

फ़ील्डप्रकारविवरण
successबूलियनइमेज सफलतापूर्वक प्रोसेस होने पर true।
detectionsसूचीअनुमानित आयु वाले हर पहचाने गए चेहरे के लिए एक प्रविष्टि।
detections[].ageसंख्यापहचान के लिए अनुमानित आयु। इसमें दशमलव हो सकता है।
detections[].probabilityपूर्णांक0 से 100 तक विश्वास प्रतिशत। नीचे नोट देखें।
remainingRequestsपूर्णांकइस सफल अनुरोध के बाद शेष 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 सूची सफल परिणाम है, त्रुटि नहीं।
  • अनुमान मॉडल द्वारा दिए जाते हैं; इन्हें पहचान के सत्यापित गुण न मानें।