वॉइस से लिंग पहचान API
अपलोड किए गए ऑडियो या ऑडियो URL से वक्ता के संभावित लिंग की पहचान करें।
बेस URL
https://api.genderrecognition.com
एंडपॉइंट चुनें
| विकल्प | विधि और पथ | किसके लिए उपयोगी |
|---|---|---|
| मानक फ़ाइल विश्लेषण | POST /v1/voice-gender-recognition/api | मानक विश्लेषण व्यवहार के साथ फ़ाइल अपलोड। |
| मानक URL विश्लेषण | POST /v1/voice-gender-recognition/api/url | सार्वजनिक URL पर उपलब्ध ऑडियो फ़ाइल। |
| V2: पूरी रिकॉर्डिंग का विश्लेषण | POST /v1/voice-gender-recognition/api/v2 | एक वक्ता वाली रिकॉर्डिंग के लिए भाषण-पहचान विश्लेषण। |
| V3: वक्ता-आधारित विश्लेषण | POST /v1/voice-gender-recognition/api/v3 | कॉल, इंटरव्यू और कई वक्ताओं वाली अन्य रिकॉर्डिंग। |
मानक URL एंडपॉइंट JSON में ऑडियो URL स्वीकार करता है। V2 और V3 केवल अपलोड की गई फ़ाइलें स्वीकार करते हैं; ऑडियो URL नहीं।
फ़ाइल एंडपॉइंट
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"
संस्करण वाले फ़ाइल एंडपॉइंट
ऊपर दिया गया मानक फ़ाइल एंडपॉइंट मौजूदा इंटीग्रेशन के लिए उपलब्ध रहेगा। V2 और V3 फ़ाइल विश्लेषण के अतिरिक्त विकल्प हैं। दोनों multipart file फ़ील्ड में एक ऑडियो फ़ाइल लेते हैं, भाषण की जाँच करते हैं और पर्याप्त उपयोगी भाषण न मिलने पर हमेशा पुरुष या महिला का अनुमान लगाने के बजाय unknown लौटा सकते हैं।
V2: पूरी रिकॉर्डिंग का विश्लेषण
POST /v1/voice-gender-recognition/api/v2
V2 पहले मानव भाषण की जाँच करता है, फिर ECAPA-TDNN वॉइस मॉडल से पूरी रिकॉर्डिंग का वर्गीकरण करता है। यह एक वक्ता वाली रिकॉर्डिंग के लिए उपयुक्त है। कई वक्ताओं के होने पर उनकी आवाज़ों का एक साथ विश्लेषण होता है; किसी एक वक्ता का परिणाम चाहिए तो V3 चुनें।
हर सफल V2 कॉल 1 API अनुरोध खर्च करती है।
curl -X POST "https://api.genderrecognition.com/v1/voice-gender-recognition/api/v2" \
-H "apiKey: YOUR_API_KEY" \
-F "file=@audio.wav"
लिंग पहचान होने पर प्रतिक्रिया का उदाहरण:
{
"success": true,
"gender": "female",
"confidence": 92,
"remainingRequests": 119
}
मानव भाषण न मिलने पर भी V2 सफल प्रतिक्रिया देता है और gender को unknown रखता है:
{
"success": true,
"gender": "unknown",
"confidence": 0,
"message": "No clear speech was detected in the audio, so the gender could not be determined.",
"remainingRequests": 119
}
V3: वक्ता-आधारित विश्लेषण
POST /v1/voice-gender-recognition/api/v3
V3 भाषण पहचानता है और चुने गए एक वक्ता का वर्गीकरण करने के लिए स्पीकर डायरीकरण का उपयोग करता है। यह कॉल, इंटरव्यू और कई वक्ताओं वाली रिकॉर्डिंग के लिए बनाया गया है। पहले वक्ता को चुना जाता है; यदि वह 2 सेकंड से कम बोलता है, तो सबसे अधिक समय बोलने वाले वक्ता को चुना जाता है। चुने गए वक्ता के पास 1 सेकंड से कम भाषण होने पर परिणाम unknown होता है। V3, V2 से धीमा है और भाषण मिलने पर Deepgram की सशुल्क सेवा का अनुरोध करता है।
हर सफल V3 कॉल 2 API अनुरोध खर्च करती है।
curl -X POST "https://api.genderrecognition.com/v1/voice-gender-recognition/api/v3" \
-H "apiKey: YOUR_API_KEY" \
-F "file=@audio.wav"
लिंग पहचान होने पर प्रतिक्रिया का उदाहरण:
{
"success": true,
"gender": "female",
"confidence": 92,
"remainingRequests": 118
}
भाषण न मिलने या चुने गए वक्ता का भाषण बहुत कम होने पर V3 सफल प्रतिक्रिया देता है और gender को unknown रखता है:
{
"success": true,
"gender": "unknown",
"confidence": 0,
"message": "Not enough clear speech from a single speaker was detected in the audio, so the gender could not be determined.",
"remainingRequests": 118
}
दोनों संस्करणों में confidence 0 से 100 तक पूर्णांक प्रतिशत है और remainingRequests अनुरोध कटने के बाद का शेष कोटा दिखाता है। unknown सफल परिणाम है, API त्रुटि नहीं। दोनों मानक एंडपॉइंट वाला API key, multipart फ़ील्ड, फ़ाइल आकार सीमा और सामान्य प्रमाणीकरण व फ़ाइल सत्यापन त्रुटियाँ उपयोग करते हैं।
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 या उससे छोटी होनी चाहिए।