آواز سے جنس کی API
اپ لوڈ کردہ آڈیو یا آڈیو URL سے بولنے والے کی ممکنہ جنس شناخت کریں۔
بنیادی URL
https://api.genderrecognition.com
فائل اینڈپوائنٹ
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"
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 یا اس سے کم ہونی چاہیے۔