V2 · تحليل التسجيل كاملًا
طلب API واحد لكل استدعاءيتحقق V2 أولًا من وجود كلام بشري، ثم يستخدم نموذج الصوت ECAPA-TDNN لتصنيف التسجيل كاملًا. يناسب التسجيلات ذات المتحدث الواحد. أرسل ملفًا صوتيًا في الحقل file ضمن طلب multipart/form-data.
لماذا تختار V2 بدلًا من V1؟ يتنبأ نموذج V1 القديم دائمًا بـ male أو female، حتى مع الصمت أو الموسيقى أو الضوضاء. يضيف V2 اكتشاف الكلام ويعيد unknown عند عدم اكتشافه بدلًا من التخمين. كما يستخدم ECAPA-TDNN الذي يحلل خصائص الصوت عبر الزمن؛ وأظهرت مقارنة الأصوات التجريبية في الخلفية دقة أعلى من نموذج V1. يجمع V2 أصوات التسجيل معًا، لذا استخدم V3 للتسجيلات متعددة المتحدثين.
المسار
POST /v1/voice-gender-recognition/api/v2تعيد الاستجابات الناجحة gender بإحدى القيم male أو female أو unknown، وconfidence كنسبة مئوية، وremainingRequests. وعندما تكون gender هي unknown، تتضمن الاستجابة رسالة توضح السبب.
تُعاد unknown عند عدم اكتشاف كلام بشري. هذه استجابة ناجحة وليست خطأً في واجهة البرمجة.
طلب cURL
curl -X POST 'https://api.genderrecognition.com/v1/voice-gender-recognition/api/v2' \ -H 'apiKey: YOUR_API_KEY' \ -F 'file=@/path/to/recording.wav'
مثال لاستجابة عند تحديد الجنس
{
"success": true,
"gender": "female",
"confidence": 92,
"remainingRequests": 119
}مثال للاستجابة عند تعذر تحديد الجنس
{
"success": true,
"gender": "unknown",
"confidence": 0,
"message": "No clear speech was detected in the audio, so the gender could not be determined.",
"remainingRequests": 119
}