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

वॉइस से लिंग पहचान API

अपलोड किए गए ऑडियो या ऑडियो URL से वक्ता के संभावित लिंग की पहचान करें।

बेस URL​

https://api.genderrecognition.com

फ़ाइल एंडपॉइंट​

POST /v1/voice-gender-recognition/api

हेडर​

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

अनुरोध बॉडी​

फ़ील्डप्रकारज़रूरीविवरण
fileफ़ाइलहाँविश्लेषण के लिए ऑडियो फ़ाइल।

उदाहरण​

curl -X POST "https://api.genderrecognition.com/v1/voice-gender-recognition/api" \
-H "apiKey: YOUR_API_KEY" \
-F "file=@audio.wav"

URL एंडपॉइंट​

POST /v1/voice-gender-recognition/api/url

हेडर​

apiKey: YOUR_API_KEY
Content-Type: application/json

अनुरोध बॉडी​

{
"url": "https://example.com/audio.wav"
}

प्रतिक्रिया​

फ़ाइल अनुरोध अनुमान, प्रतिशत के रूप में विश्वास स्कोर और अपडेट किया गया कोटा मेटाडेटा लौटाते हैं।

{
"success": true,
"gender": "male",
"confidence": 97,
"remainingRequests": 2999
}

URL अनुरोध अनुमान और कोटा मेटाडेटा लौटाते हैं। पहली धीमी प्रतिक्रिया में info संदेश भी हो सकता है।

{
"success": true,
"gender": "male",
"remainingRequests": 2999
}

त्रुटि स्थितियाँ​

API कुंजी मौजूद नहीं है​

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

अमान्य API कुंजी​

{
"error": "Invalid API key"
}

फ़ाइल मौजूद नहीं है​

{
"error": "No file uploaded"
}

अमान्य फ़ाइल प्रकार​

{
"error": "Invalid file type. Only audio formats are allowed"
}

URL अनुरोध अमान्य है​

{
"error": "A valid http or https URL is required"
}

JSON Content-Type हेडर मौजूद नहीं है​

{
"error": "Content-Type header is required. Please set Content-Type: application/json"
}

JSON Content-Type समर्थित नहीं है​

{
"error": "Content-Type must be application/json"
}

कोटा समाप्त हो गया​

{
"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."
}
}

नोट्स​

  • फ़ाइल अनुरोध multipart फ़ॉर्म डेटा का उपयोग करते हैं।
  • URL अनुरोध JSON का उपयोग करते हैं।
  • ऑडियो अपलोड के लिए file फ़ील्ड का उपयोग करें; फ़ाइल 10 MB या उससे छोटी होनी चाहिए।