التعرف على الجنس من الصوت API

حوّل المقاطع الصوتية إلى رؤى عن الجنس باستخدام واجهة برمجة تطبيقات واحدة.

أرسل إما رابط صوتي أو ملف صوتي في الجسم للحصول على الجنس ومستوى الثقة ومعلومات الاستخدام. مصمم لأنظمة IVR ومراكز الاتصال والتطبيقات الصوتية.

Vرفع الملف أو رابط الصوت
Vإرجاع درجات الثقة
Vمقاطع قصيرة غالبًا <2 ثانية
Vآمن عبر HTTPS

البدء السريع (JSON body)

POST JSON
/v1/voice-gender-recognition/apiPOST

// Headers

apiKey:

YOUR_API_KEY

// JSON Body

{
  "url": "https://example.com/audio.wav" 
OR
"file": "audio_file"
}

// Sample Response

{
  "gender": "female",
  "confidence": 95,
  "remainingRequests": 120,
  "success": true
}

أرسل إما url أو file (base64) في جسم JSON—وليس كلاهما. للتحميلات الكبيرة، استخدم multipart/form-data لـ POST /v1/voice-gender-recognition/api مع حقل "file".

اختر إصدار واجهة البرمجة

مقارنة V2 وV3

يظل المسار الحالي V1 متاحًا للطلبات التي تستخدم رابطًا أو ملفًا. يتطلب V2 وV3 رفع ملف بصيغة multipart/form-data، ويتحققان من وجود كلام كافٍ؛ وعند عدم توفر كلام صالح يعيدان القيمة “unknown”.

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
}

V3 · تحليل يراعي المتحدثين

طلبا API لكل استدعاء

يكتشف V3 الكلام ويحدد المتحدثين ثم يصنف متحدثًا واحدًا مختارًا. يناسب المكالمات والمقابلات والتسجيلات متعددة المتحدثين. يُختار المتحدث الأول ما لم يتحدث أقل من ثانيتين، وعندها يُختار المتحدث صاحب أطول وقت كلام. إذا لم يُكتشف كلام أو كان كلام المتحدث المختار أقل من ثانية، تكون gender هي “unknown”. أرسل ملفًا صوتيًا في الحقل file ضمن طلب multipart/form-data.

لماذا تختار V3 بدلًا من V1 وV2؟ مثل V2، يتجنب التخمين عند غياب الكلام ويستخدم ECAPA-TDNN بدلًا من نموذج V1 القديم. وعلى عكس V2 الذي يدمج جميع الأصوات في تنبؤ واحد، يستخدم V3 فصل المتحدثين لعزل متحدث قبل التصنيف وتقليل تأثير الأصوات الأخرى. يستغرق V3 وقتًا أطول ويجري اتصالًا مدفوعًا بخدمة Deepgram عند وجود كلام في التسجيل.

المسار

POST /v1/voice-gender-recognition/api/v3

تعيد الاستجابات الناجحة gender بإحدى القيم male أو female أو unknown، وconfidence كنسبة مئوية، وremainingRequests. وعندما تكون gender هي unknown، تتضمن الاستجابة رسالة توضح السبب.

تُعاد unknown عند عدم اكتشاف الكلام أو عندما يكون كلام المتحدث المختار أقل من ثانية. هذه استجابة ناجحة وليست خطأً في واجهة البرمجة.

طلب cURL

curl -X POST 'https://api.genderrecognition.com/v1/voice-gender-recognition/api/v3' \
  -H 'apiKey: YOUR_API_KEY' \
  -F 'file=@/path/to/recording.wav'

مثال لاستجابة عند تحديد الجنس

{
  "success": true,
  "gender": "female",
  "confidence": 92,
  "remainingRequests": 118
}

مثال للاستجابة عند تعذر تحديد الجنس

{
  "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
}

إثراء أصلي للصوت

أدخل المقاطع الصوتية وأثر السجلات بإشارات الجنس ومستوى الثقة والاستخدام المتبقي.

استيعاب مرن

أرسل روابط أو ملفات مضمنة في الجسم، وقم بالتحميل باستخدام multipart/form-data عند الحاجة.

الإشراف والثقة

وضع علامة على الحالات الشاذة أو عدم التطابق بين الجنس المعلن والمكتشف في قوائم الانتظار الآلية.

مصمم للتوسع

تعامل مع الارتفاعات بسلاسة مع المعالجة المرنة وحدود الاستخدام الشفافة.

استجابات JSON نظيفة

حقول بسيطة: gender، confidence، remainingRequests، success.

تغطية التنسيقات

يدعم برامج الترميز والحاويات الشائعة، من wav وmp3 إلى ogg وm4a والمزيد.

كيف يعمل

الجنس من الصوت في ثلاث خطوات.

1

توفير الصوت

POST إلى /api مع إما حقل url أو حقل file (base64)؛ multipart/form-data مدعوم لتحميل الملفات أيضًا.

2

الحصول على استجابة JSON

احصل على gender وconfidence وremainingRequests في ثوانٍ.

3

التوسع عند الاستعداد

أتمتة الاستيعاب لوظائف الدفعات أو تدفقات IVR المضمنة بنفس الاستجابات.

cURL

URL أو file في body
curl -X POST 'https://api.genderrecognition.com/v1/voice-gender-recognition/api' \
  -H 'Content-Type: application/json' \
  -H 'apiKey: YOUR_API_KEY' \
  -d '{"url": "https://example.com/audio.wav" 
OR
"file": "audio_file"}'

تفضل إرسال ملف مضمن؟ استبدل url بـ "file":"BASE64_AUDIO_BYTES".

JavaScript

JSON body
const apiKey = "YOUR_API_KEY";
const payload = {
  "url": "https://example.com/audio.wav" 
OR
"file": "audio_file"
};

const response = await fetch(
  "https://api.genderrecognition.com/v1/voice-gender-recognition/api",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      apiKey,
    },
    body: JSON.stringify(payload),
  }
);
const result = await response.json();

مراكز الاتصال

تحليل المكالمات الواردة أو مطالبات IVR لإثراء التوجيه والتحليلات.

الإعداد الموجه بالصوت

اكتشاف الجنس من المطالبات المسجلة لتخصيص التجارب في الوقت الفعلي.

الإشراف

أتمتة الفحوصات على الصوت المقدم من المستخدم لسير عمل الثقة والأمان.

جاهز للبدء؟

نحن نقدم أفضل خدمات التعرف على الجنس باستخدام تقنية الذكاء الاصطناعي المتقدمة لضمان الدقة والخصوصية لجميع المستخدمين.

أنشئ حسابًا في دقائق للحصول على مفتاح واجهة برمجة التطبيقات الخاص بك والوصول غير المقيد.

تسجيل حساب

الاستخدام المجاني اليومي

استمتع بمستوى مجاني سخي كل يوم لاختبار واستكشاف واجهات برمجة التطبيقات الخاصة بنا.

جرب واجهة برمجة التطبيقات

التسعير

تسعير بسيط وشفاف. أول 300 طلب مجانًا، ثم ادفع حسب الاستخدام. تحقق من صفحة التسعير لمزيد من التفاصيل.

عرض التسعير

الأسئلة الشائعة

اشترك

انضم إلى نشرتنا الإخبارية لتبقى على اطلاع بأحدث الميزات

بالاشتراك، فإنك توافق على سياسة الخصوصية الخاصة بنا وتوفر موافقتك للحصول على أحدث الميزات.