跳到主要内容

语音情绪识别 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音频中最可能检测到的情绪。
confidenceintegerpredicted_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 文件转换为 WAV。
  • 音频上传使用 file 字段，文件大小不得超过 10 MB。
  • 只有预测服务成功返回后才会扣除一次请求。