वॉइस से लिंग पहचान 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 या उससे छोटी होनी चाहिए।