إنتقل إلى المحتوى الرئيسي

API التعرّف على المشاعر في الكلام

اكتشف المشاعر المعبر عنها في الصوت المرفوع، مع درجة الثقة وتفصيل كامل لجميع المشاعر المدعومة.

عنوان URL الأساسي​

https://api.genderrecognition.com

المشاعر المدعومة​

  • angry
  • disgusted
  • fearful
  • happy
  • neutral
  • other
  • sad
  • surprised

نقطة النهاية​

POST /v1/speech-emotion/api

ترويسات الطلب​

apiKey: YOUR_API_KEY
Content-Type: multipart/form-data

محتوى الطلب​

الحقلالنوعمطلوبالوصف
filefileنعمملف صوتي لتحليله.

مثال​

curl -X POST "https://api.genderrecognition.com/v1/speech-emotion/api" \
  -H "apiKey: YOUR_API_KEY" \
  -F "file=@audio.wav"

الاستجابة​

{
  "success": true,
  "predicted_emotion": "happy",
  "confidence": 87,
  "expressions": {
    "angry": 2,
    "disgusted": 1,
    "fearful": 1,
    "happy": 87,
    "neutral": 6,
    "other": 0,
    "sad": 2,
    "surprised": 1
  },
  "remainingRequests": 2999
}

حقول الاستجابة​

الحقلالنوعالوصف
successbooleanتكون true عند معالجة الصوت بنجاح.
predicted_emotionstringالمشاعر الأرجح اكتشافها في الصوت.
confidenceintegerنسبة الثقة في predicted_emotion من 0 إلى 100.
expressionsobjectدرجة النسبة المئوية لكل شعور مدعوم.
remainingRequestsintegerعدد طلبات API المتبقية بعد خصم هذا الطلب الناجح.

جميع القيم نسب مئوية صحيحة وليست أعدادًا عشرية بين 0 و1.

حالات الخطأ​

مفتاح API مفقود​

{
  "error": "API key is required"
}

مفتاح API غير صالح​

{
  "error": "Invalid API key"
}

الملف مفقود​

{
  "error": "No file uploaded"
}

الملف كبير جدًا​

{
  "error": "File too large"
}

نوع الملف غير صالح​

{
  "error": "Invalid file type. Allowed formats: WAV, MP3, FLAC, MP4, OGG, AIFF"
}

تعذر تحويل الصوت​

يُعاد هذا الخطأ إذا كان امتداد الملف مدعومًا لكن تعذر على ffmpeg تحويله (مثل ملف تالف أو غير قابل للقراءة):

{
  "error": "Audio conversion failed: <details>"
}

تم تجاوز الحصة​

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

فشلت المعالجة​

{
  "error": "Speech emotion detection failed"
}

ملاحظات​

  • يقبل الخادم تنسيقات صوتية شائعة مثل WAV وMP3 وFLAC وMP4 وOGG وAIFF، ويحوّل الملفات غير WAV قبل التحليل.
  • استخدم الحقل file لرفع الصوت، ويجب ألا يتجاوز حجم الملف 10 MB.
  • لا يُخصم الطلب إلا بعد أن تعيد خدمة التوقع نتيجة ناجحة.