语音性别识别 API

通过一个API将语音片段转化为性别洞察。

在正文中发送音频URL或音频文件以获取性别、置信度和使用信息。专为IVR、联络中心和语音应用而构建。

V文件上传或音频URL
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
}

在JSON正文中发送url或file(base64)—不能同时发送两者。对于大型上传,请使用带有"file"字段的multipart/form-data进行POST /v1/voice-gender-recognition/api。

选择 API 版本

比较 V2 与 V3

现有 V1 端点仍支持通过 URL 或文件发送请求。V2 和 V3 使用 multipart/form-data 上传文件,并检测语音;当音频中没有足够可用语音时,会返回 “unknown”。

V2 · 整段音频分析

每次调用消耗 1 个 API 请求

V2 会先检测音频中是否有人声,然后使用 ECAPA-TDNN 语音模型对整段录音进行分类。适用于单人录音。请通过 multipart/form-data 将音频文件放入 file 字段。

为什么选择 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 时,响应还会附带说明原因的 message。

未检测到人声时返回 unknown。这是成功响应,不是 API 错误。

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 · 说话人感知分析

每次调用消耗 2 个 API 请求

V3 检测语音、识别说话人,然后对选定的一位说话人进行分类。适用于通话、访谈等多人录音。默认选择第一位说话人;若其讲话少于 2 秒,则选择讲话时间最长的人。未检测到语音,或选定说话人的有效语音少于 1 秒时,gender 返回 “unknown”。请通过 multipart/form-data 将音频文件放入 file 字段。

为什么选择 V3 而不是 V1 或 V2?与 V2 一样,V3 在没有语音时不会猜测,并使用 ECAPA-TDNN 替代 V1 的旧模型。与会将所有声音合并为一个结果的 V2 不同,V3 通过说话人分离先提取一位说话人的音频,再进行分类,从而减少其他说话人的干扰。V3 耗时更长,并会对含语音的录音调用付费的 Deepgram 服务。

端点

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

成功响应中的 gender 为 male、female 或 unknown,confidence 为百分比,另含 remainingRequests。gender 为 unknown 时,响应还会附带说明原因的 message。

未检测到语音,或选定说话人的语音少于 1 秒时返回 unknown。这是成功响应,不是 API 错误。

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
}

原生语音丰富

放入语音片段,用性别信号、置信度和剩余使用量丰富记录。

灵活摄取

在正文中发送URL或内联文件,并在需要时使用multipart/form-data上传。

审核与信任

在自动队列中标记声明和检测到的性别之间的异常或不匹配。

为规模而构建

通过弹性处理和透明的使用限制优雅地处理峰值。

清晰的JSON响应

简单字段:gender、confidence、remainingRequests、success。

格式覆盖

支持常见的编解码器和容器,从wav和mp3到ogg、m4a等。

工作原理

三步语音性别识别。

1

提供音频

使用url字段或file字段(base64)POST到/api;文件上传也支持multipart/form-data。

2

获取JSON响应

在几秒钟内接收gender、confidence和remainingRequests。

3

准备就绪时扩展

使用相同的响应自动化批处理作业或内联IVR流的摄取。

cURL

正文中的URL或file
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提示以丰富路由和分析。

语音引导的入职

从录制的提示中检测性别,以实时定制体验。

审核

自动检查用户提交的音频以用于信任和安全工作流程。

准备开始?

我们使用先进的人工智能技术提供最佳的性别识别服务,确保所有用户的准确性和隐私

在几分钟内创建账户以获取API密钥和无限访问权限

创建账户

每日免费使用

每天享受慷慨的免费额度,用于测试和探索我们的API

试用API

定价

简单透明的定价。前300次请求免费,然后按使用量付费。详情请查看定价页面

查看定价

常见问题

订阅

订阅我们的新闻简讯以获取最新功能更新

通过订阅,您同意我们的隐私政策,并同意接收有关最新功能的信息