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

इमेज से लिंग पहचान API

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

बेस URL​

https://api.genderrecognition.com

एंडपॉइंट​

POST /v1/image-gender/api

हेडर​

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