آواز سے جنس کی 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 صرف اپ لوڈ کردہ فائلیں قبول کرتے ہیں، آڈیو URLs نہیں۔
فائل اینڈپوائنٹ
POST /v1/voice-gender-recognition/api
ہیڈرز
apiKey: YOUR_API_KEY
Content-Type: multipart/form-data
درخواست کا مواد
| فیلڈ | قسم | لازمی | وضاحت |
|---|---|---|---|
file | 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 صفر سے 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 key موجود نہیں
{
"error": "API key is required"
}
غلط API key
{
"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 form data استعمال کرتی ہیں۔
- URL کی درخواستیں JSON استعمال کرتی ہیں۔
- آڈیو اپ لوڈ میں
fileفیلڈ استعمال کریں؛ فائل 10 MB یا اس سے کم ہونی چاہیے۔